Feedback Loop

Feedback tells MaaS which recalled memory actually mattered.

When to send feedback

Send positive feedback only if:

• recall returned one or more atoms
• the final response actually used recalled memory
• you can name the used_memory_atom_ids

Do not send feedback for filler generations or fallback responses that ignored memory.

Send feedback

curl -X POST https://maas.nunchiai.com/v1/feedback \
  -H "Authorization: Bearer mk_maas_example" \
  -H "X-Workspace-Id: acme-prod" \
  -H 'Content-Type: application/json' \
  -d '{
    "session_id": "0897cb2f-ecf6-45ff-a84c-3dbf560bb0c2",
    "success": true,
    "used_memory_atom_ids": [
      "3fdb5de0-8862-4f61-b7e1-2aaf0f4c1f09"
    ]
  }'

{
  "ok": true
}

Minimal evaluator contract

Your app should decide:

• whether memory was used
• which atoms were used
• whether the final answer was high-confidence enough to reinforce

Errors

• 400 invalid session id, invalid key, or invalid atom id list
• 403 access policy denied
• 404 recall session not found
• 429 rate limited