工具管理
添加工具集后,支持将工具集中包含的工具(API)按需添加到列表中,便于大模型调用。
SuperMap iPortal AI助理的管理员支持管理所有工具,添加新的工具,以及控制工具的启停。
添加工具
以管理员身份登录AI助理,点击按钮进入工作台,依次点击“工具管理”>“工具”>“新增工具”,依次完成工具信息填写和参数配置:
- 工具信息填写
- 选择工具集:选择创建工具所属的工具集;
- 工具名称:填写工具名称;
- 工具别名:填写工具别名;
- 请求方式:选择 API 的请求方式,支持GET、PUT、POST、DELETE;
- 请求路径:基于工具集URL路径前缀,补全工具的API请求路径;
- 工具描述:填写工具的描述,建议输入工具的主要功能和使用场景,帮助大模型更好的理解;
- 是否为管理员工具:如设置为管理员工具,则仅管理员账户使用时支持调用,非管理员用户无法调用。
- 参数配置
支持在添加工具时添加多个参数,也可在添加工具后进行配置:
- 参数名称:填写参数名称,支持字母、数字或下划线;
- 参数类型:参数的数据类型,int、string、float、double等,支持自定义参数类型;
- 参数描述:参数描述,准确的参数描述可以帮助用户或大模型理解当前参数的作用;
- 是否必须:参数是为必填参数;
- 参数枚举值:设置参数的枚举值
- 默认值:设置参数的默认值;
- 是否为文件:
填写完成后,点击“完成”按钮即可。
管理工具
查看工具
在工具管理页面,以列表形式展示工具内容。支持查看工具名称、工具别名、工具集类型、请求路径、请求方式等信息。
检索工具
在工具管理页面,支持通过工具集名称、是否启用两种条件过滤工具,也可以在搜索框中直接输入工具名称、工具请求路径或工具描述进行检索。
启用/停用工具
在工具管理页面,管理员可选择是否启用工具,停用工具将导致工具无法调用。
修改工具
在工具管理页面,点击对应工具条目后的“修改”按钮,可在对话框中对工具集的名称、描述、地址等信息进行修改。
删除工具
在工具管理页面,可将不需要的工具删除,支持逐个删除与批量删除。
管理参数
在工具管理页面,点击工具条目最左侧的按钮,即可在展开的嵌套列表中查看该工具的参数信息,完成参数的新增、修改或删除。