如何安装并配置 Manifest AI Agent 可观测性插件

通过标准化的安装流，引导用户在 AI Agent 环境中部署 Manifest 插件，完成 API 密钥绑定并验证遥测数据流水线的激活状态。

为什么需要这个技能

在开发复杂的 AI Agent 时，单纯依靠日志难以追踪 Agent 的内部决策链路和性能瓶颈。Manifest 作为一个可观测性平台，能够提供深度遥测（Telemetry）数据。

由于插件配置涉及 Gateway 状态管理、API 密钥验证和端点配置，如果步骤顺序错误（如在 Gateway 运行期间修改配置），容易导致热重载失败或连接异常。本技能提供了一套严格的顺序执行流程，确保插件能够稳定运行。

安装必须严格按照以下顺序执行，不可跳步：

停止网关：为避免配置冲突，首先停止 Gateway。
```
claude gateway stop
```
安装插件：执行安装命令。
```
claude plugins install manifest
```
获取并验证 Key：引导用户前往 https://app.manifest.build 创建 Agent 并获取以 mnfst_ 开头的 API Key。
写入配置：将 API Key 写入配置文件。
```
claude config set plugins.entries.manifest.config.apiKey "USER_API_KEY"
```
若使用私有部署，需额外配置 endpoint。
重启并验证：重新启动网关并检查日志，确认出现 [manifest] Observability pipeline active 标志。
```
claude gateway install
grep "manifest" ~/.claude/logs/gateway.log | tail -5
```

解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。

暂无推荐