{T}

Coze 平台实战

Coze(扣子)是字节跳动推出的 AI 智能体创建和分享平台,通过低代码方式编排工作流、配置插件和知识库,快速构建功能强大的 AI 应用。适合产品验证、快速原型和中小规模 AI 应用部署。

平台概览

核心能力

图表渲染中…

平台优势与局限

维度优势局限
开发效率低代码快速搭建,分钟级验证复杂逻辑受限于节点能力
生态系统丰富插件、官方工具支持自定义灵活性受限
部署方式一键发布多平台平台依赖性强
数据安全适合原型验证业务隐私有顾虑
性能优化内置流式输出节点内部"黑盒",难以深度优化
适用对象AI 创业者、产品经理、前端开发不适合需要极致控制的企业级系统

工作流编排

工作流核心概念

工作流是由多个节点组成的有向无环图(DAG),数据从开始节点流向结束节点:

图表渲染中…

节点类型

节点类型功能典型用途
大模型节点调用 LLM 进行推理/生成意图分析、内容生成、润色
插件节点调用外部服务/工具搜索、语音合成、图像生成
代码节点执行自定义 JavaScript/Python数据转换、复杂逻辑
循环节点对数组逐项执行子流程批量处理、多轮搜索
选择器节点条件分支意图路由、异常处理
变量节点读写全局变量状态管理、跨节点通信
知识库节点检索知识库内容RAG 增强
消息输出节点中间结果推送给用户进度反馈、流式输出

实战:儿童故事生成工作流

图表渲染中…

意图分析节点 Prompt

markdown
# 目标
根据用户输入,分析并拆解出用于搜索的提示词,方便搜索需要的原文内容。

分析方法:
- 如果是经典故事(如三只小猪、狼来了)→ 生成查找原文的 query
- 否则 → 结合中国文化/历史/神话,生成参考资料搜索 query

# 输出
- querys: 字符串数组(搜索关键词)
- intent: 用户意图描述(强化推理用)

润色节点 Prompt

markdown
你扮演一位知性而有耐心的温柔大姐姐,正在为6岁的妹妹讲睡前故事。

要求:
- 用口语化表达,使用简短生动的句子
- 温柔、舒适的语气
- 加入互动性问题("你觉得接下来会发生什么?")
- 保持故事简短,讲述时间不超过5分钟

工作流中使用变量

通过输出"对后续无直接用途但能强化推理"的字段,提升生成质量:

typescript
// 让 AI 输出 intent 字段
// 虽然后续节点不直接使用它,
// 但强制 AI 先分析意图再生成内容,显著提升输出质量
const outputSchema = {
  querys: ['搜索词1', '搜索词2'],  // 后续节点使用
  intent: '用户意图分析',           // 强化推理,不直接使用
};

智能体创建与发布

创建流程

  1. 进入 Coze 控制台 → 创建智能体
  2. 配置人设与回复逻辑(System Prompt)
  3. 添加技能:工作流 / 插件 / 知识库
  4. 配置模型参数(模型选择、温度等)
  5. 测试调试
  6. 发布到目标平台

API 调用

发布为 API 后,通过 HTTP 请求调用智能体:

typescript
// 调用 Coze 智能体 API
const response = await fetch('https://api.coze.cn/v3/chat', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Authorization: `Bearer ${COZE_API_KEY}`,
  },
  body: JSON.stringify({
    bot_id: BOT_ID,
    user_id: 'user_001',
    stream: false,
    auto_save_history: true,
    additional_messages: [
      { role: 'user', content: '给我讲一个关于月亮的故事', content_type: 'text' },
    ],
  }),
});

const data = await response.json();
// 从 messages 中提取 type === 'answer' 的消息
const answer = data.messages.find((m) => m.type === 'answer');

响应消息类型

type说明用途
answer最终回答展示给用户
verbose调试/过程信息开发调试
follow_up推荐追问引导继续对话
function_call工具调用记录调试工作流

插件开发

自定义插件结构

yaml
# 插件 manifest
name: my_custom_plugin
description: 自定义数据查询插件
auth:
  type: api_key
  header: X-API-Key
actions:
  - name: query_data
    description: 查询业务数据
    method: GET
    url: https://api.example.com/data
    parameters:
      - name: keyword
        type: string
        required: true
        description: 搜索关键词

企业智能客服实战

架构设计

图表渲染中…

知识库优化要点

优化方向具体措施
数据质量清洗冗余、统一格式、补充缺失
分块策略按 FAQ 粒度切分,每块一个完整问答
检索增强配置同义词、设置合理的 Top-K
持续更新定期导入新产品/政策文档
效果评估监控未命中问题,补充知识盲区

常见问题与陷阱

问题原因解决方案
工作流超时节点过多或模型响应慢减少串行节点、使用更快模型
语音合成失败文本超过 1024 字符限制分段合成或截断
知识库检索不准分块粒度不当调整为 FAQ 级别分块
变量传递错误节点输出未正确连接检查输入输出连线
发布后行为不一致测试/生产模型版本不同锁定模型版本

参考资源