Coze 智能体创建与 API 发布完整指南

1# 保存到环境变量（推荐，避免硬编码到代码里）
2# Windows PowerShell
3setx COZE_PAT "pat_xxxxxxxxxxxxxxxxxxxxxxxx"
4
5# macOS / Linux
6echo 'export COZE_PAT="pat_xxxxxxxxxxxxxxxxxxxxxxxx"' >> ~/.bashrc
7source ~/.bashrc

1# 角色
2你是「智能客服小助手」，隶属于 AIToolSchool 教程团队，负责解答用户关于 AI 工具使用的问题。
3
4# 能力范围
5- 回答 AI 教程网站上的工具接入问题
6- 基于知识库提供准确的产品说明
7- 不确定的问题要明确说「我不确定」，不要编造答案
8
9# 回复风格
10- 语气友好、专业，使用中文
11- 答案分点陈述，重要信息加粗
12- 涉及代码时给出完整可运行的示例
13
14# 输出格式
15- 简单问题：直接给答案
16- 复杂操作：分步骤编号说明
17- 代码相关：用 ```代码块``` 包裹

1PAT（个人访问令牌）：pat_xxxxxxxxxxxxxxxxxxxxxxxx
2Bot ID：74xxxxxxxxxxxxx

1# Python（推荐，示例更丰富）
2pip install coze-py
3
4# Node.js
5npm install coze-js

1import os
2from cozepy import Coze, TokenAuth, Message, ChatStatus
3
4# 从环境变量读取凭证（不要硬编码到代码里）
5PAT = os.environ.get("COZE_PAT", "你的_pat_令牌")
6BOT_ID = "你的_bot_id"  # 形如 74xxxxxxxxxxxxx
7
8# 初始化 Coze 客户端（国内版 base_url 默认指向 api.coze.cn）
9coze = Coze(auth=TokenAuth(token=PAT))
10
11# 发起一次对话
12chat = coze.chat.create(
13    bot_id=BOT_ID,
14    user_id="user_001",  # 自定义用户标识，用于区分不同终端用户
15    additional_messages=[
16        Message.build_user_question_text("你好，请介绍一下你自己")
17    ],
18)
19
20# 轮询等待对话完成
21chat.poll(chat_id=chat.id)
22
23# 读取 Bot 的回复内容
24for message in coze.chat.messages.list(chat_id=chat.id):
25    print(f"[{message.role}] {message.content}")

1const Coze = require("coze-js");
2
3const PAT = process.env.COZE_PAT || "你的_pat_令牌";
4const BOT_ID = "你的_bot_id"; // 形如 74xxxxxxxxxxxxx
5
6const coze = new Coze({
7  token: PAT,
8  baseURL: "https://api.coze.cn", // 国内版
9});
10
11async function main() {
12  // 发起对话并等待结果
13  const chat = await coze.chat.create({
14    bot_id: BOT_ID,
15    user_id: "user_001",
16    additional_messages: [
17      { role: "user", content: "你好，请介绍一下你自己", content_type: "text" },
18    ],
19  });
20
21  // 轮询直到完成
22  const result = await coze.chat.poll(chat.id, { bot_id: BOT_ID });
23
24  // 输出回复
25  console.log("Bot 回复：", result.content);
26}
27
28main().catch(console.error);

1curl -X POST https://api.coze.cn/v1/bot/chat \
2  -H "Authorization: Bearer pat_xxxxxxxxxxxxxxxx" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "bot_id": "74xxxxxxxxxxxxx",
6    "user_id": "user_001",
7    "stream": false,
8    "additional_messages": [
9      {
10        "role": "user",
11        "content": "你好，请介绍一下你自己",
12        "content_type": "text"
13      }
14    ]
15  }'

1{
2  "code": 0,
3  "data": {
4    "id": "chat_xxxxxxxxxxxx",
5    "status": "completed",
6    "conversation_id": "conv_xxxxxxxxxxxx"
7  }
8}

1import time
2from cozepy import Coze, TokenAuth, Message
3
4coze = Coze(auth=TokenAuth(token=PAT))
5
6def call_bot_with_retry(bot_id, question, max_retries=3):
7    for attempt in range(max_retries):
8        try:
9            chat = coze.chat.create(
10                bot_id=bot_id,
11                user_id="user_001",
12                additional_messages=[Message.build_user_question_text(question)],
13            )
14            chat.poll(chat_id=chat.id)
15            return coze.chat.messages.list(chat_id=chat.id)
16        except Exception as e:
17            print(f"第 {attempt + 1} 次失败：{e}")
18            if attempt < max_retries - 1:
19                time.sleep(2 ** attempt)  # 指数退避：1s, 2s, 4s
20            else:
21                raise
22
23# 调用
24messages = call_bot_with_retry(BOT_ID, "如何接入 Coze？")
25for msg in messages:
26    if msg.role == "assistant":
27        print(msg.content)

1def handle_customer_question(user_id, question):
2    """网站后端接收用户提问，转给 Coze Bot 处理"""
3    chat = coze.chat.create(
4        bot_id=CS_BOT_ID,
5        user_id=user_id,
6        additional_messages=[Message.build_user_question_text(question)],
7    )
8    chat.poll(chat_id=chat.id)
9    # 提取 assistant 的回复
10    replies = coze.chat.messages.list(chat_id=chat.id)
11    answer = next(m.content for m in replies if m.role == "assistant")
12    return answer

1import os
2
3# 预设一批要问的问题
4questions = [
5    "合同的违约条款是怎么规定的？",
6    "技术文档里关于 API 鉴权部分怎么写？",
7    "报销流程需要哪些审批？",
8]
9
10for q in questions:
11    chat = coze.chat.create(
12        bot_id=DOC_BOT_ID,
13        user_id="batch_runner",
14        additional_messages=[Message.build_user_question_text(q)],
15    )
16    chat.poll(chat_id=chat.id)
17    msgs = coze.chat.messages.list(chat_id=chat.id)
18    answer = next(m.content for m in msgs if m.role == "assistant")
19    print(f"问题：{q}\n回答：{answer}\n{'-'*40}")

1[输入：网页 URL]
2    ↓
3[Link Reader 插件：抓取网页正文]
4    ↓
5[大模型节点：提取 3 个核心要点]
6    ↓
7[翻译插件：要点翻译为中文]
8    ↓
9[输出：结构化摘要]

1import schedule
2import time
3
4def daily_summary_job():
5    """每天早上 8 点自动抓取行业资讯并汇总"""
6    chat = coze.chat.create(
7        bot_id=WORKFLOW_BOT_ID,
8        user_id="scheduler",
9        additional_messages=[
10            Message.build_user_question_text(
11                "请抓取 https://example.com/ai-news 今日更新，"
12                "提取 3 条重点并翻译成中文，汇总后发到我的通知群"
13            )
14        ],
15    )
16    chat.poll(chat_id=chat.id)
17    print("每日摘要任务已完成")
18
19# 每天早上 8 点执行
20schedule.every().day.at("08:00").do(daily_summary_job)
21
22while True:
23    schedule.run_pending()
24    time.sleep(60)