用途
Cohere Bounded First Request（有界首次请求）用于在保持模型选择、输入类型、输出边界和证据明确的前提下，端到端验证一个选定的 Cohere 接口。它适合在证明一套新的 Cohere 环境是否可用时使用。
主要能力
- 在固定模型之前，先为预期接口发现一个实时可用模型。
- 支持 Cohere v2 的 Chat、Embed、Rerank 三类接口的有界请求。
- Chat v2 接受 messages 数组，并在响应消息下返回内容。
- Embed v2 需要 input_type 和 embedding_types；索引段落使用 search_document，查询使用 search_query。
- Rerank v2 对提供的文档进行排序；质量优先可选 rerank-v4.0-pro，有明确延迟需求可选 rerank-v4.0-fast。
- 使用非敏感的小型测试数据，并设置明确的输出或结果边界。
- 发起一次 v2 请求，并捕获状态、延迟、模型、可用时的计费单元元数据以及响应结构。
- 校验 Chat 内容非空、Embedding 维度符合预期，或 Rerank 排序单调。
- 返回凭据已脱敏的最小可复现请求。
使用方式
- 使用 cohere-install-auth 确认认证，并只选择一个接口。
- 从目录或 Models API 解析一个实时模型，并记录解析出的 ID。
- 使用非敏感的小型测试数据，并设置明确的输出或结果边界。
- 发起一次 v2 请求，捕获状态、延迟、模型、可用时的计费单元元数据以及响应结构。
- 校验 Chat 内容非空、Embedding 维度符合预期，或 Rerank 排序单调。
- 返回凭据已脱敏的最小可复现请求。
工具使用纪律：使用 Read、Glob 和 Grep 检查代码、配置和证据；仅使用 WebFetch 获取当前 Cohere 官方文档；仅当用户要求实现且确切目标文件已知时，才使用 Write 或 Edit；绝不写入凭据或客户内容。
认证
使用从已批准的密钥管理器注入的环境专用密钥。绝不打印、持久化、提交或在示例中放置 CO_API_KEY。使用与任务相称的最低成本有界操作确认访问权限，并将密钥创建、轮换、撤销、角色变更和生产容量请求视为需负责人批准的操作。
适用场景
- 验证新搭建的 Cohere 环境是否可用。
- 确认认证、模型解析和接口调用链路是否正常。
- 在正式使用前对 Chat、Embed 或 Rerank 接口做一次有界冒烟测试。
限制与审批边界
未经负责人批准，不得暴露或轮换密钥、更改 Cohere Team 角色、接受商业条款、启用敏感生产数据、增加支出或容量、切换生产模型、发送支持包，或执行模型提议的副作用。除非要求实现，否则保持诊断只读。
错误处理：400 检查必需的 v2 字段和接口特定输入类型；401 重新运行只读认证探测；404 model 解析可访问的实时模型而非猜测别名；429 遵守接口限制并停止冒烟测试。
输出
返回解析出的 API 和模型契约、检查过的文件或设置、收集的证据、验证结果、剩余风险、负责人以及回滚或下一步操作。对密钥、授权头、提示、检索文档、嵌入、客户标识符和不受限的环境输出进行脱敏。