配置AI助手工具
各种功能的API经封装后,将形成一个个工具,AI助手通过大模型来调用不同的工具,实现相应的功能。在创建AI助手前,需要将使用的功能封装为工具。
- 登录盘古大模型套件平台。
- 在左侧导航栏中选择“应用开发 > 工具管理”,单击页面右上角“创建工具”。
图1 工具管理
- 在“创建工具”页面参考表1完成工具代码的设置。
表1 创建工具参数说明 参数
是否必选
参数类型
描述
tool_id
是
String
工具ID,必须由英文小写字母和_组成,需要符合实际工具含义。
tool_desc
是
String
工具的描述,尽可能的准确简短描述工具的用途。
说明:该描述直接影响大模型对工具使用的判断,请尽量描述清楚。如果AI助手实际执行时,无法根据用户问题匹配到工具,或者匹配效果不理想,可以修改此描述。
input_schema
是
Json Schema
工具输入参数。将API封装为工具时,调用该API的请求参数。请求体以json schema的形式进行描述,参数说明请参考官方指导。
output_schema
是
Json Schema
工具输出参数。将API封装为工具时,调用该API的响应参数。请求体以json schema的形式进行描述,参数说明请参考官方指导。
metadata
是
Object metadata
扩展字段 。
表2 metadata参数说明 参数
是否必选
参数类型
描述
url
是
String
assistant api调用地址。
authType
是
String
用于指定身份验证的类型,默认值“OAuth”,使用OAuth协议进行身份验证。
代码示例:
{ "tool_id": "reserve_meeting_room", "tool_desc": "预定会议室,请在需要预定会议室时调用此工具,预定前需要先查询会议室状态", "input_schema": { "type": "object", "properties": { "start": { "type": "string", "description": "会议开始时间,格式为yyyy-MM-dd HH:mm" }, "end": { "type": "string", "description": "会议结束时间,格式为yyyy-MM-dd HH:mm" }, "meetingRoom": { "type": "string", "description": "会议室" } }, "required": [ "start", "end", "meetingRoom" ] }, "output_schema": { "type": "object", "properties": { "result": { "type": "string", "description": "预定会议室的结果" } } }, "metadata": { "url": "https://host/v1/api", "authType": "OAuth" } }
图2 创建工具 - 参数填写完成后,单击“确定”。