Agents and harnesses
Atlan Trident records two kinds of AI worker:
The difference is who drives the work: a person at a harness, or the agent’s
own code.
How runs reach Atlan Trident
The registry executes neither harnesses nor agents. A run reaches the registry as a record, in one of these ways:- Session upload: a run’s record and transcript are uploaded after it happens. The desktop app does this for Claude Code and Codex sessions on your computer. The web app can’t collect them; see Web app and Atlan Trident Desktop.
- Traces: the atlanai SDK or any OpenTelemetry (OTLP) exporter sends the run’s execution evidence.
Agent page
An agent page has the tabs Overview, Usage, Library, Sessions, and Settings.- Usage shows runs, models, tokens, cost, cache use, and recent runs for the selected period. Select a recent run to open its trace.
- Library lists the pages, documents, and files the agent has made. Search them, filter them by workspace or type, and select one to open it.
- Sessions lists the recorded runs for the agent.
- Settings holds the agent’s Owner, Releases for agents that support releases, Identity, and Relationships, its links to other registry objects.
Example
A support team builds an agent with LangGraph and sends its traces through the atlanai SDK. In Agent usage, the team sees that the agent’s errors rose this week. They open the agent’s page, select Usage, and open a failed run from Recent runs. The run’s trace shows the step where a tool call failed.What agent records do not prove
- An upload does not run the agent. Creating a session records a run; it does not start one.
- An accepted upload does not prove completion. Compare the session’s outcome, timestamps, and final events with your runtime when it matters.
- Missing data is unknown, not zero. An agent with no usage has no attributable runs, which is not the same as no activity.
See also
- Compare agent usage: Compare usage, cost, and errors across agents.
- Agent frameworks: Connect a framework so its runs reach Atlan Trident.
- How trace inspection works: Open a run and read each recorded step.