> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/observability/atif/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/nemo/relay/_mcp/server.

# Module atif

> Agent Trajectory Interchange Format (ATIF) exporter.

Generated from `cargo doc --no-deps -p nemo-relay -p nemo-relay-adaptive -p nemo-relay-pii-redaction -p nemo-relay-ffi -p nemo-relay-types -p nemo-relay-plugin -p nemo-relay-worker-proto -p nemo-relay-worker`.

Agent Trajectory Interchange Format (ATIF) exporter.

This module provides types and an exporter that collects lifecycle events from the NeMo Relay runtime and converts them into ATIF trajectories conforming to the ATIF v1.7 schema.

## Overview

The [`AtifExporter`](/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atifexporter) registers as an event subscriber, collects all events, and can export them as an [`AtifTrajectory`](/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atiftrajectory) via [`AtifExporter::export`](/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atifexporter).

## Event-to-Step Mapping

The core conversion from NeMo Relay events to ATIF steps follows these rules:

* NeMo Relay Event | ATIF Step | Notes
* LLM Start | `user` step | Fresh user turns only; same-turn continuations stay on the agent step
* LLM End | `agent` step | Response content, tool\_calls promoted
* Tool Start | *(skipped)* | tool\_calls come from LLM End instead
* Tool End | agent observation | Correlated by `source_call_id`
* Mark | *(skipped)* | Point-in-time telemetry is not a step
* Scope Start/End | *(skipped)* | Structural events, not trajectory

The exporter serializes the full collected event stream into a single ATIF trajectory.

## Structs

* [AtifAgentInfo](/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atifagentinfo): Information about the agent that produced the trajectory.
* [AtifAncestry](/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atifancestry): Lineage node identifying a callable within an ATIF step.
* [AtifExporter](/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atifexporter): Collects lifecycle events and exports them as ATIF trajectories.
* [AtifFinalMetrics](/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atiffinalmetrics): Aggregate statistics for the entire trajectory (ATIF final\_metrics).
* [AtifInvocationInfo](/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atifinvocationinfo): Invocation timing and correlation metadata for one execution occurrence.
* [AtifMetrics](/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atifmetrics): Token usage and cost metrics for a single step.
* [AtifObservation](/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atifobservation): Observation results from tool execution.
* [AtifObservationResult](/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atifobservationresult): A single observation result from a tool call.
* [AtifStep](/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atifstep): A single step in an ATIF trajectory.
* [AtifStepExtra](/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atifstepextra): Lineage payload serialized into ATIF `Step.extra`.
* [AtifSubagentTrajectoryRef](/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atifsubagenttrajectoryref): Reference to a delegated subagent trajectory.
* [AtifToolCall](/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atiftoolcall): A tool call made by the agent.
* [AtifTrajectory](/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atiftrajectory): A complete ATIF trajectory.

## Constants

* [ATIF\_SCHEMA\_VERSION](/reference/api/rust-library-reference/nemo-relay/observability/atif/constant-atif-schema-version): The ATIF schema version string embedded in all exported trajectories.

> Agent Trajectory Interchange Format (ATIF) exporter.

## Docs

- [Struct Atif Agent Info](https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atifagentinfo.md): Information about the agent that produced the trajectory.
- [Struct Atif Ancestry](https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atifancestry.md): Lineage node identifying a callable within an ATIF step.
- [Struct Atif Exporter](https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atifexporter.md): Collects lifecycle events and exports them as ATIF trajectories.
- [Struct Atif Final Metrics](https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atiffinalmetrics.md): Aggregate statistics for the entire trajectory (ATIF final_metrics).
- [Struct Atif Invocation Info](https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atifinvocationinfo.md): Invocation timing and correlation metadata for one execution occurrence.
- [Struct Atif Metrics](https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atifmetrics.md): Token usage and cost metrics for a single step.
- [Struct Atif Observation](https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atifobservation.md): Observation results from tool execution.
- [Struct Atif Observation Result](https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atifobservationresult.md): A single observation result from a tool call.
- [Struct Atif Step](https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atifstep.md): A single step in an ATIF trajectory.
- [Struct Atif Step Extra](https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atifstepextra.md): Lineage payload serialized into ATIF `Step.extra`.
- [Struct Atif Subagent Trajectory Ref](https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atifsubagenttrajectoryref.md): Reference to a delegated subagent trajectory.
- [Struct Atif Tool Call](https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atiftoolcall.md): A tool call made by the agent.
- [Struct Atif Trajectory](https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/observability/atif/struct-atiftrajectory.md): A complete ATIF trajectory.
- [Constant ATIF_SCHEMA_VERSION](https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/observability/atif/constant-atif-schema-version.md): The ATIF schema version string embedded in all exported trajectories.