扣子(coze)智能体创建发布过程及开放API信息查阅方法

☞ ░ 前往老猿Python博客 ░ https://blog.csdn.net/LaoYuanPython

一、关于扣子和智能体

扣子Coze 是一个由字节跳动推出的 AI 平台，允许用户通过简单的操作创建 AI 应用新一代 AI 应用开发平台，对开发者无编程基础的要求，开发者通过扣子可以快速搭建基于大模型的各类 AI 应用，并将 AI 应用发布到各个社交平台、通讯软件，也可以通过 API 或 SDK 将 AI 应用集成到业务系统中。扣子支持开发者创建AI智能体和AI应用。

• 智能体（Agent）：是一种基于对话的 AI 项目，它通过对话方式接收用户的输入，并能够理解用户的需求。智能体通常由大模型驱动，可以自动调用插件、工具或工作流等方式来执行用户指定的业务流程，并最终生成回复。例如，智能体可以用于智能客服、任务自动化、信息检索等多种场景。
• 应用：应用是指利用大模型技术开发的应用程序。扣子中搭建的 AI 应用具备完整业务逻辑和可视化用户界面，是一个独立的 AI项目。通过扣子开发的 AI 应用有明确的输入和输出，可以根据既定的业务逻辑和流程完成一系列简单或复杂的任务，例如 AI搜索、翻译工具、饮食记录等。

本文只介绍在扣子中创建智能体的具体步骤。

二、在扣子中创建简单智能体

进入扣子主页，选择左侧工具栏上的工作空间，点击右侧顶部的创建按钮，在弹窗中选择创建智能体。
进入智能体创建页面，输入相关信息，如图：

注意:

1. 人设与回复逻辑：大家可以参考现在截图中的格式输入相关内容，也可以简单写一段自己描述智能体功能要求的内容，然后点击该输入框右上的“优化”按钮，扣子会根据输入内容自动生成格式化内容；

2. 插件：智能体中的插件通常是基于输入内容自动调用的。智能体会分析用户的输入，根据预设的逻辑和条件决定是否需要调用特定的插件来执行任务或提供信息。这种自动调用机制使得智能体能够更智能地响应用户需求，提供更加个性化和高效的服务。平台已经提供了一部分通用插件，开发者只需要根据自己应用相关的方向选择相关插件以丰富智能体的能力；

3. 工作流：智能体中的工作流是指智能体在执行任务时所遵循的一系列预设步骤或流程。这些步骤通常包括输入解析、意图识别、信息检索、决策制定、执行动作和输出结果等环节。工作流的设计旨在确保智能体能够高效、准确地处理用户请求，并在必要时调用相应的插件或服务来完成特定功能。通过优化工作流，智能体可以提升响应速度和处理复杂任务的能力，从而提供更加流畅和满意的用户体验。

4. 知识：知识是指创建智能体时开发者手工录入的知识，扣子支持的知识包括文本、表格和图片
   ※ 文本是将文档、URL、三方数据源上传为文本知识库后，用户发送消息时，智能体能够引用文本知识中的内容回答用户问题；
   ※ 表格是用户上传的表格数据，支持按照表格的某列来匹配合适的行给智能体引用，同时也支持基于自然语言对数据库进行查询和计算；
   ※ 图片是上传到知识库的图片，上传后自动/手动添加语义描述，智能体可以基于图片的描述匹配到最合适的图片

5. 触发器：智能体中的触发器是一种机制，它能够在特定条件或事件发生时激活智能体的某些功能或流程，触发器的作用是使智能体能够自动响应环境变化或用户需求，无需人工干预即可执行预定任务，从而提高效率和用户体验。
   触发器可以基于多种条件设置，例如：
   ※ 时间触发器：在特定的时间或时间间隔触发，如每天早晨8点发送天气预报。
   ※ 事件触发器：当检测到特定事件时触发，如收到新邮件时通知用户。
   ※ 数据触发器：当数据满足特定条件时触发，如股票价格达到某个阈值时发出警报。
   ※ 用户行为触发器：根据用户的操作或行为触发，如用户点击某个按钮后展示相关信息。
   扣子支持的触发器包括时间触发器和事件触发器。

6. 智能体的记忆：是指其存储和检索过去经验、交互数据和学习成果的能力。这种记忆机制使得智能体能够在未来的决策和行动中利用历史信息，从而提高其性能和适应性。在扣子平台中，支持变量、数据库、长期记忆、文件盒子：
   ※ 变量：用于保存用户个人信息，让智能体记住用户特征，使得回复更加个性化；
   ※ 数据库：以表格结构组织的数据，可以实现类似书签和图书管理等功能；
   ※ 长期记忆：总结聊天对话内容，以更好响应用户消息；
   ※ 文件盒子：用来保存会话中保存文件。

7. 对话体验：用于提升对话体验的相关设置，包括开场白、用户问题建议、快捷指令、背景图片、机器人语音设置以及用户输入方式设置等。

本文只介绍简单智能体的创建，只用了前面2个设置，其他暂时不介绍。

智能体相关设置完成后，就可以点击发布按钮进行发布，发布的时候可以选择发布到哪些应用以及是否支持用API和SDK方式发布，发布时需要获得对应应用授权。如图：

所有发布和未发布的智能体，都可以进入个人空间选择对应智能体查看，如图：

注意，查看智能体信息时，上述URL中标红部分是智能体的ID，称为botid，这个在API访问时需要botid作为参数。

三、添加令牌token

令牌token是访问进行合法性验证的机制，不同平台对token的使用不同，有的是基于用户授权token，有的是基于智能体逐个授权token，扣子是基于用户进行授权的。

具体授权操作步骤：
进入开发者的扣子主页，依次点击：扣子API->授权->个人访问令牌->添加新令牌，出现如图弹窗：

点击确定新增token，出现如下弹窗：

最后一行就是新创建的令牌，点击右边的复制按钮，即可复制该token，在API开发时需要使用token。

四、预览与调试

智能体创建后，在个人空间点击对应智能体后，在查看智能体信息的同时，还可以直接在右侧进行预览与调试。

五、关于API

扣子支持将 AI 智能体和扣子应用发布为 API 服务，可以通过 HTTP 方式与其进行交互。

每个智能体平台的API管理和调用是不同的，扣子提供了详细的API管理功能，如图：

下面以发起对话为例来说明API信息的查看，点击：对话->发起对话，出现如下内容：

在左边有发起对话接口的说明和对话请求中需要填写的参数、参数说明，在输入相关参数后就会在右侧生成shell、python以及Java发起API访问的示例代码，其中python的代码是基于cozepy库提供的能力。

cozepy 是 Coze 平台的 Python SDK，用于帮助开发者更方便地调用 Coze 的 API。其主要功能包括：

• API 调用：支持 Coze 的所有开放 API 和认证 API
• 同步和异步调用：支持同步和异步操作。
• 流式接口优化：支持流式聊天和工作流运行。
• 便捷的 API 设计：提供简单易用的接口。
  通过 cozepy，开发者可以实现创建/更新/发布/管理机器人、进行聊天操作、管理对话和消息、上传文件并用于多模态对话、调用工作流并处理中断事件。

六、小结

本文介绍了在字节跳动其下的COZE AI应用开发平台配置开发简单智能体的全过程案例，通过该案例可以了解智能体的基本能力和开发智能体的基本过程，并了解COZE提供的 API能力。

更多人工智能知识学习过程中可能遇到的疑难问题及解决办法请关注专栏《零基础机器学习入门》及付费专栏《机器学习疑难问题集》后续的文章。

写博不易，敬请支持：

如果阅读本文于您有所获，敬请点赞、评论、收藏，谢谢大家的支持！

关于老猿的付费专栏

1. 付费专栏《https://blog.csdn.net/laoyuanpython/category_9607725.html 使用PyQt开发图形界面Python应用》专门介绍基于Python的PyQt图形界面开发基础教程，对应文章目录为《 https://blog.csdn.net/LaoYuanPython/article/details/107580932 使用PyQt开发图形界面Python应用专栏目录》；
2. 付费专栏《https://blog.csdn.net/laoyuanpython/category_10232926.html moviepy音视频开发专栏 )详细介绍moviepy音视频剪辑合成处理的类相关方法及使用相关方法进行相关剪辑合成场景的处理，对应文章目录为《https://blog.csdn.net/LaoYuanPython/article/details/107574583 moviepy音视频开发专栏文章目录》；
3. 付费专栏《https://blog.csdn.net/laoyuanpython/category_10581071.html OpenCV-Python初学者疑难问题集》为《https://blog.csdn.net/laoyuanpython/category_9979286.html OpenCV-Python图形图像处理 》的伴生专栏，是笔者对OpenCV-Python图形图像处理学习中遇到的一些问题个人感悟的整合，相关资料基本上都是老猿反复研究的成果，有助于OpenCV-Python初学者比较深入地理解OpenCV，对应文章目录为《https://blog.csdn.net/LaoYuanPython/article/details/109713407 OpenCV-Python初学者疑难问题集专栏目录 》
4. 付费专栏《https://blog.csdn.net/laoyuanpython/category_10762553.html Python爬虫入门 》站在一个互联网前端开发小白的角度介绍爬虫开发应知应会内容，包括爬虫入门的基础知识，以及爬取CSDN文章信息、博主信息、给文章点赞、评论等实战内容。

前两个专栏都适合有一定Python基础但无相关知识的小白读者学习，第三个专栏请大家结合《https://blog.csdn.net/laoyuanpython/category_9979286.html OpenCV-Python图形图像处理 》的学习使用。

对于缺乏Python基础的同仁，可以通过老猿的免费专栏《https://blog.csdn.net/laoyuanpython/category_9831699.html 专栏：Python基础教程目录）从零开始学习Python。

如果有兴趣也愿意支持老猿的读者，欢迎购买付费专栏。

老猿Python，跟老猿学Python！

☞ ░ 前往老猿Python博文目录 https://blog.csdn.net/LaoYuanPython ░