Agent 可行動性說明（OpenAPI）
了解 OpenAPI 為什麼不只是 API 文件，而是決定 AI Agent 能不能從「讀懂頁面」走到「實際呼叫服務」的行動層能力。
OpenAPI 為什麼重要
成為AI生成回答的「資訊來源」
對 GEO Scorecard 而言，OpenAPI 不是只給工程師看的補充文件，而是網站是否有把服務能力、輸入輸出格式與高價值內容出口講清楚的能力訊號。
什麼是 OpenAPI 路徑
OpenAPI 是描述 HTTP API 的標準格式。它把 API 的版本、入口、路徑、參數、請求格式、回應格式、授權方式與共用資料模型整理成外部系統可直接解析的文件。
對這個評分面向來說，重點不只在文件內容，也在於它是否能被穩定找到。
/.well-known/openapi.json/openapi.json/swagger.json/openapi.yaml//openapi.yml/docs/openapi.json/api/openapi.json/v3/api-docs
當網站把文件放在這些常見入口時，搜尋系統、文件工具、整合平台與 AI 助理就更容易辨識：這個網站除了有內容頁，也有可被理解與使用的服務能力。
為什麼這會成為評分依據
如果 \`robots.txt\` 在講抓取邊界、\`sitemap.xml\` 在講內容盤點、Meta Tags 在講頁面摘要，那 OpenAPI 講的就是網站的能力邊界。
一份品質良好的 OpenAPI 至少應該回答這些問題：
- 這份 API 是什麼。
- 在哪裡可以呼叫。
- 有哪些操作與路徑。
- 輸入輸出長什麼樣子。
- 哪些能力需要授權。
對平台型網站的意義
它能把查詢、交易、預約、登入、訂單、報價等能力整理成可被整合的使用格式。
對一般網站的意義
它也能把 FAQ、活動、條款、隱私、價格與門市資訊整理成結構化內容出口。
官方規範與參考連結
下列來源可作為這個評分面向的外部依據。這些連結讓使用者理解：這不是主觀評論，而是建立在 OpenAPI Initiative 正式規範與 learn 文件上的整理。
OpenAPI Initiative 官方
- OpenAPI Initiative OpenAPI Specification latest
- OpenAPI Initiative OpenAPI Specification v3.2.0
- OpenAPI Initiative Structure of an OpenAPI Description
- OpenAPI Initiative API Endpoints
規範重點對應
- OpenAPI Initiative API Servers
- OpenAPI Initiative Parameters and Payload of an Operation
- OpenAPI Initiative Describing API Security
- OpenAPI Initiative Schema Object