AI SDK

Send traces from a Vercel AI SDK agent to Astropods so its model calls, tool calls, and latency appear in the dashboard. You can optionally serve the agent over Astropods messaging to use it in the Astropods playground.

@astropods/adapter-ai-sdk exports two functions you can use independently:

• astroTelemetry() returns AI SDK experimental_telemetry settings wired to the Astropods OTLP exporter.
• serve() connects an Experimental_Agent to the Astropods messaging service so your agent works in the Astropods playground.

Targets ai >= 6.0.0.

Before you start

• A deployable Astropods agent project.
• Astropods sets OTEL_EXPORTER_OTLP_ENDPOINT only on deployed containers, so traces appear once the agent runs on the platform — not during local development.

Install

bun add @astropods/adapter-ai-sdk

Send telemetry to Astropods

Add astroTelemetry() into the agent’s experimental_telemetry:

import { Experimental_Agent as Agent } from "ai";
import { openai } from "@ai-sdk/openai";
import { astroTelemetry } from "@astropods/adapter-ai-sdk";
const agent = new Agent({
  model: openai("gpt-4o"),
  instructions: "You are a helpful assistant.",
  experimental_telemetry: astroTelemetry(),
});

Traces capture each turn’s model calls, tool calls, and latency, attributed to the deployed agent. Use this on its own when you serve the agent from your own framework and want AI traces reported in the dashboard.

Serve over Astropods messaging

To run the agent on Astropods messaging, pass it to serve():

import { Experimental_Agent as Agent } from "ai";
import { openai } from "@ai-sdk/openai";
import { serve, astroTelemetry } from "@astropods/adapter-ai-sdk";
const instructions = "You are a helpful assistant.";
const agent = new Agent({
  model: openai("gpt-4o"),
  instructions,
  experimental_telemetry: astroTelemetry(),
});
serve(agent, { name: "My Agent", instructions });

Verify

Deploy the agent, send it a message, then open the agent’s detail page in the dashboard. Traces appear within ~30 seconds.

If nothing shows up:

• Confirm experimental_telemetry: astroTelemetry() is on the agent.
• Confirm OTEL_EXPORTER_OTLP_ENDPOINT is set in the deployed container.
• Check the container logs for OpenTelemetry export errors.