跳转到主要内容

Coze ChatModel

中国站默认 https://api.coze.cn。国际站、Coze Studio 或企业网关应显式设置 base_url。生产令牌可通过同步/异步 token_provider 动态获取,不要写入 state、context 或 checkpoint。

Bot 与 Workflow 节点

  • CozeAgentNodeMessagesState 转为 additional_messages,并可把 conversation ID 保存到用户声明的状态键;
  • CozeWorkflowNode 执行工作流,并将 Coze interrupt 映射为耐久暂停;
  • SSE delta 会立即转成 AIMessageChunk,可通过 messagesevents 模式消费;
  • requires_action 可交给本地 ToolNode,或用 hitl=True 请求人工审批。
Workflow 恢复值必须回显原事件信息:

可靠性语义

客户端对网络错误、408/409/425/429/5xx 执行有上限指数退避,遵守 Retry-After,并在同一逻辑调用中复用 X-Idempotency-Key。SSE 重连发送 Last-Event-ID 并按事件 ID 去重。
Coze 外部调用仍是至少一次语义。远端成功但本地 checkpoint 尚未提交时进程退出,恢复可能重放调用。副作用工具必须使用 runtime.idempotency_key 在业务服务去重。