swagger-petstore-openapi-3-0

Swagger Petstore 技能为 OpenAPI 3.0 规范提供了一套专门的、便于导航的文档结构。此技能专为 AI 代理设计，通过将庞大的 API 规格分解为细致、基于文件的层级结构，克服了标准上下文窗口的限制。它使代理能够高效地发现并执行与宠物管理、用户账户和商店交易相关的操作，而不会占用过多的工作空间内存。

此技能非常适合进行集成测试、模拟 API 验证或涉及 Petstore 环境的自动化数据编排的开发人员及代理。它支持标准的 OAuth2 和 API 密钥验证方案，确保能安全地与诸如宠物检索、用户创建和订单管理等端点进行交互。

• 全面支持 19 种不同操作，包括宠物、用户和商店库存的 CRUD 动作。

• 通过资源进行语义组织，允许代理按逻辑（宠物、用户、商店）浏览端点。

• 针对详细请求/响应验证的按需架构加载，确保代理驱动调用期间的数据完整性。

• 与 OpenAPI 3.0 架构及标准化验证流程（petstore_auth 和 api_key）原生兼容。

• 层级式目录结构，有助于复杂任务规划的逐步导航。

• 在深入了解特定操作细节之前，请先使用根索引查找相关资源。

• 应通过提供的参考文件管理验证令牌，以确保符合目标 API 的安全要求。

• 所有服务交互的基本 URL 配置为 /api/v3。

• 代理在构建复杂的请求负载之前，应验证 operations/ 子目录中的必要架构定义。

• 在处理区分大小写的文件系统环境时，若增加了自定义架构，请确保以适当的策略初始化技能。