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.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.
The stable (
20230101) API reference does not include AI agents. Use the beta or alpha API reference for /ai/agents/... concepts and endpoint documentation.How agents relate to Cognite AI
Cognite AI groups AI features in CDF. Use AI agents when you integrate with/ai/agents/... and agent lifecycle APIs. Use 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