백엔드가 메모리 쓰기 및 읽기를 명시적으로 제어하는 경우 REST API를 사용하세요. 두 작업 모두 프로젝트의sk- 클라이언트 키로 인증됩니다.
#캡처
curl -X POST https://api.agihalo.com/api/v1/memory/capture \
-H "Authorization: Bearer $HALO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"projectKey": "customer-product",
"endUserKey": "user_123",
"sessionData": {
"messages": [
{
"role": "user",
"content": "Keep my weekly reports short and send them in the morning."
}
]
},
"response": {
"role": "assistant",
"content": "I will keep them concise and morning-ready."
}
}'Capture는 메모리 작업자를 위한 원시 교환, 쓰기 사용량 계정, 대기열 주제 분류 및 요약 작업을 저장합니다.
#직접 검색
curl -X POST https://api.agihalo.com/api/v1/memory/retrieve \
-H "Authorization: Bearer $HALO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"projectKey": "customer-product",
"endUserKey": "user_123",
"topics": ["report_preferences"],
"limit": 5,
"includeRaw": true,
"includeDisabledTopics": false
}'| 필드 | 목적 |
|---|---|
topics | 명시적인 주제 키로 제한 |
limit | 반환된 원시 레코드를 바인딩합니다. |
includeRaw | 링크된 소스 교환 포함 |
includeDisabledTopics | 일반적인 검색이 비활성화된 주제 포함 |
#엔드포인트 요약
POST
/api/v1/memory/capturePOST
/api/v1/memory/retrievePOST
/api/v1/memory/functions/halo_retrieve_end_user_memoryPOST
/api/v1/memory/delete