用途:该 Skill 提供完整的扣子(Coze)API 调用指南,用于在应用中集成 Coze 智能体,实现对话、工作流执行等操作。
主要能力:支持对话 API(流式与非流式)、工作流 API 执行已发布工作流,以及消息管理(查询对话状态和消息列表)。
使用方式:需先获取个人访问令牌(PAT),进入 Coze 平台个人中心 API 管理创建;获取 Bot ID(从 Bot 编辑页 URL 提取);在 Bot 页面发布并选择 Bot as API。API 基础 URL 为 https://api.coze.cn,版本 v3,认证头为 Authorization: Bearer {YOUR_PAT_TOKEN}。
对话接口:POST https://api.coze.cn/v3/chat,必填 bot_id、user_id、stream、additional_messages;非流式时 auto_save_history 必须为 true,流式时必须为 false。非流式需轮询 retrieve 与 message/list 接口获取结果。工作流接口:POST https://api.coze.cn/v3/workflows/run,需 workflow_id 与 parameters。
适用场景:聊天应用、数据分析、批量处理、实时反馈等。
限制:基础版每账号 100 次 API 调用(一次性),专业版按 Token 消耗计费;常见错误码 400/401/403/429/500;流式模式下 auto_save_history 必须为 false;Token 应使用环境变量存储,避免硬编码。官方文档:https://www.coze.cn/open/docs/developer_guides/coze_api_overview