更新时间:2024-10-16 GMT+08:00
分享

配置AI助手工具

各种功能的API经封装后,将形成一个个工具,AI助手通过大模型来调用不同的工具,实现相应的功能。在创建AI助手前,需要将使用的功能封装为工具。

  1. 登录盘古大模型套件平台。
  2. 在左侧导航栏中选择“应用开发 > 工具管理”,单击页面右上角“创建工具”。
    图1 工具管理
  3. 在“创建工具”页面参考表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 创建工具
  4. 参数填写完成后,单击“确定”。

相关文档