Agent SDK Integrations

Integration overview

Beacon Observe traces supported LLM providers, agent SDKs, and orchestration code through OpenTelemetry. Initialize Observe, configure the integration path for the SDK you use, and your model calls or agent turns can flow to Beacon Managed hosted Observe or a customer-managed OTLP collector. Browse the integrations below to see setup instructions, what is captured, and troubleshooting guidance.

Anthropic

Instrument @anthropic-ai/sdk model calls with Beacon Observe.

Claude Agent SDK

Wrap Claude Agent SDK query functions with Beacon-compatible prompt spans.

OpenAI

Instrument openai package model calls with Beacon Observe.

Vercel AI SDK

Pass Observe.getTracer() into AI SDK telemetry for model calls and tool loops.

Custom Agent Steps

Use Observe.observe() for orchestration, tools, policy checks, and handoffs.

Next.js And Serverless

Initialize once in Node-only entrypoints and flush traces before short-lived runtimes exit.

Shared setup

All integration paths start by installing and initializing the SDK: Hosted Observe export requires a Beacon Managed API key. To get ASYMPTOTE_API_KEY, reach out for a demo.

Install the SDK

npm install @asymptote/sdk

Shared SDK initialization

import { Observe } from "@asymptote/sdk";

Observe.initialize({
  apiKey: process.env.ASYMPTOTE_API_KEY,
});

See the SDK quickstart for Beacon Managed hosted Observe, customer-managed OTLP, custom exporter, and shutdown options.

Not supported yet

OpenAI agent-framework tracing is not documented here because the current agent-beacon TypeScript SDK does not ship that adapter yet.

​Integration overview