retrieval_id는 기록된 결과 목록 제시를, session_id는 일지를 식별합니다. 같은 기억이 병렬 질문에 나오면 각 retrieval_id를 해당 목록과 함께 보관하세요. null이면 그 응답은 정확히 연결할 수 없습니다. 영수증, 기억, 호출자 접근 조건이 유지되면 옛 검색이나 닫힌 세션에도 명시적인 피드백을 보낼 수 있습니다. 원본 일지를 다시 열지 마세요.
실제 사용 한 건은 engram_report_outcome에 memory_id, success, retrieval_id를 줍니다. 최대 20개 고유 검색/기억 쌍에는 outcomes를 사용하세요. 다음 start, recall, smarter, store, reflect, cross_pollinate, get_context, skill, report_outcome의 pending_feedback으로 붙여도 됩니다. outcome:write가 필요하지만 호출 한도를 추가로 쓰지는 않습니다. 평가할 수 없는 결과는 판단을 지어내지 말고 빼세요.
정확한 사용 보고를 반복할 때 같은 retrieval_id, memory_id, 사용 필드를 보내세요. Engram은 응답에 duplicate=true를 반환하며 새 평가 기록을 더하지 않습니다. duplicate는 입력이 아니며 retry 플래그도 없습니다. 같은 재전송은 409가 아니고 이미 저장한 평가 기록을 바꾸려 할 때만 409입니다. retrieval_id 없는 구형 형식은 같은 인증 멤버와 작업 공간에서 최근 24시간 동안 그 기억이 포함된 가장 최근 제시를 고릅니다. session_id가 있으면 해당 일지로 제한합니다. 구형 재전송은 평가 기록을 더할 수 있으므로 추정 연결을 정확한 연결로 보지 마세요. 정말 새로운 사용에는 새로운 검색 제시가 필요합니다.
피드백 묶음은 주 작업보다 먼저 확정됩니다. 주 작업이 실패해도 feedback_receipt를 확인하세요. 피드백은 이미 저장됐을 수 있습니다. 원격 MCP와 npm 클라이언트는 오류에서도 확인 영수증을 보존합니다. 피드백 확정 뒤 오류는 자동 재시도하지 않지만 주 작업 자체는 멱등하지 않을 수 있습니다. reflect.used_memories에서 정확한 원자적 묶음은 최대 20개 전부에 retrieval_id를 넣고 구형 항목은 다른 reflect로 분리하세요. 뒤의 학습이나 체크포인트가 실패해도 feedback_receipt에 수락된 결과가 나옵니다.
예시: 자리표시자를 실제로 반환된 값으로 바꾸세요.
{
"repo": "example",
"query": "Which deployment rule applies?",
"pending_feedback": [
{
"retrieval_id": "<id from the previous result list>",
"memory_id": "<memory in that list>",
"relevance": "irrelevant",
"usefulness": "not_used"
}
]
}
권장: 검색에 정확히 연결된 사용 결과(engram_reflect 인수)
{
"store": false,
"summary": "Applied the recalled approval rule.",
"used_memories": [
{
"retrieval_id": "<id from that result list>",
"memory_id": "<memory in that list>",
"success": true,
"detail": "Checked owner approval before releasing."
}
]
}
호환성 전용: 구형 결과는 별도 회고로 전송(engram_reflect 인수)
{
"store": false,
"summary": "Reported a use without a retained query receipt.",
"used_memories": [
{
"memory_id": "<accessible memory id>",
"success": true,
"detail": "This use has inferred attribution, not an exact query link."
}
]
}