Skip to main content
An agent is the durable hosted resource clients use to start work in Dari.

​
What an agent gives you

Each agent gives you:
  • One stable agent URL
  • Many published versions behind that URL
  • One current active version for new sessions

​
Versions

Publishing creates a new version of an existing agent rather than replacing the agent itself. That means:
  • The stable agent URL does not change across publishes
  • Version history stays attached to the same agent
  • New publishes affect future sessions, not the ones already in progress

​
Sessions start from the active version

Clients create sessions from the agent’s stable URL. At session creation time, Dari resolves the current active version and pins the session to it. Later publishes do not retarget an existing session.

​
How agents fit the model

  1. Publish an agent project to create or update an agent.
  2. Dari stores a new version behind the stable agent URL.
  3. Clients create sessions from that stable URL.
  4. Each session continues on the version it started with.

​
Where publishing fits

This page describes the public agent model. The publishing workflow lives in Agents and Versions, Manifest Reference, and CI Publishing.