创建方式

• 登录星辰MaaS智能体平台。

• 点击工具页面中右侧的创建工具按钮，点击OPENAPI Schema工具。

• 输入工具配置信息进行工具创建，完成创建的工具支持在应用中使用。

• 工具名称：用户可自定义工具名称。

• Schema：

  • 支持 OpenAPI / Swagger 规范。你可以将 OpenAPI schema 内容直接粘贴或从 URL 内导入。

  • 工具目前支持两种鉴权方式：无鉴权 和 API Key。

• 工具列表：

  • 在导入 Schema 内容后系统会主动解析文件内的参数，并可预览工具具体的参数、 方法、路径。您也可以在此对工具参数进行测试。

    

创建示例

1. 部分服务商会直接提供

   • 需要仔细查看一下对方的文档, 关键字为 OpenAPI Schema或OpenAPI YAML:

     

   • 如果没有, 可以使用大模型来生成对应的OpenAPI YAML文件:

     

   • 将文档内容保存下来, 发送给大模型, 示例:

     • 天气查询-高级 API 文档-开发指南-Web服务 API | 高德地图API

     • 从图中可见, 文档内容排版混乱, 对于大模型不友好 需要手工修改。

       

     • 手工修改后：

       • 天气查询API服务地址

       • URL	请求方式
         https://restapi.amap.com/v3/weather/weatherInfo?parameters	GET

     • parameters 代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。

       • 请求参数

       • 参数名	含义	规则说明	是否必须	缺省值
         key	请求服务权限标识	用户在高德地图官网 申请 web 服务 API 类型 KEY。	必填	-
         city	城市编码	输入城市的 adcode，adcode 信息可参考 城市编码表。	必填	-
         extensions	气象类型	可选值：base/allbase:返回实况天气all:返回预报天气。	可选	-
         output	返回格式	可选值：JSON,XML。	可选	JSON

     • 返回结果参数说明

       • 实况天气每小时更新多次，预报天气每天更新3次，分别在8、11、18点左右更新。由于天气数据的特殊性以及数据更新的持续性，无法确定精确的更新时间，请以接口返回数据的reporttime 字段为准。

   • 使用大模型生成YAML配置文件

     • 将文档内容发送至大模型, Prompt为: 请根据这个API说明文档, 生成OPENAPI YAML配置文件:

       

     • 大模型返回:

       

   • 使用大模型生成YAML配置文件

     • 导入 Schema 内容，系统会主动解析文件内的参数，并可预览工具具体的参数、 方法、路径。您也可以在此对工具参数进行测试。

       

     • 输入后会出现测试按钮:

       

     • 点击测试按钮, 输入必要信息, 查看返回结果:

       

     • 测试通过后点击保存按钮, 新的工具会出现在”自定义”栏中。