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

# AI agents

> Define, list, chat with, and delete AI agents in Cognite Data Fusion using the REST API.

The **AI agents** API lets you work with **agent** resources in Cognite Data Fusion: list and retrieve agents, create or update agents, start **chat** sessions, and delete agents you no longer need. Agents support conversational and task-oriented workflows that go beyond single-shot document Q\&A.

<Info>
  The **stable** (`20230101`) API reference does not include AI agents. Use the **beta** or **alpha** API reference for `/ai/agents/...` concepts and endpoint documentation.
</Info>

## How agents relate to Cognite AI

[Cognite AI](/api-reference/concepts/20230101/cognite-ai) groups AI features in CDF. Use **AI agents** when you integrate with `/ai/agents/...` and agent lifecycle APIs. Use [Document AI](/api-reference/concepts/20230101/document-ai) when you need **ask** and **summarize** operations over documents stored in CDF (`/ai/tools/documents/...`).

## Common use cases

Agents are suited to guided conversations, multi-turn tasks, and automation that references agent configuration and chat history. Exact behavior depends on how agents are defined and exposed in your project; see the API reference for your **calendar version** for operations and request bodies.

## Key capabilities

* **List and retrieve** agents
* **Create or update** agents (add or change agent definitions)
* **Retrieve agents by external ID** for batch lookups
* **Start chat** sessions with an agent
* **Delete** agents when they are obsolete