skills - RestApiSkill 对接海量 WebAPI

RestApiSkill 是 Solon AI 提供的一个自动化工具，它能通过读取 Swagger/OpenAPI 文档，自动将标准的 REST 接口转换为 AI 智能体（Agent）可直接调用的“技能”。

此技能，可以很好的激活海量现有 WebApi

1、应用示例

通过以下代码，你可以让智能体具备操作你业务系统的能力：

// 1. 配置 Swagger 文档地址及接口根地址
String mockApiDocsUrl = "http://localhost:8080/swagger/v3/api-docs";
String apiBaseUrl = "http://localhost:8080";

ChatModel chatModel = LlmUtil.getChatModel();

// 2. 实例化 Skill 并配置
// schemaMode 用于指定协议解析模式，支持自适应解引用
RestApiSkill apiSkill = new RestApiSkill(mockApiDocsUrl, apiBaseUrl)
        .schemaMode(SchemaMode.V3_RESOLVED); 

// 3. 构建智能体（或者 ChatModel）并注入技能
SimpleAgent agent = SimpleAgent.of(chatModel)
        .role("业务助手")
        .instruction("你是一个业务助手，请利用提供的 API 接口为用户解决问题")
        .defaultSkillAdd(apiSkill)
        .build();

// 4. 自然语言触发接口调用
// Agent 会自动识别该意图对应 Swagger 中的哪个接口，并构造请求
String response = agent.prompt("查询 ID 为 123 的用户状态是什么？").call();

System.out.println(response);