retrieval_id は記録された結果一覧の提示を、session_id は日誌を識別します。同じ記憶が並行検索に出る場合も、retrieval_id を対応する一覧と保持してください。null なら、その応答には正確な紐づけがありません。受領記録、記憶、呼び出し元へのアクセスが保たれていれば、古い検索や終了済み履歴にも明示的なフィードバックを送れます。元のセッションは再開しません。
実際の利用 1 件には 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."
}
]
}