← Back to Capabilities
🏭

Managed Agents API — Server-Side Agent Lifecycle

Persistent server-side agents with sessions and memory
P0Infrastructure
Summary
The /v1/agents API enables creating persistent agents on Anthropic's servers. Agents maintain state across multiple interactions via sessions. Each agent has configured tools, instructions, and memory. Sessions persist conversation history server-side, eliminating client-side context management.
Technical Details
Three-tier architecture: • Agent: persistent configuration (tools, instructions, model) • Session: conversation state within an agent (auto-managed history) • Turn: single request-response within a session Key advantage over raw Messages API: server manages context window, tool execution, and memory. Client only sends new user messages and receives responses. This is Anthropic's answer to OpenAI's Assistants API — but with native tool execution and no vector store dependency.
Implementation Pattern
TypeScript (conceptual)
// Managed Agents API
const agent = await anthropic.agents.create({
  model: 'claude-sonnet-4-6',
  name: 'Knowledge Compiler',
  instructions: 'Compile research sources into structured knowledge...',
  tools: [{ type: 'computer_20250124' }, { type: 'text_editor_20250124' }]
});
const session = await anthropic.agents.sessions.create(agent.id);
const turn = await anthropic.agents.turns.create(agent.id, session.id, {
  messages: [{ role: 'user', content: 'Compile CSAR doctrine...' }]
});
Architecture Insight
Managed Agents shift complexity from client to server — the same pattern as managed databases vs. self-hosted: trade control for operational simplicity.
Official / Public Basis
Managed Agents API documented at docs.anthropic.com/en/docs/agents-and-tools/managed-agents. GA launch 2026.
Governance Concerns
Server-side state means Anthropic holds conversation history. Evaluate data residency requirements. Session cleanup policies needed to prevent state bloat.
LightHope Ecosystem Mapping
m8100 Pipeline Orchestrator — persistent agents for m590 knowledge compilation, m595 game state management, m8101 AI OS session layer