Appearance
快速开始
登录成功进入主页,主页是一个默认的智能体聊天对话,可以与智能体进行对话
下面以创建一个实时查询中国各大城市当天及未来15天的天气情况的智能体为例,快速开启我们的 AI 应用之旅。
1. 创建插件
首先需要为智能体创建一个能获得实时天气的插件,操作流程为点击我的->插件->创建插件
点击“创建插件”按钮,弹出以下对话框
输入插件名称:天气查询,插件描述:实时查询中国各大城市的天气情况,插件技能创建方式选择:使用已有服务创建,插件 URL 输入: http://life.c.cloudtogo.cn,如果想更新插件图标,可以点击“ AI 生成”,完成后点击确定。
1.1 创建技能
点击刚才创建的天气查询插件进入技能列表页
点击创建技能按键
在创建技能页,填好以下参数后,点击保存
参数说明:
配置项 | 说明 |
---|---|
名称 | 为技能定义一个名称,可以是中文或者英文 |
URL | 即目标 API 的请求 path 以及请求方法,请求方法支持:GET、POST、PUT、DELETE、HEAD、OPTIONS、PATCH |
描述 | 对目标 API 的描述,包括 API 的功能说明,参数使用说明等 |
请求信息 | 可选值: 1.Body:请求体参数。 2.Path:路径参数。 3.Query:查询参数。 4.Headers:请求头参数。 5.Authorization: 认证参数。 认证参数支持的类型: -No Auth: 无需鉴权。 -API Key: api key 与 api value 键值对的方式,支持添加到 header 或者 query 参数中。 -Token:token key 与 token value 键值对的方式,支持添加到 header 或者 query、cookie 参数中。 -Basic Auth: 用户名与密码的鉴权方式。 -Cookie: Cookie 的鉴权方式,输入 Cookie 的键值对注意:在技能详情页配置的 Authorization 参数,仅相当于一个声明,在调试时需要配置实际的值才能调试通过,且在应用正式使用时需要通过鉴权功能做配置。 |
是否必填 | 参数是否必填。勾选表示当前参数为必填参数。未勾选表示当前参数为选填参数。 |
响应信息 | 可选值: 1.Headers: 响应头信息。 2.Body: 响应体信息。 3.Status: 状态码信息以上都为非必填参数,但推荐输入。 一是可以提高技能的可读性,二是当你对响应 body 有过滤需求时则必须输入,例如:如果返回 JSON 内容为{ "status": "success", "message": "数据获取成功", "data": { "id": 1, "name": "示例名称", "description": "这是一个示例描述", "created_at": "2024-09-02T18:43:00Z", "updated_at": "2024-09-02T18:43:00Z" }}而你只想接收 data 里的 name 和 description 字段时,则输入如下:{ "data": { "name": "示例名称", "description": "这是一个示例描述" }} |
1.2 调试技能
点击调试 tab 页,并输入 city 参数的值为深圳,然后点击发送按键,在响应信息 body 里可以看到请求成功并返回了相应的信息
1.3 导入技能
在技能列表页,点击导入技能
有三种导入方式:
通过 swagger JSON 链接导入
通过 swagger JSON 文件导入
通过 OpenApi YAML 文件导入
注意:技能必须调试通过且处于启用状态时才可以被使用
2. 创建应用绑定技能
点击左侧菜单的我的->应用
在应用列表页上点击创建应用按键
在创建应用对话框中输入应用名称为天气助手,输入应用描述:这是一个能实时查询中国境内各大城市的天气查询助手,然后点击“确定”
注意:对应用的描述越准确越有利于智能体识别这个应用的作用
在应用列表页点击刚才新建的天气助手应用进入编排页
在能力扩展下面的插件点击添加按键,弹出添加插件对话框
在添加插件对话框中选择之前创建的天气查询插件,展开选择下面的技能,点击“添加”
关闭添加插件对话框,在应用中看到已经添加的天气查询插件如下:
修改天气查询智能体下面的角色指令,可以参考截图进行修改
角色:需要清晰准确地描述这个智能体的人设
技能:描述这个智能体有多少个技能,例添加了一个天气查询的技能,则应当有相应的描述
要求与限制:用于描述你对输出结果,内容等要求
开场白:即为第一次进入聊天窗后的欢迎词
推荐问:即为第一次进入聊天窗后自动提示用户可以向智能体发送哪些问题,最好是设置成与应用相关的问题
追问:即为每次与智能体的对话结束后,智能体自动推荐给用户的下一步可以进行问题。当勾选了自定义 Prompt,则可以输入自定义追问要求
注意:每次修改后均会自动保存
3. 预览调试
完成上面的应用设置后,可以在编排页的最右侧栏对应用进行调试,调试的目的是检查智能体是否按你的预设进行工作,如果感觉对结果不满意可以在角色指令下微调指令以达到满意的效果。
4. 访问应用
完成应用的调试后,可以返回应用列表页,然后点击“访问”按钮则可进入此 AI 应用的聊天页
开始与智能体进行对话:
5. 发布应用
访问应用没有问题后,就可以将应用发布到应用商店供其他人访问。进入应用编排页,点击右上角的发布应用按键
在发布应用对话框上选好分类,输入发布记录后点击确定
发布完成后,可以点编排页上方的发布历史按键查看发布历史记录
在发布历史页可以选择一个发布历史后点还原历史版本按键,这将把应用商店中的应用还原到某个历史版本。
注意:还原历史版本只会影响应用商店中的应用,对我的->应用没有影响
6. 分享应用
应用发布成功后即可以分享给其他人使用了,在我的->应用或者进入应用商店,点击分享按键
提示复制链接成功后,即可把复制的内容分享给好友。当好友点击你分享内容里的链接后即可进入应用的聊天页
应用分享兼容手机效果: