Documentation
Agentspan is a durable runtime for AI agents. Your code runs in your process. Execution state lives on the server.
Agentspan is a durable runtime for AI agents. Execution state lives server-side, so crashes, restarts, and deployments do not lose work. Write agents natively or wrap an existing LangGraph, OpenAI Agents SDK, or Google ADK agent in one line.
Getting Started
- Why Agentspan - Why agents fail in production, and how Agentspan solves it.
- Quickstart - Build your first agent in 5 minutes.
Concepts
- Agents - The
Agentclass, parameters, results, and handles. - Tools -
@tool,http_tool(),api_tool(),mcp_tool(), credentials, and approval-required tools. - Multi-Agent Strategies - Sequential, parallel, handoff, router, and nested agent coordination.
- Guardrails - Input and output safety, retry, block, and fix behavior.
- Memory - Conversation history and semantic search across sessions.
- Streaming - Runtime events, async execution, and HITL with streams.
- Testing -
mock_run,expect, record/replay, pytest, and evaluation helpers.
Deployment
- Deployment overview - Local development, Docker, Helm, and Orkes Cloud.
- Self-hosting - Run Agentspan in your own environment.
Examples
- Support Ticket Triage - Classify, route, and resolve support tickets.
- Research Pipeline - Run sequential research, writing, and editing agents.
- Batch Document Processor - Process multiple documents in parallel.
- Crash and Resume - Resume durable executions after worker failure.
- Human in the Loop - Pause execution for human approval.
- LangGraph Code Review Bot - Wrap an existing LangGraph app.
- OpenAI Agents SDK Customer Support - Run an OpenAI Agents SDK app through Agentspan.
- Google ADK Research Assistant - Run a Google ADK agent through Agentspan.
Reference
- CLI Reference - Commands with exact syntax.
- LLM Providers - Providers, model strings, and API keys.
- AI Models - Model configuration and supported provider formats.
- Integrations - Framework integrations and compatibility notes.
- Worker Types - Python and TypeScript worker models.