掘金 人工智能 前天 14:41
实战 Coze Studio 智能体开发
index_new5.html
../../../zaker_core/zaker_tpl_static/wap/tpl_guoji1.html

 

本文详细介绍了如何在 Coze Studio 中从零开始创建和发布 AI 智能体。文章首先演示了如何通过配置人设和回复逻辑,快速创建一个简单的“翻译小能手”智能体,并介绍了智能体配置页面的主要功能模块,包括编排和预览调试区域。随后,文章深入讲解了如何通过自定义插件扩展智能体的能力,以“天气查询”插件为例,详细阐述了创建插件、配置工具路径、请求方法、输入输出参数以及试运行测试的步骤。此外,文章还介绍了如何配置和使用 Coze Studio 内置的插件,例如通过配置“博查搜索”插件,使智能体能够连接互联网获取实时信息,并详细说明了插件授权的两种方式。最后,文章对整个智能体开发流程进行了总结,为后续更高级功能的探索奠定了基础。

💡 **创建基础智能体:** Coze Studio 允许用户通过配置“人设与回复逻辑”来快速创建智能体。以“翻译小能手”为例,只需设定其翻译任务和语言转换规则,即可实现基本的翻译功能。智能体配置页面分为左侧的“编排”区域(用于设置人设、技能、知识、记忆和对话体验)和右侧的“预览与调试”区域。

🛠️ **自定义插件扩展能力:** 智能体的能力可以通过添加“技能”来扩展,其中插件是调用外部工具的关键。文章以创建“天气查询”插件为例,演示了如何选择“云侧插件 - 基于已有服务创建”,配置插件 URL、工具路径、请求方法、输入参数,并利用“自动解析”功能完善输出参数,最终成功实现了调用天气接口的“天气助手”智能体。

🔌 **配置和使用内置插件:** Coze Studio 提供丰富的官方内置插件,但部分插件需要授权才能使用。文章以“博查搜索”插件为例,说明了在 `plugin_meta.yaml` 文件中配置授权信息(如 `service_token`)的步骤,并强调了 `auth.type` 和 `payload` 的重要性,配置完成后需要重启服务才能生效。通过使用内置插件,智能体可以连接互联网获取实时信息。

🚀 **智能体与插件开发流程:** 文章从部署 Coze Studio 和配置大模型开始,逐步引导用户完成智能体的创建、配置和发布。通过“翻译小能手”和“天气助手”两个实例,用户可以掌握基于提示词和插件的智能体开发基础,为后续学习工作流、知识库等高级功能打下坚实基础。

昨天,我们成功在本地部署了 Coze Studio,并配置好了大模型。今天,我们将正式开始 Coze 智能体的探索之旅,学习如何利用其强大的可视化编排能力,创建并发布我们自己的 AI 智能体。

创建智能体

首先进入 “项目开发” 页面,点击 “创建” 按钮,Coze 支持创建两种不同的项目:

我们选择 “创建智能体”,然后为智能体取一个好听的名字,比如 “翻译小能手”:

接着,进入智能体的配置页面:

整个配置页面可分为两大块:左侧为 编排 区域,右侧为 预览与调试 区域。在编排区域里,可以对智能体进行以下配置:

这些高级配置项我们暂时不管,对于 “翻译小能手”,我们只需要配置其人设与回复逻辑即可:

你是一个翻译助手,你的任务是将用户输入翻译成其他的语言,如果用户输入是中文,翻译成英文,如果用户输入是英文,则翻译成中文。

一个简单的翻译智能体就制作完成了:

另外,我们也可以打开 “探索” - “模版” 页面,Coze Studio 内置了两个智能体模版:英语聊天和导购陪练,都是纯提示词实现的,感兴趣的可以复制到工作空间看看:

自定义插件

单纯靠提示词实现的智能体能力非常有限,它无法连接和访问外部工具,我们可以为智能体添加一些技能,比如联网搜索、科学计算或绘制图片,扩展智能体的能力。上一节提到,在 Coze Studio 中,技能分为插件和工作流两种,下面我们先来学习下如何配置和使用插件。

这一节,我们将创建一个带技能的智能体,比如调用 “天气查询” 接口回答用户关于天气的问题。首先进入 “资源库” 页面,点击 “+ 资源” 按钮:

Coze 这里提供了五种不同类型的资源:

我们这里选择创建插件:

填写插件名称和描述,创建方式选 “云侧插件 - 基于已有服务创建”,插件 URL 填 https://query.asilu.com,该站点提供了不少免费而简单的 API 接口,用来测试智能体再合适不过。

注意插件的 URL 是根路径,插件下的所有工具都在这个 URL 之下。

Header 列表不用动,如果你的接口需要一些特别的请求头,可以在这里设置;授权方式选 “不需要授权”,除此之外,Coze Studio 还支持另两种授权方式:

点击确定后进入插件页面,然后创建一个 get_weather 工具:

这个天气查询接口非常简单,只有一个 city 参数,如下:

因此我们需要配置三个地方:

输出参数可以不用手工配,点击 “自动解析” 弹出一个调试页面,输入参数后只要接口能正常访问,Coze 会自动根据接口的返回值将输出参数配置好:

配置结束后,点击右上角的 “试运行” 对接口进行测试,测试完成后,这个插件就可以发布了。

然后,我们再创建一个 “天气助手” 智能体,将 get_weather 工具添加到它的技能里,这个智能体就可以为我们查询天气了:

配置内置插件

其实,Coze Studio 提供了两种插件类型,即自定义插件和官方内置插件。官方内置插件由后台统一配置,支持所有用户使用;而自定义插件的使用范围为当前工作空间。可以打开 “探索” - “插件” 页面,查看所有官方内置插件:

可以看到内置的插件还是蛮丰富的,一共 18 个,但是要注意的是,有些插件上带有 “未授权” 的标签,这表示此插件需要授权,这些插件我们还不能使用,需要配置授权信息。

所有内置的插件位于 backend/conf/plugin/pluginproduct 目录:

$ tree backend/conf/plugin/pluginproductbackend/conf/plugin/pluginproduct├── bocha_search.yaml # 博查搜索├── chestnut_sign.yaml # 板栗看板├── gaode_map.yaml # 高德地图├── image_compression.yaml # 图片压缩├── lark_authentication_authorization.yaml # 飞书认证及授权├── lark_base.yaml # 飞书多维表格├── lark_calendar.yaml # 飞书日历├── lark_docx.yaml # 飞书云文档├── lark_message.yaml # 飞书消息├── lark_sheet.yaml # 飞书电子表格├── lark_task.yaml # 飞书任务├── lark_wiki.yaml # 飞书知识库├── library_search.yaml # 文库搜索├── maker_smart_design.yaml # 创客贴智能设计├── plugin_meta.yaml # 所有插件的元配置,包括授权信息├── sky_eye_check.yaml # 天眼查├── sohu_hot_news.yaml # 搜狐热闻├── wolfram_alpha.yaml # Wolfram Alpha└── worth_buying.yaml # 什么值得买

其中 plugin_meta.yaml 为所有插件的元配置,授权信息就是配在这个文件中。我们以 “博查搜索” 为例,在该文件中找到对应的配置块:

根据提示,访问 博查 AI 开放平台

博查搜索是国内为数不多的一家搜索服务提供商,虽然不是免费,但价格确实很便宜,一次调用仅 3 分钱,为国外同类产品的 1/3。点击 “控制台” 注册、充值、并创建 API KEY,将其配置在 payload 中的 service_token 字段:

  auth:    type: service_http    key: Authorization    sub_type: token/api_key    # service token apply to https://open.bochaai.com/    payload: '{"key": "Authorization", "service_token": "sk-xxx", "location": "Header"}'

这里的 auth.type 就对应上一节我们创建插件时选择的 “授权方式”,支持 service_httpoauth 两种,具体的授权信息位于 payload 里。关于插件配置和授权配置的详细解释,可以参考官方文档:

配置好插件授权后,重启 Coze 服务:

$ docker compose --profile "*" restart coze-server

此时 “博查搜索” 插件就可以正常使用了。我们可以创建一个 “搜索专家” 智能体,让它调用搜索引擎来回答用户的问题:

小结

今天,我们正式开启了 Coze Studio 的智能体开发之旅。我们从最基础的提示词工程开始,创建了一个简单的 “翻译小能手” 智能体,体验了仅通过人设与回复逻辑就能快速构建应用的过程。

接着,我们深入学习了如何通过插件扩展智能体的能力。我们一步步创建自定义的 “天气查询” 插件,并通过它实现了 “天气助手” 智能体;另外,还学习了如何配置和使用 Coze Studio 内置的插件,然后使用 “博查搜索” 插件,让智能体能够连接互联网获取实时信息。

通过今天的实战,我们掌握了 Coze Studio 中智能体和插件的基本用法,在后面的学习中,我们将继续探索工作流、知识库等更高级的功能,敬请期待。

欢迎关注

如果这篇文章对您有所帮助,欢迎关注我的同名公众号:日习一技,每天学一点新技术

我会每天花一个小时,记录下我学习的点点滴滴。内容包括但不限于:

目标是让大家用5分钟读完就能有所收获,不需要太费劲,但却可以轻松获取一些干货。不管你是技术新手还是老鸟,欢迎给我提建议,如果有想学习的技术,也欢迎交流!

Fish AI Reader

Fish AI Reader

AI辅助创作,多种专业模板,深度分析,高质量内容生成。从观点提取到深度思考,FishAI为您提供全方位的创作支持。新版本引入自定义参数,让您的创作更加个性化和精准。

FishAI

FishAI

鱼阅,AI 时代的下一个智能信息助手,助你摆脱信息焦虑

联系邮箱 441953276@qq.com

相关标签

Coze Studio AI智能体 插件开发 低代码 AI应用
相关文章