用途
Manifest 用于为智能体安装和配置可观测性插件,主要面向遥测(telemetry)设置、API 密钥配置以及插件故障排查等场景。当用户明确请求配置 Manifest 遥测或网关集成,或需要诊断缺失的已授权遥测数据时,可使用本指引。
可用性说明
本 AAS 树捆绑的是说明文档,而非插件、CLI 或网关。实际的主机、已安装版本以及当前受支持的 Manifest 集成方式,需要从官方文档中确认。早期副本中出现的 claude gateway / claude plugins 命令并非经过验证的 Claude Code 配置契约,不应运行这些命令,也不应据此推断主机配置路径。
主要能力与范围区分
“仅遥测”设置与“将全部推理路由至网关”是两类不同的变更。应使用用户请求的范围,并保留现有的提供商、凭据及其他主机条目。
使用方式(操作流程)
- 检查当前已授权的集成以及目标账户/端点,核实可用工具或 CLI 帮助信息,以及确切的包/来源版本。在进行范围受限的编辑前,私下备份受影响的配置。
- 通过主机的私有凭据机制复用已有的授权凭据。若不存在,则让用户在服务或受支持的本地密钥界面中输入;切勿要求用户在聊天中粘贴密钥,也不要将其放入 shell 参数。前缀检查并不能作为身份验证的证明。
- 明确哪些数据将离开主机:提示词、响应、账户标识、费用、工具轨迹和错误负载。选择实际的脱敏/保留控制,并取得对私有传输和提供商费用的授权。当启用完整正文日志记录时,不要假设仅传输元数据。
- 为所选集成准备具体且受支持的配置。远程端点使用 HTTPS,拒绝 userinfo/非预期重定向;对于经过单独审查的自托管服务,本地回环地址可能是合适的。仅更改已授权的条目。仅在集成确实需要时重启相关服务,并保留其他正在运行的任务。
- 仅在授权进行提供商调用时,发送一个经批准的合成测试数据。在两端核对确切的请求/轨迹、返回的模型或遥测回执、费用以及脱敏后的日志。仅凭启动日志或等待三秒不足以证明投递成功。无法进行的身份验证或提供商检查仍属未验证状态。
- 返回变更后的配置路径、备份、观测到的回执以及剩余限制。验证回滚/禁用路径;不要仅因名称相似就禁用与之竞争的诊断插件。
示例
用户为现有本地智能体请求遥测。识别其受支持的导出器,起草确切的端点与私有凭据映射,应用已授权的范围受限变更,并在不改变默认模型提供商的情况下验证一条合成轨迹。如果仅有网关集成可用,应在进行路由变更前说明这一差异。
适用场景
适用于需要为智能体配置遥测、设置 API 密钥、排查插件问题,或诊断已授权遥测缺失的场景。
限制
- 当前的 Manifest 密钥、端点、套餐和集成方式可能发生变化;请使用实际账户说明和官方 schema。
- 网关回退或自动请求修复可能改变提供商、数据目的地、参数和重试费用;仅在授权范围内配置它们。
- 本指引仅凭安装本身,并不能证明身份验证、生产投递、计费准确性或隐私保护。