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

# kolena_agents

## `Client`

```python theme={null}
Client(
    api_key: Optional[str] = None,
    host: Optional[str] = None,
    timeout: TimeoutInput = NOT_GIVEN,
) -> None
```

Main client class for interacting with the Kolena Agents API.

Initialize the Kolena Agents client.

**Parameters:**

| Name | Type | Description | Default |
| - | - | - | - |
| `api_key` | `Optional[str]` | Optional API key. If not provided, will attempt to load from environment. | `None` |
| `host` | `Optional[str]` | Optional API host. If not provided, will use default host. | `None` |
| `timeout` | `TimeoutInput` | How long to wait for each network operation, in seconds (default `600`). Applies per operation, not per request, so a large upload that is still making progress does not time out. Pass `None` to wait indefinitely. `agent_run.add_wait` never times out before its server-side poll window, even if this is set shorter. | `NOT_GIVEN` |

### `access_logs`

```python theme={null}
access_logs: AccessLogs
```

### `agent`

```python theme={null}
agent: Agent
```

### `agent_run`

```python theme={null}
agent_run: AgentRun
```

### `api_key`

```python theme={null}
api_key: ApiKey
```

### `ground_truth`

```python theme={null}
ground_truth: GroundTruth
```

### `usage`

```python theme={null}
usage: Usage
```

### `validation`

```python theme={null}
validation: Validation
```

### `workspace`

```python theme={null}
workspace: Workspace
```

### `with_options`

```python theme={null}
with_options(*, timeout: TimeoutInput = NOT_GIVEN) -> Client
```

Return a copy of this client with different options.

**Parameters:**

| Name | Type | Description | Default |
| - | - | - | - |
| `timeout` | `TimeoutInput` | See `__init__`. Omit to inherit the current value. | `NOT_GIVEN` |

## `enable_verbose_stdout_logging`

```python theme={null}
enable_verbose_stdout_logging() -> None
```

Enables verbose logging to stdout. This is useful for debugging.

## `NOT_GIVEN`

```python theme={null}
NOT_GIVEN = NotGiven()
```

## `NotGiven`

Sentinel type distinguishing "use the default" from an explicit `None`.
It is falsy, so `if not <parameter>` treats it like any other unset value.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.