@ raintrust/ trace- opencode (中文(简体) )
追踪 打开代码 在Braintust的讲座。 插件发送
当地的活动 bt 守护进程, 它构建并上传痕迹 。 打开代码保存
如果追踪失败, 则运行 .
- 会期: 带有元数据( 工作空间、 主机名等) 的 OpenCode 会话根跨度
- 转弯跨度: 抓取每个用户辅助互动
- LLM 跨度: 记录已完成的附有可用投入、产出和使用情况的示范信息
- 工具间距: 记录有投入和产出的单个工具处决
快速启动
安装 OpenCode 并安装 大脑信任CLI,然后运行 :
bt login
bt trace enable opencode --project my-coding-agent
opencode
此注册 npm 插件并保存其配置 。 使用 --profile 或者说
--org 选择一个简介或组织。 如果已打开, 则重新启动 OpenCode .
在不改变全球追踪配置的情况下
bt trace run --project my-coding-agent opencode -- run "summarize this repository"
对 OpenCode 不支持历史导入和活附件 .
兼容性
软件包声明 @opencode-ai/plugin 财务报告和审定财务报表 @opencode-ai/sdk 同行人数
>=1.2.25. CI 检查包的安装在最低水平和 latest, (中文(简体) ),
并使用最新的 OpenCode CLI 运行真实代理集成测试.
配置
从这些文件中设置负载, 以工程设置压倒全局设置 :
- 全球:
$XDG_CONFIG_HOME/opencode/braintrust.json,或~/.config/opencode/braintrust.json若为XDG_CONFIG_HOME未设置 - 项目:
.opencode/braintrust.json
bt trace run 覆盖一次引用的跟踪设置。 合并文件
顶级:一个项目 route 替换全局 route。 。 。 .
{
"trace_to_braintrust": true,
"enable_tools": true,
"route": {
"auth": { "profile": "work", "org_name": "acme" },
"destination": { "type": "project_logs", "project_name": "my-project" }
},
"debug": true
}
设置
| 配置密钥 | 默认 | 目的 |
|---|---|---|
trace_to_braintrust | false | 启用跟踪 |
enable_tools | true | 注册大脑信任工具; 覆盖到 BRAINTRUST_OPENCODE_ENABLE_TOOLS |
route.auth.profile_id | 未设定 | 保存的配置文件 ID bt 设置 |
route.auth.profile | 当前 bt 配置文件 | 按名称选择配置文件 |
route.auth.org_name | 配置默认 | 选择一个组织 |
route.destination | 项目日志 opencode | 选择跟踪目的地 |
route.additional_metadata | 未设定 | 添加 root- span 元数据 |
route.flush_mode | fire_and_forget 默认路径 | 控制交货冲洗 |
debug | false | 启用调试日志; 覆盖方式 BRAINTRUST_DEBUG |
旧文件仍然可以使用顶级 profile, (中文(简体) ), org_name, (中文(简体) ), project,以及
additional_metadata。对于新文件,使用 bt trace enable 或被窝
route 上方的格式。 提供路由时包含目的地 .
仅 enable_tools 财务报告和审定财务报表 debug 直接读取环境变量。 追踪
设置来自这些文件或 bt trace run。 。 。 .
禁用大脑信任工具
设定 enable_tools 改为 false 追踪OpenCode会话,而不注册Braintust品牌工具(braintrust_query_logs, (中文(简体) ), braintrust_list_projects, (中文(简体) ), braintrust_log_data, (中文(简体) ), braintrust_get_experiments:
{
"trace_to_braintrust": true,
"enable_tools": false,
"route": {
"destination": { "type": "project_logs", "project_name": "my-project" }
}
}
或使用环境变量:
BRAINTRUST_OPENCODE_ENABLE_TOOLS=false opencode
添加根元数据
设定 route.additional_metadata 将字段添加到根宽:
在不改变持久性配置的情况下引用一次,使用
bt trace run --additional-metadata '{"ci": true, "run_id": "abc-123"}' opencode -- run "do the thing", (中文(简体) ),
或设置 BRAINTRUST_ADDITIONAL_METADATA 在该命令之前( 3)bt trace run
仍然接受它; 一个平地 opencode 会话插件没有).
您也可以通过配置文件设置 :
{
"route": {
"destination": { "type": "project_logs", "project_name": "my-project" },
"additional_metadata": { "team": "platform" }
}
}
值必须是 JSON 对象 。 如果密钥冲突, 内建会话元数据将获胜 .
跟踪结构
守护进程重建会话、转弯、模式信息以及工具执行:
Session (task)
├── Turn 1 (task)
│ ├── Model response (llm)
│ ├── Tool execution (tool)
│ └── Model response (llm)
└── Turn 2 (task)
当OpenCode提供时,模型使用和元数据也包括在内. 儿童 当关系是时,课程会附在父母的主动回合上 可供翻译者使用.
管理追踪
bt trace doctor opencode
bt trace status
bt trace update opencode
bt trace disable opencode
运行时架构
追踪向本地守护进程发送事件, 四个选择
大脑信任工具呼叫 bt 命令。 双用 bt 证书和API访问.
发展
从单列波根运行 make validate-opencode 用于构建、检查和测试
包裹。 见
捐款指南
发展指示。 npm 软件包包含编译的切入点;
源变化属于单列波.