> ## 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.types.agent

## `Agent`

Agent

### `id`

```python theme={null}
id: StrictInt
```

The ID of this Agent.

### `workspace_id`

```python theme={null}
workspace_id: StrictInt
```

The ID of the workspace hosting this Agent.

### `name`

```python theme={null}
name: StrictStr
```

The name of this Agent.

### `objective`

```python theme={null}
objective: StrictStr
```

A short description of this Agent's objective, e.g. "Extract key information from leases and addendum documents".

### `created`

```python theme={null}
created: datetime
```

When this Agent was created, formatted as an ISO 8601 timestamp (e.g. `2025-12-31T10:15:45+00:00`)

### `updated`

```python theme={null}
updated: datetime
```

When this Agent was last updated, formatted as an ISO 8601 timestamp (e.g. `2025-12-31T10:15:45+00:00`)

### `created_by`

```python theme={null}
created_by: StrictStr
```

The email address of the user who created this Agent.

### `agent_guidelines`

```python theme={null}
agent_guidelines: Optional[AgentGuidelines]
```

### `n_runs`

```python theme={null}
n_runs: StrictInt
```

The number of times this Agent has been Run.

### `prompts`

```python theme={null}
prompts: List[Prompt]
```

The Prompts configured for this Agent.

### `output_templates`

```python theme={null}
output_templates: Optional[List[OutputTemplate]] = None
```

The Templates configured for this Agent, used to generate formatted output documents.

### `metadata`

```python theme={null}
metadata: Optional[Dict[str, Any]] = None
```

Metadata for this Agent.

## `ListAgentsResponse`

ListAgentsResponse

### `agents`

```python theme={null}
agents: List[Agent]
```

The page of fetched Agents.

### `total_pages`

```python theme={null}
total_pages: StrictInt
```

The total number of pages of Agents. Use the request arguments `page_number` and `page_size` to control which Agents are fetched.

### `page_number`

```python theme={null}
page_number: StrictInt
```

The number of the fetched page.

### `page_size`

```python theme={null}
page_size: StrictInt
```

The page size, i.e. number of Agents, fetched.

## `CopyAgentRequest`

CopyAgentRequest

### `name`

```python theme={null}
name: StrictStr
```

Name of the agent to be created by copying the source agent.

### `target_workspace_id`

```python theme={null}
target_workspace_id: Optional[StrictInt] = None
```

### `target_folder_id`

```python theme={null}
target_folder_id: Optional[StrictInt] = None
```

## `UpdateAgentRequest`

UpdateAgentRequest

### `metadata`

```python theme={null}
metadata: Optional[Dict[str, Any]] = None
```

## `ListWorkspacesResponse`

ListWorkspacesResponse

### `workspaces`

```python theme={null}
workspaces: List[WorkspaceInfo]
```

List of accessible workspaces. Callers with organization-scoped View Usage, Manage Usage, or View Access Logs permissions receive all workspaces in the organization.


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