@cloudbase-module/ai_bot
v0.3.4
Published
智能体应用是一款专为打造个性化智能助手而设计的多平台应用模板,适用于小程序、H5、微信客服、微信订阅号、微信服务号等场景。采用低代码技术,让您轻松实现二次开发,打造符合您需求的专属智能体。
Downloads
7
Readme
功能特性
- 多平台支持:支持发布到小程序、Web 网页、微信客服、微信服务号、微信订阅号等多个平台。
- 个性化:支持通过工作流自定义编排对话逻辑,对接微信平台、企业微信等数据,以及开发者自己的业务数据。
- 智能化: 内置大模型和知识库连接向量数据,可以开发 RAG 应用等,实现高度智能化服务。
- 快速部署:提供小程序子包或者链接地址的方式引入,方便集成到现有的小程序中和网站中,也可以一键发布到公众号等客服平台。
- 方便定制:基于低代码技术,让您轻松实现0 代码开发开发,打造符合您需求的专属智能体平台。
- 私有部署:基于云开发实现,代码和用户数据均保存在开发者独立的环境中
在线体验
快速上手
体验内置的智能体
- 登录微信云模板平台。
- 在模板中心找到 “AI智能体应用” ,点击安装
- 安装完毕后即可在我的应用->AI智能体应用左侧的预览窗口,体验内置的智能体功能。
- 通过“发现智能体”或“随便聊聊”与智能体进行对话
安装云模版市场的智能体
- 进入微信云模板中心。
- 浏览并选择一个适合您需求的智能体模板。
- 点击“安装”按钮。
- 安装完成之后,即可在 AI 智能体应用中看到新安装的智能体,可以在我的应用-> AI 智能体应用中选择发布到小程序/或者 web 网页,或者发布到微信公众号或者小程序客服消息平台。
- 也可以直接在我的应用中找到已经安装的智能体应用,选择发布到微信公众号或者小程序客服消息平台
搭建自定义智能体
下面介绍如何 1 分钟 创建自己的专属 AI 智能体:
打开管理后台
- 进入我的应用 -> AI智能体应用中,打开“服务管理”->“管理后台”->“访问”
注意访问管理后台需要账号密码,可以在“云后台”中先创建一个账号
创建
- 点击 “1 分钟创建你的专属智能体”,来创建智能体
- 也可以选择“从模板创建”,来从模板中心中选择一个智能体进行创建
- 创建成功后会自动跳转进入下一步的智能体开发界面
填写人设和回复逻辑
- 在人设和回复逻辑部分,您可以定义智能体的性格特点、语言风格等。
- 可以点击使用 AI 生成建议来一键生成智能体
调试
- 在开发过程中,您可以随时使用右边的调试窗口测试智能体的表现。
- 根据调试结果,调整智能体的配置和回复逻辑。
分享和发布
- 完成智能体的开发和调试后,点击分享 可以复制智能体的链接来进行分享
- 点击提交发布后,您的智能体将正式上线,为用户提供服务。
通过以上步骤,您已成功搭建了一个智能体!
发布智能体
小程序
- 打开云模板->我的应用-> AI 智能体应用 -> 查看详情
- 选择 添加到多平台
- 通过子包的方式引入,按照指引操作,将智能体集成到现有的小程序中。
Web 网页
- 打开云模板->我的应用-> AI 智能体应用 -> 查看详情
- 选择 添加到多平台
- 通过链接嵌入我们提供的 H5/PC 地址,将智能体集成到网页中。
发布到微信服务号
- 打开云模板->我的应用,找到要发布的智能体应用,点击查看详情
- 配置微信服务号应用的相关设置,如 App ID ,然后点击授权等。
- 点击发布按钮,将智能体部署到微信服务号。
发布到微信订阅号
- 打开云模板->我的应用,找到要发布的智能体应用,点击查看详情
- 配置微信订阅号应用的相关设置,如 App ID,然后点击授权
- 点击发布按钮,将智能体部署到微信订阅号。
发布到微信客服
该功能正在开发中
通过接口方式调用
可以在小程序和云开发应用中通过以下方式来调用智能体的接口来实现自定义的功能逻辑
云能力初始化
小程序
修改app.js
,在 App
的 onLaunch
生命周期方法中添加云能力初始化代码,参数传入用户的云开发环境ID。
App({
onLaunch: function () {
wx.cloud.init({
// env 参数决定接下来小程序发起的云开发调用(wx.cloud.xxx)会默认请求到哪个云环境的资源
env: '{%TCB_ENV_ID%}',
// 是否在将用户访问记录到用户管理中,在控制台中可见,默认为false
traceUser: true,
});
},
});
云开发 Web 端应用
具体请参考初始化 SDK
云函数中
具体请参考初始化 SDK
接口列表
ai_bot_get_bot_list
: 获取智能体列表接口ai_bot_get_bot_info
: 获取智能体详细信息接口ai_bot_send_msg
: 发送消息接口ai_bot_get_chat_history
: 获取对话历史接口ai_bot_get_recommend_questions
: 获取推荐问题接口ai_bot_add_bot
:添加智能体接口ai_bot_remove_bot
: 移除智能体接口ai_bot_ai_generate_bot
: 使用 AI 辅助生成智能体接口ai_bot_feedback
:对 AI 回答进行对话的反馈接口
具体调用方式在云模板详情中查看对应接口详情。
智能体管理
在云开发 AI 智能体管理平台上,您可以对智能体进行全面的管理和维护。以下是智能体管理的一些主要功能:
智能体配置和管理
- 智能体列表:查看您创建的所有智能体项目,包括已发布和未发布的状态。
- 智能体详情:查看和编辑智能体的基本信息,如名称、头像、简介等。
对话纪录管理
- 对话记录:查看智能体与用户的对话历史记录,包括时间、用户输入、智能体回复等信息。
- 搜索和筛选:根据关键词、时间范围等条件搜索和筛选对话记录。
错误码说明
AIBOT_SYS_ERR
: 系统内部异常AIBOT_SERVER_TIMEOUT
: 服务响应超时AIBOT_INVALID_PARAM
: 请求参数错误AIBOT_EXCEED_RATELIMIT
: 请求频率超过限制AIBOT_INVALID_OPERATION
: 操作非法AIBOT_PERMISSION_DENIED
: 无操作权限AIBOT_BOT_NOT_FOUND
: 未查询到智能体AIBOT_BOT_WX_FETCH_CHAT_HISTORY_FAIL
: 查询微信来源的历史会话失败AIBOT_BOT_MSG_SUB_FLOW_ERROR
: 执行消息处理子流程失败AIBOT_BOT_UPDATE_HISTORY
: 写入聊天记录失败
AI智能体使用须知
小程序发布要求
在发布AI智能体到小程序时,微信将在代码审核阶段核实小程序运营的内容与所选类目是否相符。AI问答涉及深度合成技术,需补充【深度合成-AI问答】服务类目。
目前,个人主体小程序尚未开放深度合成相关服务类目,建议申请企业主体类型小程序。
对于个人客户,考虑到类目限制,建议使用H5或公众号(订阅号/服务号均可)等其他方式实现AI智能体的功能。
小程序申请深度合成-AI问答类目指引
登录微信公众平台
请访问微信公众平台,进入小程序的设置->基本设置页面。
申请深度合成-AI问答类目
在申请类目处,选择【深度合成-AI问答】类目。该类目适用于提供文本深度合成技术(如:AI问答)等相关服务。在申请过程中,请选择使用第三方技术,并提供相应的证明材料。
证明材料获取
证明材料可在微信云模版中的“我的应用”->“AI智能体”->“AI算法备案材料”处获取,并将备案材料中的算法资质和使用凭证截图上传至小程序类目资质审核。
注意
请仔细阅读和参考以下说明来准备材料,避免审核不通过
- 截图需要完整:请确保截图包含以下元素:
- 包含完整的桌面截图,例如露出微信开发者工具、微信云模板的窗口等关键信息,可参考以下的截图参考图的效果
- 必须要有小程序的 AppId 和主体信息、以及算法相关的资质信息,服务有效期等
- 主体名称准确:小程序主体的企业名称和 AppId 需要准确无误
- 服务有效期大于 30 天:相关类目审核时会检查服务的有效期是否大于 30 天,请确保云开发的套餐剩余有效期大于 30 天
截图参考图
审核及使用
审核通过后,您的企业主体小程序将可以使用深度合成-AI问答类目。请确保在开发过程中遵循微信小程序的相关规定和要求。
常见问题
导入小程序后遇到报错
请确保微信开发者工具的基础库设置高于 2.17.0,例如 3.4.4
云开发的智能体平台智能化怎么体现
- 大模型:采用大型预训练模型,提供强大的自然语言处理和理解能力。
- 知识库:整合各领域专业知识,为用户提供全面、准确的信息支持。
- RAG应用:结合检索和生成式预训练模型,实现高度智能化的问答和推荐功能。
如何查看接口服务的监控日志
监控和日志功能正在开发中,目前可以在云开发的工作流中查看调用的日志和监控。
小程序前端调用接口时为什么不需要传 OPENID
通过小程序前端调用接口时,接口中可以通过用户信息直接获取到 OPENID,不需要额外传递,另外也避免了越权访问的安全风险
如何打开指定的智能体页面
在打开智能体页面时,支持传入特定的 url 参数,例如
web 端传参数示例
https://{envId}.tcloudbaseapp.com/{appId}/production/mIOXHS1t/chat?bot=addca5a16644370f00e32d0c75ffe581
小程序传参数示例
wx.navigateTo({url: "/$weda_root/packages/mIOXHS1t/pages/chat/index?bot=addca5a16644370f00e32d0c75ffe581"});
参数说明
bot
: 智能体的_id,可以在智能体管理后台中编辑智能体详情时查看 url 参数或者通过接口来查询showMenu
: 是否显示智能体列表菜单,0 代表不显示,1 代表显示showDrawer
: 显示智能体列表,0 代表不显示, 1 代表显示列表页面
更新日志
[0.3.0] - 2024-06-05
- 新增智能体发布到微信客服
- 智能体后台支持 AI 生成智能体头像
- 提升智能体设定内容长度:
[0.2.5] - 2024-05-29
- 修复自动滚动和中文输入判定问题
- 更新微信小程序审核类目指引
[0.2.4] - 2024-05-27
- Ai对话体验改进:AI 对话问题支持复制,增加输入状态,优化对话体验
[0.2.0] - 2024-05-24
- 新增子智能体发布功能:允许用户创建并发布子智能体至多渠道。
- 新增对话反馈功能:新增用户反馈机制,以改进 AI 服务。
- 优化发布到公众号体验:未认证公众号优先同步回复。
- 小程序体验改进:优化体积,加快加载速度,优化中文输入法支持,优化页面层级和滚动效果
[0.1.4] - 2024-05-10
- AI 智能体初版功能发布