Agent Onboarding

When a new agent joins a team, the onboarding protocol walks it through a structured setup process: learning team norms, ingesting shared context, reviewing conversation history, and calibrating capabilities.

Onboarding steps

Step	Description
`team_norms`	Learn the team's conventions, communication style, and operating procedures
`shared_context`	Ingest workspace shared context entries relevant to the team
`history_digest`	Review recent conversation history and team activity
`capability_calibration`	Test and calibrate the agent's tool and skill capabilities

Starting onboarding

bash

# Start onboarding a new agent into a team
curl -X POST http://localhost:3000/agent-onboarding \
  -H "Authorization: Bearer ${JWT_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{ "agentId": "new-agent", "teamId": "engineering" }'

# Response (201 Created)
{
  "id": "onb_abc123",
  "workspaceId": "ws_abc123",
  "agentId": "new-agent",
  "teamId": "engineering",
  "status": "in_progress",
  "steps": [
    { "name": "team_norms", "status": "pending" },
    { "name": "shared_context", "status": "pending" },
    { "name": "history_digest", "status": "pending" },
    { "name": "capability_calibration", "status": "pending" }
  ],
  "startedAt": "2026-03-07T12:00:00.000Z"
}

Completing steps

Steps can be completed individually or skipped. When all steps are done, the process status changes to completed.

bash

# Mark a step as complete
curl -X POST http://localhost:3000/agent-onboarding/onb_abc123/steps/team_norms/complete \
  -H "Authorization: Bearer ${JWT_TOKEN}"

Endpoint reference

Method	Endpoint	Description
`POST`	`/agent-onboarding`	Start onboarding
`GET`	`/agent-onboarding`	List onboarding processes
`GET`	`/agent-onboarding/:id`	Get process status
`POST`	`/agent-onboarding/:id/steps/:step/complete`	Mark step complete