Claude Managed Agents Integration¶

Pisama integrates with Claude Managed Agents to monitor agent sessions and detect failure modes in Anthropic-hosted agent systems.

How the integration works¶

Managed Agents runs on Anthropic's infrastructure and does not push webhooks to external systems. Pisama connects to the Anthropic API to pull session events via the /sync endpoint, then runs its detection pipeline.

Primary path (recommended): Register your Anthropic API connection, then call POST /sync to pull sessions and run detection.

Secondary path: Build your own bridge that streams from Anthropic's SSE endpoint and posts pre-processed session data to Pisama's /webhook endpoint.

Setup¶

1. Get a Bearer Token¶

curl -X POST https://api.pisama.ai/api/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{"api_key": "pisama_your_api_key_here"}'

export TOKEN="<access_token>"

2. Register a Connection¶

curl -X POST https://api.pisama.ai/api/v1/managed-agents/connections \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "production",
    "api_key": "<your_anthropic_api_key>",
    "organization_id": "<your_anthropic_org_id>"
  }'

3. Register Agents¶

Register each agent you want to monitor. The mcp_servers and allowed_hosts fields enable platform-specific detection.

curl -X POST https://api.pisama.ai/api/v1/managed-agents/agents \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "connection_id": "<connection_id>",
    "agent_id": "<anthropic_agent_id>",
    "agent_name": "My Research Agent",
    "mcp_servers": ["linear", "github"],
    "allowed_hosts": ["api.github.com", "*.linear.app"]
  }'

4. Sync Sessions (Pull Model)¶

Pull recent sessions from the Anthropic API. This fetches session events, creates Pisama traces, and runs detection.

curl -X POST https://api.pisama.ai/api/v1/managed-agents/sync \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "connection_id": "<connection_id>",
    "limit": 20
  }'

Set up a cron job to sync periodically:

*/15 * * * * curl -sS -X POST https://api.pisama.ai/api/v1/managed-agents/sync \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"connection_id": "<id>", "limit": 20}' >> /tmp/pisama-sync.log 2>&1

5. Discover Agents¶

List all agents from the Anthropic API for registration:

curl -X POST https://api.pisama.ai/api/v1/managed-agents/discover \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"connection_id": "<connection_id>"}'

Event Model¶

Pisama understands the real Managed Agents event types:

Detection Capabilities¶

Managed Agents-Specific Detectors¶

Core Detectors (Also Applied)¶

All 20 core detectors run on Managed Agents session content, including loop detection, hallucination, persona drift, coordination failures, and more.

OTEL Integration¶

If sessions emit OpenTelemetry spans, Pisama auto-detects them:

API Endpoints¶

Beta Notes¶

Claude Managed Agents is in public beta (managed-agents-2026-04-01). Multi-agent threads are in research preview. Pisama pins the beta version and gracefully handles unknown event types.