基于 Coze 构建 AI 应用及 Web 部署指南

Coze 简介

什么是 Coze？

Coze 是字节跳动开发的 AI Agent 平台，作为一款人工智能开发工具，它可以帮助开发者通过低代码甚至零代码的方式快速构建应用程序。此外还提供了相关的 API 和 SDK，可以集成到我们自己开发的项目业务中。

核心概念

智能体：用户以对话的方式与 AI 进行交互，它根据用户输入，利用大模型自动调用相关的工具或流程完成特定任务，例如，可以将其构建为类似人工智能客服的对话应用。
应用：在智能体的基础上包装一层外壳，即多了一个 web 页面或移动端界面。
大模型：是一种基于海量数据和巨量参数构建的人工智能模型，类似一个'超级大脑'。智能体和应用的实现依赖于大模型。

大模型的缺陷

没有数据实时性：比如它无法知道今天的天气情况，无法知道今天道路的拥堵情况，无法社会的实时热点等等。
'幻觉'问题：生成看似合理但完全错误或虚构的信息，包括捏造事实、引用不存在的文献、给出错误答案。
推理能力有限：在复杂逻辑推理、数学计算、因果推断和规划任务上表现不稳定，容易犯低级错误。

此外大模型还依赖于提示词，提示词的详细程度和设计质量直接影响模型输出结果是否符合预期。

Coze 的核心价值，在于为原始大模型装备了一套功能强大的'外骨骼'与'操作系统'。这个'操作系统'通过一系列工程化手段（工具扩展、流程固化、知识增强、角色设定）来引导、约束、放大和聚焦大模型的通用能力，最终创造出能够可靠、自主、高效地解决特定领域问题的智能体（AI Agent）。将大模型的'通用能力'设计成'特定能力'。

Coze 产品生态

扣子开发平台：如同餐厅的菜谱研发部门，负责设计新菜品（智能体功能）、制定烹饪流程（工作流）和食材搭配（插件/知识库集成）。
扣子罗盘：相当于餐厅的运营管理系统，实时监控订单流量（用户交互）、分析菜品受欢迎程度（智能体性能指标）、优化供应链（模型调用成本）。
Eino 框架：相当于餐厅的厨房基础设施，包括炉灶（核心引擎）、冷藏系统（数据存储）和排烟管道（数据流处理）。
扣子空间：相等于顾客在餐厅就餐，可直接与'厨师团队'（专家 Agent）交互，直接看到后厨做菜到上菜的全过程。

智能体开发基础

接下来我们试着开发一个智能体，步骤：创建 - 开发 - 调试 - 发布 - 优化。

在这里插入图片描述

模式选择 智能体的三种模式：

在这里插入图片描述

单 Agent（自主规划模式）：单个智能体独立完成任务，架构简单，适用于流程固定、逻辑单一的场景。
单 Agent（对话流模式）：通过预设多轮对话流程引导用户完成任务，支持条件分支、上下文记忆和动态交互。它像电话里的语音客服，严格按脚本提问，引导你一步步提供信息，最后给出结果。适合流程标准化、需要引导用户的场景。
多 Agents：多个智能体协同工作，从不同角度评估问题，通过协作或辩论得出更全面、更平衡的方案。适合极其复杂的任务。

提示词

系统提示词：在创建智能体式由开发者设定，告诉大模型这个智能体是用来做什么的，和设定一些技能和规则等等。
用户提示词（个性化的）：也在使用智能体时用户的输入，在系统提示词规则范围内才被处理。

系统提示词与用户提示词测试：

在这里插入图片描述

这里系统提示词提供了 AI 润色，我们还可以根据需要进行修修改改。

开场白设置

在这里插入图片描述

最后进行发布即可。

Coze 资源

插件

在 Coze 中，插件是扩展智能体功能的模块化工具，通过调用外部服务、数据接口或预设逻辑，使智能体具备实时交互、动态决策和场景化服务能力。示例： 出行规划智能体

在这里插入图片描述

效果测试：

在这里插入图片描述

从这个例子可以看出，AI 插件是为智能体赋予'实际行动能力'的工具，就像 AI 的'手和脚'，让智能体拥有了对外执行操作的实体能力。它能打破智能体仅停留在聊天与文本生成的局限，连接真实的外部世界，执行各类具体任务。

插件分类：

数据查询类：获取外部实时数据，墨迹天气、微博热点
业务工具类：执行特定的功能，如生成视频、生成图片

注：有的插件可能付费，可能需要到第三方平台申请。

扣子知识库

一些私有的数据大模型是无法获取到的，如一个公司的入职指南、人员信息、财务信息，又或是老师上课做的 ppt，家里的 WiFi 密码，自己做的学习笔记等等。而 Coze 支持导入自己私有的数据给大模型。这有什么应用场景呢？比如，新员工入职一家公司，会有一大堆问重复性的问题：

'公司的 Wi-Fi 密码是多少？'
'报销流程怎么走？需要哪些票据？'
'年假是怎么计算的？'
'公司附近有什么好吃的推荐吗？'
'技术文档的模板在哪里下载？'

我们可以把这些问题和答案整合一下做成一个文档，然后导入给智能体，到时候新员工直接去问智能体即可。 Coze 平台内置并深度集成了RAG能力，RAG 的全称是检索增强生成。它是一种将信息检索与大语言模型相结合的架构范式。RAG 功能主要通过'知识库'功能模块来体现。简单来说，RAG 的工作原理就像学生在写论文前先去图书馆查资料：

检索：根据问题，从一个外部知识库（如数据库、文档等）中查找最相关的信息片段。
增强：将这些检索到的信息作为'参考资料'或'上下文'，与用户的原始问题一起输入给大语言模型。
生成：大语言模型基于这些提供的可靠'参考资料'，生成更准确、更可靠的回答。

示例：这里模拟做了一个新员工入职指南

在这里插入图片描述

新创建智能体，并把数据导入知识库，再把知识库的内容导入到智能体中。

在这里插入图片描述

此外，还可以将个人学习资料导入知识库，构建一个能够答疑和检索资料的专属学习助手。

数据库资源

Coze 数据库是字节跳动扣子平台提供的结构化数据存储服务，采用类 NoSQL 的文档模型，支持通过自然语言或 SQL 语句进行数据的增删改查操作。作为智能体的'长期记忆'组件，它能够持久化存储用户交互数据、业务配置信息和应用状态，是构建复杂 AI 应用的核心基础设施。智能体本身有一部分记忆功能，也就是在编排中的携带上下文论数，轮数上限通常为 100 轮，且会消耗积分，这对于需要长期记忆的应用场景来说并不方便。如下：

在这里插入图片描述

使用数据库资源，我们就可以把数据做持久的储存，分别做分析。示例：比如一个健身教练智能体，需要将你做的运动记录或身体状态记录下来，几个星期的，几个月的，甚至几年，这样才方便为你做出健身规化。创建健身教练智能体

在这里插入图片描述

测试示例：

在这里插入图片描述

除此之外数据库还有缓存的功能，把问题和答案记录下来，下次问相同的问题就不用做思考，直接从数据库中查看。

工作流开发与发布

什么是工作流？ 是完成特定目标，而设计的一系列结构化、自动化（或半自动化）的步骤和规则。节点是工作流的最小拆分单位，它的核心包括开始节点、结束节点、大模型节点、插件节点、工作流节点，是系列指令的集合，能够处理复杂的场景。

注：可以将其理解为编程中的'函数调用'，即一个工作流可以嵌套调用另一个工作流。

工作流分类

Workflow（工作流）：面向数据自动化处理场景，通过顺序执行节点链实现特定功能，适用于标准化、批量化任务。
Chatflow（对话流）：基于对话场景的特殊工作流，通过多轮交互动态调整流程逻辑。

创建工作流：

在这里插入图片描述

加入并连接节点：

在这里插入图片描述

设置节点：

在这里插入图片描述

测试运行：

在这里插入图片描述

在智能体中使用工作流：

在这里插入图片描述

应用开发与发布

相比智能体，应用开发多了一个前端页面，主要依赖于工作流，操作也十分简单，接下来我们使用上面的工作流封装出一个应用：

在这里插入图片描述

组件设置：

在这里插入图片描述

业务逻辑设置：

在这里插入图片描述

最后可以添加一些展示组件，使得它更美观。

在这里插入图片描述

Coze 的 API 与 SDK

Coze 支持将 AI 智能体和扣子应用发布为 API 服务，可以通过 HTTP 方式与其进行交互。有编程基础的情况下，能够给用户更多的自定义开发空间。扣子 API 通过访问令牌（Access Token）进行 API 请求的鉴权。所有的 API 请求都必须在请求头的 Authorization 参数中包的访问令牌（Access Token）。

在这里插入图片描述

注意：Access Token 仅首次生成时显示，请务必妥善保存，丢失后需要重新生成。

在 API 方面，Coze 主要提供了 Bot 调用接口，允许通过 HTTP 请求与指定的 Bot 进行交互。用户只需提供 Bot ID 和访问令牌，即可向接口发送用户输入，并接收 Bot 生成的文本、卡片或其他结构化响应。该 API 支持流式输出，适用于需要实时反馈的场景，同时也允许传递自定义参数以控制 Bot 的行为，例如调整回复风格或启用特定插件。此外，Coze 还提供了管理 API，用于查询 Bot 信息、管理会话历史或处理文件上传等操作，为集成提供了更全面的控制能力。在 SDK 支持上，Coze 目前主要提供了 Python SDK，简化了在 Python 项目中的集成流程。SDK 封装了 API 调用的细节，提供了直观的类与方法，让开发者能够更便捷地初始化客户端、发送消息并处理响应。无论是同步调用还是异步流式响应，SDK 都提供了相应的支持，大幅降低了开发门槛。

实战案例

在这里插入图片描述

子流程：

在这里插入图片描述

循环体内的代码用来提取 url，如下：

async def main(args: Args) -> Output:
    params = args.params
    # 构建输出对象
    ret: Output = {"key0": params['input'][0]["url"]}
    return ret

同样的最终结果处理用来提取 url：

async def main(args: Args) -> Output:
    params = args.params
    # 构建输出对象
    ret: Output = {"key0": params['input'][0]}
    return ret

主流程中的代码，整理并构建最终结果：

async def main(args: Args) -> Output:
    params = args.params
    result = ''
    # 1 input 和 db 都是空的
    if not params.get('db') and not params.get('input'):
        result = '比特就业课'
    # 2 db 为空
    elif not params.get('db'):
        result = params['input']
    # 3 input 为空
    elif not params.get('input'):
        result = params['db'][0].get('video_url')
    # 核心修复：移除所有空白字符（空格、制表符、换行等）
    result = result.replace(" ", "")
    # 构建输出对象
    ret: Output = {"key0": result}
    return ret

注意：因为使用的阿里云 OSS 插件生成的 URL 可能包含换行符或空白字符，因此我们在代码中增加了去除空白字符的处理逻辑。

阿里云 OSS（对象存储服务）的使用：

登录阿里云官网搜索并创建免费的对象存储 oss
点击个人头像点击找到 AccessKey，点击进入使用云账号创建 AccessKey 并保存好信息。
进入对象存储 OSS 控制台，创建 Bucket 列表。
在工作流中搜索插件阿里云文件上传 oss，并设置

在这里插入图片描述

在创建好工作流后，我们可以像之前一样将其用于智能体或应用开发。接下来，我们将进一步把它封装成 SDK，并集成到一个独立的 Web 应用中。

首先创建.env 环境变量，设置相关信息

COZE_API_TOKEN="填入用户令牌信息"
WORKFLOW_ID="填入需要使用的工作流 id"
USER_ID="填入用户 id"

在这里插入图片描述

封装 SDK 并做 web 开发

import os
import json
from dotenv import load_dotenv
from cozepy import Coze, TokenAuth, COZE_CN_BASE_URL
from flask import Flask, request, jsonify, send_file
from flask_cors import CORS

# 加载环境变量
load_dotenv()

app = Flask(__name__)
CORS(app)  # 允许跨域请求

# 调用工作流生成视频
def create_video(animal_description):
    try:
        api_token = os.getenv('COZE_API_TOKEN')
        workflow_id = os.getenv('WORKFLOW_ID')
        # 初始化 coze 客户端
        coze = Coze(
            auth=TokenAuth(token=api_token),
            base_url=COZE_CN_BASE_URL
        )
        # 执行工作流
        workflow = coze.workflows.runs.create(
            workflow_id=workflow_id,
            parameters={"input": animal_description}
        )
        # 接收返回的内容
        video_url = json.loads(workflow.data)['output']
        return video_url
    except Exception as e:
        return None

# 声明接口路由
@app.route("/generate-video", methods=['POST'])
def generate_video():
    # 获取请求参数
    data = request.get_json()
    animal_description = data.get('input', '').strip()
    video_url = create_video(animal_description)
    return jsonify({'success': True, 'video_url': video_url, : animal_description})



 ():
     send_file()

 __name__ == :
    app.run(debug=, host=, port=)

使用 AI 生成 html 页面，即 index.html 文件，运行 Python 程序。效果如下：

在这里插入图片描述

index.html 文件：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>动物世界视频生成器</title>
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css">
<style>
* {
    margin: 0;
    padding: 0;
    box-sizing: border-box;
    font-family: 'Segoe UI', 'Microsoft YaHei', sans-serif;
}
body {
    background: linear-gradient(135deg, #1a2a6c, #b21f1f, #fdbb2d);
    background-size: 400% 400%;
    animation: gradientBG 15s ease infinite;
    min-height: 100vh;
    color: #333;
    padding: 20px;
}
 gradientBG {
     { :  ; }
     { :  ; }
     { :  ; }
}
 {
    : ;
    :  auto;
    : ;
}
 {
    : center;
    : ;
    : white;
    :    (, , , );
}
  {
    : ;
    : ;
    : (, , );
    -webkit-: text;
    : text;
    : transparent;
}
  {
    : ;
    : ;
    :  auto;
    : ;
    : (, , , );
}
 {
    : flex;
    : column;
    : ;
}
 (: ) {
     {
        : row;
    }
}
,  {
    : (, , , );
    : ;
    : ;
    :    (, , , );
    : ();
    : ;
}
 {
    : flex;
    : column;
}
 {
    : flex;
    : center;
    : ;
    : ;
    : ;
    : ;
    : ;
    :  solid ;
}
  {
    : ;
}
 {
    : ;
    : ;
    : ;
    : ;
    :  solid ;
    : ;
    : vertical;
    : ;
    : border ;
}
 {
    : none;
    : ;
    :     (, , , );
}
 {
    : ;
    : ;
}
  {
    : ;
    : ;
    : ;
}
 {
    : flex;
    : wrap;
    : ;
}
 {
    : ;
    :  ;
    : ;
    : pointer;
    : all ;
    :  solid ;
    : ;
}
 {
    : ;
    : (-);
    :    (, , , );
}
 {
    : flex;
    : ;
    : ;
}
 {
    :  ;
    : none;
    : ;
    : ;
    : ;
    : pointer;
    : flex;
    : center;
    : center;
    : ;
    : all ;
    : ;
}
 {
    : (, , );
    : white;
}
 {
    : (-);
    :    (, , , );
}
 {
    : ();
}
 {
    : ;
    : ;
    :  solid ;
}
 {
    : ;
    : (-);
}
 {
    : flex;
    : column;
}
 {
    : ;
    : flex;
    : center;
    : center;
    : ;
    : ;
    : hidden;
    : ;
    : ;
    : relative;
}
 {
    : center;
    : ;
    : ;
}
  {
    : ;
    : ;
    : ;
}
  {
    : ;
    : ;
}
 {
    : ;
    : ;
    : ;
}
 {
    : absolute;
    : ;
    : ;
    : ;
    : ;
    : (, , , );
    : flex;
    : column;
    : center;
    : center;
    : ;
    : ;
}
 {
    : ;
    : ;
    :  solid ;
    :  solid ;
    : ;
    : spin  linear infinite;
    : ;
}
 spin {
     { : (); }
     { : (); }
}
 {
    : ;
    : ;
    : ;
    : ;
}
  {
    : ;
    : ;
    : flex;
    : center;
    : ;
}
 {
    : ;
    : ;
}
 {
    : flex;
    : ;
    : ;
}
 {
    :  ;
    : ;
    : none;
    : ;
    : ;
    : pointer;
    : flex;
    : center;
    : center;
    : ;
    : all ;
    : ;
}
 {
    : (, , );
    : white;
}
 {
    : (-);
    :    (, , , );
}
 {
    : (, , );
    : white;
}
 {
    : (-);
    :    (, , , );
}
 {
    : center;
    : ;
    : (, , , );
    : ;
    : ;
}
  {
    : ;
    : none;
}
  {
    : underline;
}
 {
    : fixed;
    : ;
    : ;
    :  ;
    : ;
    : white;
    : ;
    :    (, , , );
    : ;
    : flex;
    : center;
    : ;
    : ();
    : transform  ease;
}
 {
    : ();
}
 {
    : (, , );
}
 {
    : (, , );
}
 (: ) {
      {
        : ;
    }
    ,  {
        : ;
    }
    ,  {
        : column;
    }
    ,  {
        : ;
    }
}




    
         动物世界视频生成器
        描述你想象中的动物，AI 将为你生成独特的动物视频。从可爱的小猫到神奇的神兽，一切皆有可能！
    
    
        
            
                
                描述你的动物
            
            
            
                试试这些例子：
                
                    会说话的熊猫
                    彩虹独角兽
                    机械狮子
                    发光水母
                    飞天小猫
                
            
            
                 生成视频
                 清空内容
            
        
        
            
                
                生成的视频
            
            
                
                    
                    视频将在这里显示
                    描述一个动物，然后点击'生成视频'按钮
                
                
                    
                    正在生成视频...
                    这可能需要一些时间，请耐心等待
                
                
            
            
                 描述
                
                
                     下载视频
                     分享视频
                
            
        
    
    
        Powered by Coze AI • 视频生成可能需要 30 秒到 1 分钟时间 • 刷新页面

基于 Coze 构建 AI 应用及 Web 部署指南

Coze 简介

什么是 Coze？

核心概念

Coze 产品生态

智能体开发基础

Coze 资源

插件

扣子知识库

数据库资源

工作流开发与发布

应用开发与发布

Coze 的 API 与 SDK

实战案例

更多推荐文章

相关免费在线工具

基于 Coze 构建 AI 应用及 Web 部署指南

Coze 简介

什么是 Coze？

核心概念

Coze 产品生态

智能体开发基础

Coze 资源

插件

扣子知识库

数据库资源

工作流开发与发布

应用开发与发布

Coze 的 API 与 SDK

实战案例

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具