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

# AgentConfig

> Reference for AgentConfig parameters.

```python theme={null}
from definable.agent import AgentConfig
```

## Parameters

| Parameter                | Type            | Default   | Description                             |
| ------------------------ | --------------- | --------- | --------------------------------------- |
| `agent_id`               | `str`           | auto UUID | Unique agent identifier.                |
| `agent_name`             | `str`           | `""`      | Display name for logs and traces.       |
| `max_iterations`         | `int`           | `10`      | Max model-call loops before stopping.   |
| `max_tokens`             | `int`           | `None`    | Token limit per run.                    |
| `stream_timeout_seconds` | `float`         | `300.0`   | Streaming timeout.                      |
| `retry_transient_errors` | `bool`          | `True`    | Auto-retry on transient errors.         |
| `max_retries`            | `int`           | `3`       | Max retry attempts.                     |
| `validate_tool_args`     | `bool`          | `True`    | Validate tool arguments against schema. |
| `session_state`          | `Dict`          | `None`    | Default session state for tools.        |
| `dependencies`           | `Dict`          | `None`    | Injected tool dependencies.             |
| `tracing`                | `Tracing`       | `None`    | Tracing configuration.                  |
| `readers`                | `ReadersConfig` | `None`    | File reader configuration.              |

## Methods

| Method                   | Returns       | Description                              |
| ------------------------ | ------------- | ---------------------------------------- |
| `with_updates(**kwargs)` | `AgentConfig` | Create modified copy (frozen dataclass). |

## ReadersConfig

| Parameter                  | Type         | Default | Description                          |
| -------------------------- | ------------ | ------- | ------------------------------------ |
| `enabled`                  | `bool`       | `True`  | Enable file reading.                 |
| `registry`                 | `BaseReader` | `None`  | Custom reader (auto-create if None). |
| `max_total_content_length` | `int`        | `None`  | Max injected content length.         |
| `context_format`           | `str`        | `"xml"` | `"xml"` or `"markdown"`.             |