SuperAPI AI 工具集

platform-assistant

智能体与模型

查看项目

更新于 10-16 01:31

技能介绍

用途:导航 Anypoint Platform 开发者门户,发现可用 API、agent skills 和扩展 schema,并执行门户中定义的 agent 工作流。门户是所有公开 API 规范与可执行工作流的唯一来源,其 URL 由文件顶部注入的 agent 上下文前言给出。

主要能力:门户提供三个机器可读发现文件。llms.txt 是一页式清单,含 AGENTS.md、registry.json 链接、x-origin 与 JTBD 扩展 schema 引用,以及每个公开 API 和 agent skill 的一句话说明。AGENTS.md 是面向 AI agent 的完整操作手册,涵盖站点结构、registry 格式、URN 解析规则、API 规范约定、x-origin、skill 格式与常见工作流。registry.json 是扁平 JSON 数组索引,每条含 $id、kind(oas、agent-skill、json-schema、schema-doc)、slug、name、description、href、docs,skill 还带 apis 数组。

使用方式:所有门户文件均为纯文本源文档(YAML、JSON、Markdown),须用原始 HTTP 工具(curl、直接 GET)获取,不要用摘要或浏览器渲染工具,以免截断结构化内容。按需单独抓取:registry.json、/apis/{slug}/api.yaml、/skills/{slug}/SKILL.md、/AGENTS.md。URN 解析规则:urn:api:{slug} 对应 /apis/{slug}/api.yaml,urn:skill:{slug} 对应 /skills/{slug}/SKILL.md,urn:schema:x-origin 对应 /schemas/x-origin.schema.json。参数带 x-origin 时,先读取其数组,解析来源 API URN,按 operationId 调用对应操作,再用 values 的 JSONPath 提取有效值,labels 可选用于显示名称。Skill 的 SKILL.md 含 YAML frontmatter 与编号步骤,每步给出 api、operationId、inputs、outputs;输入类型有 from.api+from.operation+from.field、from.variable、value、userProvided 四种,输出可在步骤间通过 from.variable 串联。

适用场景:需要引导式发现 Anypoint Platform API、需要按 skill 执行多步操作(如应用策略、配置扫描器)时使用。

限制:需网络访问、Anypoint Platform 凭据(Bearer token 或 OAuth2 客户端凭据)以及直接解析 YAML/JSON/Markdown 的能力;门户 URL、具体可用 API 与 skill 清单暂未在本资料中提供。