> ## Documentation Index
> Fetch the complete documentation index at: https://phaseo.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# API reference

> Reference the main Python Agent SDK classes, functions, and methods.

| API                                | Purpose                              |
| ---------------------------------- | ------------------------------------ |
| `create_agent(...)`                | Define an agent                      |
| `define_tool(...)`                 | Define a local or manual tool        |
| `create_gateway_agent_client(...)` | Connect model turns to Phaseo        |
| `agent.run(...)`                   | Run to a terminal or paused state    |
| `agent.stream(...)`                | Run with replayable stream consumers |
| `agent.continue_run(...)`          | Continue saved or paused state       |
| `stream.result()`                  | Read the completed run               |
| `stream.text_stream()`             | Read text deltas                     |
| `stream.full_stream()`             | Read all events                      |
| `stream.cancel()`                  | Cancel the active run                |

Important types include `AgentTool`, `AgentToolDecision`, `AgentToolOutput`, `AgentRunResult`, `AgentStateAccessor`, `AgentModelRetryConfig`, and `AgentToolExecutionConfig`.

## Related

* [Build your first agent](./agent-sdk)
* [Observability and DevTools](./agent-sdk-observability)