Skip to main content
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.
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
Last modified on April 23, 2026