开发者快速入门

AI 用量跟踪 API 与集成

从一个项目和一个事件开始。在工作流原有运行位置添加可见性。

一个项目，只读上下文。

将信号带入对话。

两种连接均可读取已接入监测的用量、自动化健康状况以及内部客户收费估算。请先创建专用的项目读取密钥。无需提供商 API 密钥。

本地 Codex 插件

下载本地插件

下载包包含 INSTALL.md。解压后运行 npm ci --prefix server 在该文件夹中操作。下方示例使用完整应用源码布局。

使用附带的 plugin/ 源码包。安装其服务器依赖，然后通过 Codex 主机支持的本地插件流程注册软件包。

npm ci --prefix plugin/server

# In your MCP host's secure environment:
TRACEWELL_URL=https://tracewell.bhsoftwareproductions.com
TRACEWELL_READ_KEY=YOUR_PROJECT_READ_KEY

该软件包在以下位置声明本地 stdio 服务器 plugin/mcp.json。设置详情见 docs/PLUGIN.md。提供源码并不表示插件已安装到你的主机中。

ChatGPT 或兼容的 MCP 主机

使用托管端点和 OAuth 身份验证添加自定义 MCP 连接。查看 Tracewell 同意页面，并在其中授权专用的项目读取密钥；不要将提供商密钥或读取密钥粘贴到聊天中。

托管 MCP 端点https://tracewell.bhsoftwareproductions.com/mcp

你的主机、账户和管理员必须支持自定义 MCP 连接。所有者必须配置托管 OAuth 源站及持久化。本页面不会验证已安装的连接。

打开官方 ChatGPT 设置指南

仅限你发送的元数据。

JavaScript SDK · Python SDK

这些工具不会发现提供商账户、聊天订阅或所有对话。如需连接其他项目，请使用单独的专用读取密钥和连接。

创建项目读取密钥

创建项目

打开工作区，选择“客户与项目”，为工作命名并设置以 USD 计的月度预算。仅在配置好身份验证和 API 后使用真实工作区模式。

打开项目 →

签发限定范围的密钥

为该项目创建接收密钥。复制仅显示一次的密钥并保存在服务器端。切勿将其放入浏览器代码，也不要将提供商凭据发送给 Tracewell。

发送用量元数据

curl https://YOUR_HOST/api/v1/usage \
  -H 'Authorization: Bearer YOUR_PROJECT_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"eventId":"unique-event-id","provider":"custom",
       "model":"my-model","costUsd":0.042}'

使用固定且唯一的 eventId 安全重试。提供 costUsd，或同时提供 inputRatePerMillion、outputRatePerMillion 和 token 数。没有明确定价时，成本仍为未知。支持任意提供商或模型名称。

上报结果

POST /api/v1/runs
{
  "eventId": "unique-run-id",
  "automationId": "YOUR_AUTOMATION_ID",
  "status": "success",
  "recordsProcessed": 12,
  "durationMs": 3400
}

请先创建自动化。预期间隔结束五分钟后会评估缺失的运行。失败或不足的结果会生成应用内提醒。提醒用于告知，不会停止上游工作负载。

将上下文带入 Codex

使用上方框中的连接快速入门，设置本地 Codex 插件或托管 OAuth MCP 端点。两者均通过专用的项目读取权限提供项目摘要、用量、自动化结果及内部客户收费估算。主机设置和授权都需明确执行。

它仅读取你已接入监测的事件，不会发现聊天订阅、检查每次 Codex 或 ChatGPT 对话，或从账户账单推断成本。要计量 API 调用，请通过接收端点发送其元数据。提供商密钥应与 Tracewell 密钥分开保管。

创建项目只读密钥 →

保持载荷精简

仅接受文档列出的元数据字段。提示词、模型回复、提供商密钥和任意其他字段均被拒绝。JSON 请求限为 16 KB。事件 ID 的范围按项目和事件类型划分。