@arizeai/openinference-instrumentation-claude-agent-sdk

中文文档
0.3.6发布于 2026/10/30Apache-2.0TypeScriptESM + CJS构建来源已验证近 30 天下载 17.5万

Claude Agent SDK 的开源仪器

中文使用文档
文档目录11 节
  1. 安装
  2. 使用量
  3. 自动装置(CommonJS)
  4. 人工仪器(ESM)
  5. 带有微量配置( 任务敏感数据)
  6. 装有仪器的API
  7. V1号: query()
  8. V2(不稳定): unstable_v2_prompt() , (中文(简体) ), unstable_v2_crea…
  9. 扩展属性
  10. AGENT 间距
  11. TOOL 跨度

Claude Agent SDK 的 OpenInformation 仪器

以 OpenTelemeth 为基础的仪器 克劳德探员SDK (单位:千美元)@anthropic-ai/claude-agent-sdk) (中文(简体) ). 生产 高级 财务报告和审定财务报表 托尔 横跨以下 开源语义公约。 。 。 .

安装

npm install @arizeai/openinference-instrumentation-claude-agent-sdk

使用量

自动装置(CommonJS)

import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
import { ClaudeAgentSDKInstrumentation } from "@arizeai/openinference-instrumentation-claude-agent-sdk";

const provider = new NodeTracerProvider();
provider.register();

const instrumentation = new ClaudeAgentSDKInstrumentation();
instrumentation.setTracerProvider(provider);

人工仪器(ESM)

import * as ClaudeAgentSDK from "@anthropic-ai/claude-agent-sdk";
import { ClaudeAgentSDKInstrumentation } from "@arizeai/openinference-instrumentation-claude-agent-sdk";

const instrumentation = new ClaudeAgentSDKInstrumentation({
  tracerProvider: provider,
});
const instrumentedClaudeAgentSDK = instrumentation.manuallyInstrument(ClaudeAgentSDK);

for await (const message of instrumentedClaudeAgentSDK.query({
  prompt: "Write a haiku about telemetry.",
})) {
  console.log(message);
}

带有微量配置( 任务敏感数据)

const instrumentation = new ClaudeAgentSDKInstrumentation({
  tracerProvider: provider,
  traceConfig: {
    hideInputs: true,
    hideOutputs: true,
  },
});

装有仪器的API

V1号: query()

这个 query() 函数被包裹以生成:

  • 一个 高级 整个查询周期的间距
  • 托尔 每个工具调用( 通过钩子注射) 的孩子跨度

V2(不稳定): unstable_v2_prompt(), (中文(简体) ), unstable_v2_createSession(), (中文(简体) ), unstable_v2_resumeSession()

  • unstable_v2_prompt() 生成一个 高级 间距
  • 会话方法产生倒数 高级 间距 托尔 儿童间距

扩展属性

AGENT 间距

属性说明
openinference.span.kind"AGENT"
input.value提示文本
output.value结果文本
session.idSDK 会话标识符
llm.model_name所用型号
llm.token_count.prompt输入符数
llm.token_count.completion输出符数
llm.token_count.total总计
llm.cost.total总费用(美元)

TOOL 跨度

属性说明
openinference.span.kind"TOOL"
tool.name工具名称
tool.parameters工具输入( JSON)
input.value工具输入( JSON)
output.value工具响应( JSON)

版本与发布记录

@arizeai/openinference-instrumentation-claude-agent-sdk 共发布 29 个版本,首次发布于 2026/02/25;过去 12 个月发布了 29 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.3.6latest2026/10/309 天前
0.3.52026/10/2414 天前
0.3.42026/10/021 个月前
0.3.32026/10/021 个月前
0.3.22026/10/011 个月前
0.3.12026/09/191 个月前

关于 @arizeai/openinference-instrumentation-claude-agent-sdk 的常见问题

@arizeai/openinference-instrumentation-claude-agent-sdk 是什么?

Claude Agent SDK 的开源仪器

如何安装 @arizeai/openinference-instrumentation-claude-agent-sdk?

在项目目录运行 npm install @arizeai/openinference-instrumentation-claude-agent-sdk,或使用 pnpm add / yarn add / bun add。

@arizeai/openinference-instrumentation-claude-agent-sdk 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@arizeai/openinference-instrumentation-claude-agent-sdk 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@arizeai/openinference-instrumentation-claude-agent-sdk 可以商用吗?

@arizeai/openinference-instrumentation-claude-agent-sdk 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@arizeai/openinference-instrumentation-claude-agent-sdk 的下载量有多少?

根据 npm 官方下载统计,@arizeai/openinference-instrumentation-claude-agent-sdk 在 2026/10/07 – 2026/11/05 这 30 天内被下载 174,754 次,日均约 5,825 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@arizeai/openinference-instrumentation-claude-agent-sdk 还在维护吗?

最新版本 0.3.6 发布于 2026/10/30(9 天前);至今共发布 29 个版本,其中过去 12 个月发布了 29 个;首次发布于 2026/02/25。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。