# Agents API

> Run and optimize agents on Sudoiq with Python, CLI, and optional self-hosting

## Docs

- [Running agents](https://docs.sudoiq.com/agents/running-agents.md): Default streaming runs and optional webhook delivery for long jobs
- [Async runs and tool calls](https://docs.sudoiq.com/agents/sse-and-local-tools.md): Wait for completion over a streaming connection and run Python tool handlers in-process
- [Timeouts and errors](https://docs.sudoiq.com/agents/timeouts-and-errors.md): Response timeouts for streaming runs and idempotent tool response errors
- [Webhooks for long-duration agents](https://docs.sudoiq.com/agents/webhooks.md): Start a run once and handle run status payloads pushed to your HTTPS endpoint
- [Self-hosted Docker](https://docs.sudoiq.com/backend/docker.md): Optional on-prem or VPC deployment
- [CLI (agentservice)](https://docs.sudoiq.com/clients/cli.md): agentservice command-line tool for agents, execute, tools, validators, and task status
- [Node.js client](https://docs.sudoiq.com/clients/nodejs.md): JavaScript and TypeScript SDK roadmap for the Agents API
- [Python client](https://docs.sudoiq.com/clients/python.md): Install agentserviceapi, AgentServiceAPIClient API reference, tools, tests, and feedback
- [Evals, tests, and feedback](https://docs.sudoiq.com/concepts/evals-tests-and-feedback.md): Test examples, execution feedback, and improving agent workflows
- [How runs work](https://docs.sudoiq.com/concepts/how-runs-work.md): task id, run states, tool pauses, and how clients wait for completion
- [What is an agent?](https://docs.sudoiq.com/concepts/what-is-an-agent.md): Workflow graphs, versions, tools, and how you refer to an agent in API calls
- [Agents API Introduction](https://docs.sudoiq.com/introduction.md): Run and optimize agent workflows with the Agents API on sudoiq
- [Getting started](https://docs.sudoiq.com/quickstart/getting-started.md): Install the client, set your API key, and run an agent
- [Environment variables](https://docs.sudoiq.com/reference/environment.md): Configuration for Python apps, the agentservice CLI, demos, and local Docker stacks
- [Tools overview](https://docs.sudoiq.com/tools/overview.md): Server tool registry versus app-defined tools (Python and CLI)
- [Register server tools](https://docs.sudoiq.com/tools/register-server-tools.md): End-to-end guide for registering tool schemas and handling tool calls
- [PDF demo app](https://docs.sudoiq.com/tutorials/pdf-demo-app.md): FastAPI companion demo with streaming runs, parse_pdf, and local extraction
- [Output validators](https://docs.sudoiq.com/validation/output-validators.md): JSON Schema validators for agent node outputs

## OpenAPI Specs

- [openapi](https://docs.sudoiq.com/api-reference/openapi.json)