用途:在 TypeScript/JavaScript 项目中调用 Cohere API,实现对话生成、文本嵌入、重排序和工具调用,可用于 Node.js 或浏览器应用。
安装:npm install cohere-ai,或 yarn add cohere-ai、pnpm add cohere-ai。
客户端初始化:使用 CohereClientV2,可自动读取 CO_API_KEY 环境变量,或显式传入 token,也可通过 environment 指定私有部署端点。
主要能力:chat 支持系统消息、temperature/maxTokens/p/k/seed/stopSequences 等参数;chatStream 以异步迭代方式流式返回,处理 content-delta 事件;embed 支持 embed-v4.0,需区分 search_document(存文档)与 search_query(查询),批量嵌入有 96 条上限;rerank 使用 rerank-v4.0-pro 按 topN 返回结果与相关性分数;工具调用通过 tools 定义函数并循环执行 toolCalls,将结果作为 tool 角色消息回传;structured outputs 可用 json_object 配合 jsonSchema 约束输出结构。
集成与错误处理:可通过 Vercel AI SDK 的 @ai-sdk/cohere 使用 generateText 与 embed;错误可捕获 CohereTimeoutError 和 CohereError。
限制:资料未说明价格、速率限制、浏览器环境具体注意事项及模型可用性等细节,暂未提供。