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/ 子目錄中的必要架構定義。

• 在處理區分大小寫的檔案系統環境時，若增加了自訂架構，請確保以適當的策略初始化技能。