Memory Atoms

Atom은 MaaS에 저장되는 durable memory 단위입니다.

Atom에 들어가는 값

• anchor_id
• content
• source_type
• metadata
• confidence (선택)

Atom 저장 예시

curl -X POST https://maas.nunchiai.com/v1/atoms \
  -H "Authorization: Bearer mk_maas_example" \
  -H "X-Workspace-Id: acme-prod" \
  -H 'Content-Type: application/json' \
  -d '{
    "anchor_id": "be2d5afd-8ec2-44d1-bfb3-e1eb4cb2c9b1",
    "content": "Learner still confuses TCP and UDP.",
    "source_type": "prd",
    "metadata": {
      "atom_type": "misconception",
      "user_external_id": "learner-17",
      "confidence": 0.82
    },
    "chunking": { "enabled": false }
  }'

{
  "atom_ids": ["88f1b2ff-61d1-4675-ae74-634c78e8aa61"],
  "stored_count": 1,
  "service_source": "enterprise-tutor"
}

저장 규칙

• 인사, filler는 저장하지 않습니다.
• content는 사람이 읽을 수 있어야 합니다.
• taxonomy는 metadata.atom_type에 둡니다.
• durable fact는 source_type=prd
• 최근 대화 관찰은 source_type=chat-log

예시 atom_type

• preference
• emotional_state
• relationship_event
• backstory_reveal
• promise
• boundary

오류

• 400
• 403
• 404
• 429