Manifest

# Manifest 设置 使用 Manifest 插件为您的 AI 智能体设置实时可观测性。通过 OTLP 遥测监控成本、Token、消息和性能。 ## 何时使用此技能 在以下情况使用此技能： - 为 AI 智能体设置可观测性或遥测 - 将智能体连接到 Manifest 以进行成本和性能监控 - 配置 Manifest API 密钥或自定义端点 - 排查 Manifest 插件连接问题 - 验证 Manifest 可观测性管道是否正在运行 ## 设置说明 请按顺序执行以下步骤。不要跳过步骤。 ### 第 1 步 — 停止网关 首先停止网关，以避免配置期间出现热重载问题。 bash claude gateway stop ### 第 2 步 — 安装插件 bash claude plugins install manifest 如果失败，请检查 CLI 是否已安装并在 PATH 中可用。 ### 第 3 步 — 获取 API 密钥 询问用户： > 要连接您的智能体，您需要一个 Manifest API 密钥： > > 1. 前往 **https://app.manifest.build** 并创建一个账户（或登录） > 2. 点击 **"Connect Agent"** 创建一个新智能体 > 3. 复制以 `mnfst_` 开头的 API 密钥 > 4. 在此处粘贴 等待以 `mnfst_` 开头的密钥。如果密钥不匹配，请告知用户格式看起来不正确，并请他们重试。 ### 第 4 步 — 配置插件 bash claude config set plugins.entries.manifest.config.apiKey "USER_API_KEY" 将 `USER_API_KEY` 替换为用户提供的实际密钥。 如果用户有自定义端点（自托管）： bash claude config set plugins.entries.manifest.config.endpoint "USER_ENDPOINT" 如果未指定，则自动使用默认端点 (`https://app.manifest.build/api/v1/otlp`)。 ### 第 5 步 — 启动网关 bash claude gateway install ### 第 6 步 — 验证 等待 3 秒让网关完全启动，然后检查日志： bash grep "manifest" ~/.claude/logs/gateway.log | tail -5 查找： [manifest] Observability pipeline active 如果出现此信息，请告知用户设置完成。如果没有，请检查错误消息并进行排查。 ## 故障排除 | 错误 | 修复 | |-------|-----| | 缺少 apiKey | 使用正确的密钥重新运行第 4 步 | | 无效的 apiKey 格式 | 密钥必须以 `mnfst_` 开头 | | 连接被拒绝 | 端点无法访问 — 检查 URL 或询问是否为自托管 | | 重复的 OTel 注册 | 禁用冲突的内置插件：`claude plugins disable diagnostics-otel` | ## 最佳实践