Enterprise Tutor

This guide uses service_source: enterprise-tutor for learner-specific memory.

Default integration pattern

• create one anchor per learner
• track mastery, misconceptions, and struggle points as atoms
• recall memory before each teaching turn
• store what teaching style worked or failed
• use confidence values to reflect uncertainty

Create the learner anchor

curl -X POST https://maas.nunchiai.com/v1/anchors \
  -H "Authorization: Bearer mk_maas_example" \
  -H "X-Workspace-Id: tutor-prod" \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Learner 17",
    "type": "chat-log",
    "metadata": {
      "lane": "learner-17",
      "user_external_id": "learner-17"
    }
  }'

Write learning observations

curl -X POST https://maas.nunchiai.com/v1/atoms \
  -H "Authorization: Bearer mk_maas_example" \
  -H "X-Workspace-Id: tutor-prod" \
  -H 'Content-Type: application/json' \
  -d '{
    "anchor_id": "77568c95-bcb6-4c36-b9b7-d4eaaad43cd3",
    "content": "Learner understands subnet masks but still misses CIDR notation.",
    "source_type": "prd",
    "metadata": {
      "atom_type": "misconception",
      "user_external_id": "learner-17",
      "confidence": 0.78
    },
    "chunking": { "enabled": false }
  }'

Recall before teaching

curl -X POST https://maas.nunchiai.com/v1/memory/recall \
  -H "Authorization: Bearer mk_maas_example" \
  -H "X-Workspace-Id: tutor-prod" \
  -H 'Content-Type: application/json' \
  -d '{
    "user_external_id": "learner-17",
    "session_id": "lesson-2026-04-03",
    "query": "What should the tutor adapt for this learner?"
  }'

{
  "items": [
    {
      "atom_id": "9113f776-bbf3-4fd4-84f0-d7e9c19e1de2",
      "content": "Learner understands subnet masks but still misses CIDR notation.",
      "score": 0.905
    }
  ]
}

Suggested atom types

• concept_mastered
• misconception
• learning_style
• struggle_point
• goal
• follow_up

Errors

• 400 invalid key or missing workspace header
• 402 billing blocked
• 403 access policy denied
• 404 missing anchor
• 429 rate limited