用途:为 Cohere 集成建立可观测性,把应用、检索、模型、容量和提供商故障分开定位,同时避免泄露凭据与客户内容。
主要能力:分别测量队列、检索、提供商、首事件、完成和工具调用耗时;用 endpoint、operation、解析后的模型、环境、结果、重试类别等有界维度打标签;默认不把提示词、文档、嵌入、密钥和原始工具参数写入遥测;将运行指标与抽样的质量、引用与安全评估配对。
使用方式:先用 Read、Glob、Grep 检查代码与配置;仅用 WebFetch 查当前 Cohere 官方文档;仅在用户要求实现且目标文件明确时才用 Write 或 Edit,且不得写入凭据或客户内容。先定义服务目标与遥测字段白名单,再创建请求、结果、重试、限流、熔断转换和工具决策计数器,以及各类耗时直方图和用量成本单位;最后建立可用性、持续限流、队列年龄、延迟、质量和支出告警,并测试脱敏、追踪传播、流取消和事件关联。
密钥:使用从批准的密钥管理器注入的环境专用密钥,绝不打印、持久化、提交或把 CO_API_KEY 放入示例。密钥创建、轮换、撤销、角色变更和生产容量请求须责任人批准。
限制与边界:不得在未获责任人批准时暴露或轮换密钥、更改 Cohere Team 角色、接受商业条款、启用敏感生产数据、增加支出或容量、切换生产模型、发送支持包或执行模型建议的副作用;未要求实现时诊断保持只读。输出应包含解析后的 API 与模型契约、检查过的文件或设置、采集证据、验证结果、剩余风险、责任人和回滚或下一步,并脱敏密钥、授权头、提示词、检索文档、嵌入、客户标识符和环境输出。
错误处理:基数激增时移除无界标签并在日志中聚合请求标识;追踪中出现提示词则脱敏并按数据事件审查;缺少终止事件则标记流不完整并计入独立结果;误报提供商告警时拆分本地队列检索时间与 Cohere 耗时。
资料未提供具体安装命令、收费价格或完整代码示例。