章节十三：Python调用Coze

一、Coze概述

了解Coze平台及其API调用方式。

Coze（扣子）：字节跳动推出的AI应用开发平台，可以通过拖拽方式搭建智能体和工作流。Coze提供了API接口，让开发者可以用代码调用搭建好的智能体，把AI能力集成到自己的系统中。

Bot ID：每个Coze智能体的唯一标识符，调用API时需要指定这个ID来告诉系统要使用哪个智能体。

Personal_access_token：访问Coze API的身份凭证，就像密码一样。需要在Coze开发者平台申请，调用API时放在请求头里验证身份。

第一步：登录Coze平台，创建或选择一个智能体
第二步：获取Bot ID（在智能体设置页面的URL或详情中）
第三步：在Coze开发者平台获取Personal_access_token
第四步：安装Coze的Python SDK（pip install coze）

---

二、单次对话

掌握Python调用Coze进行单次对话的方法。

单次对话：一问一答的模式，每次对话都是独立的，系统不会记住之前的聊天内容。适合不需要上下文的简单问答场景。

第一步：导入Coze SDK并创建客户端实例（传入Personal_access_token）
第二步：调用chat.create()方法，传入Bot ID和用户消息
第三步：从返回结果中提取AI的回复内容
第四步：处理响应，展示或使用AI返回的结果

# 功能说明：使用Python调用Coze智能体进行单次对话
# 核心操作：创建Coze客户端 → 调用chat.create() → 获取回复

---

三、多轮对话

掌握Python调用Coze进行多轮对话的方法。

多轮对话：AI能记住之前的聊天内容，实现连续的对话。比如先问"北京天气怎么样"，再问"那上海呢"，AI能理解"那"指的是天气。

会话ID（Conversation ID）：标识一次连续对话的编号。每次多轮对话都需要传入相同的Conversation ID，这样AI才能记住上下文。

第一步：发起第一轮对话，系统会自动返回Conversation ID
第二步：后续对话传入相同的Conversation ID
第三步：AI根据会话历史理解上下文并回复
第四步：可以清空会话历史，重新开始新对话

# 功能说明：使用Python调用Coze进行多轮对话
# 核心操作：第一轮获取conversation_id → 后续轮次传入相同的conversation_id

---

四、流式对话

掌握Python调用Coze进行流式对话的方法。

流式输出：AI不是等全部内容生成完再返回，而是生成一点就返回一点，就像打字一样逐字显示。用户体验更好，不用长时间等待。

第一步：调用chat.stream()方法发起流式请求
第二步：遍历返回的流数据，逐段获取AI生成的内容
第三步：每收到一段内容就实时展示给用户
第四步：所有内容接收完毕后关闭流

# 功能说明：使用Python调用Coze进行流式对话
# 核心操作：调用chat.stream() → 遍历流式响应 → 逐段输出内容

---

五、调用工作流

掌握Python调用Coze工作流的方法。

工作流（Workflow）：Coze中搭建的复杂业务流程，由多个节点组成。比如一个视频分析工作流可能包含：接收链接→下载视频→语音识别→总结内容→输出结果。

工作流ID：每个工作流的唯一标识符，调用时需要指定。

异步执行：工作流可能执行较长时间（比如处理视频），调用后立即返回一个执行ID，然后通过轮询或回调获取最终结果。

第一步：获取工作流的Workflow ID
第二步：调用workflows.runs.create()传入参数，启动工作流
第三步：获取执行ID，轮询查询执行状态
第四步：工作流完成后，获取并处理最终输出结果

# 功能说明：使用Python调用Coze工作流
# 核心操作：传入workflow_id和参数 → 获取执行ID → 轮询获取结果

---

六、错误处理

掌握调用Coze API时的异常处理方法。

API调用失败的原因：网络问题、Token过期、Bot ID错误、参数格式不对、超出调用频率限制等。

第一步：用try-except捕获可能的异常
第二步：检查HTTP状态码，区分不同类型的错误
第三步：Token过期时重新获取并更新
第四步：网络错误时进行重试
第五步：记录错误日志，方便排查问题

# 功能说明：Coze API调用的异常处理
# 核心操作：try: 调用API except: 捕获异常并处理