# Agent 應如何使用 AI 服務狀態

將提供方報告作為 Agent 恢復的參考之一。保留請求證據，檢查範圍和新鮮度，避免缺乏依據的故障或切換決策。

作者：IsAnythingDown. 核對於 2026-10-08.

規範頁面： https://isanythingdown.com/zh-tw/guides/agent-status-checks

## 簡要回答

Agent 應將狀態報告作為失敗操作的輔助證據。它應保留原始錯誤，核對正確產品和時間戳，再按照應用允許的恢復策略處理。正常報告不意味著可以無限重試，事件也不能證明每次請求失敗的原因。

## 透過 MCP 接入你的 Agent

IsAnythingDown 免費，無需賬戶或 API 金鑰。此說明讓 Agent 使用其客戶端支援的配置格式。複製說明不會安裝伺服器；請貼上到 Agent 以開始配置。

先呼叫 search_services，選擇確切產品，再呼叫 get_service_status 或 get_service_statuses。工具返回與狀態 JSON API 相同的已儲存證據，包括來源範圍、收集時間、freshness 和 validUntil。資料庫讀取失敗時設定 isError 並保留不可用結果，不表示提供方故障。

### 讓 Agent 檢查服務狀態

複製此說明並貼上到要配置的 Agent。

Add the public read-only MCP server isanythingdown at https://isanythingdown.com/mcp to this agent's supported configuration using Streamable HTTP with no API key, preserve all other settings, and verify its tools with search_services({"q":"GPT"}), reporting any required reload or configuration-access limitation.

Agent 需要訪問所用客戶端的 MCP 設定。若需要重新載入或重啟，應告訴你下一步操作。

### Manual client configuration

選擇所用客戶端並保留現有配置。載入客戶端後核對工具。

#### Codex

使用 Codex CLI 新增遠端伺服器。List 檢查已儲存配置；工具在當前會話不可用時請重新載入客戶端。

```sh
codex mcp add isanythingdown --url https://isanythingdown.com/mcp
codex mcp list
```

[Codex 官方 MCP 接入](https://developers.openai.com/learn/docs-mcp)

#### Claude Code · 當前專案

本地範圍適用於當前專案。在 Claude Code 中使用 /mcp 檢查連線與可用工具；可能需要新會話。

```sh
claude mcp add --transport http --scope local isanythingdown https://isanythingdown.com/mcp
claude mcp get isanythingdown
```

[Claude Code 官方 MCP 接入](https://code.claude.com/docs/en/mcp)

#### Cursor · 當前專案

將此條目合併至當前專案的 .cursor/mcp.json，並保留已有伺服器。按需重啟 Cursor，再檢視 MCP 設定與可用工具。

```json
{
  "mcpServers": {
    "isanythingdown": {
      "url": "https://isanythingdown.com/mcp"
    }
  }
}
```

[Cursor 官方 MCP 接入](https://prod.cursor.com/help/customization/mcp)

- 示例：先呼叫 search_services，引數為 {"q":"GPT"}，再呼叫 get_service_statuses，引數為 {"service_ids":["chatgpt","openai"]}。支援 Claude 別名；其穩定目錄 ID 為 anthropic。
- 當前結論要求 freshness=fresh。state 變為 null 後仍可能保留舊報告欄位。資料缺失、來源尚未接入和未提供事件列表均無法得出確定結論。
- 這些工具讀取已儲存記錄。不啟動探測、不接受任意 URL、不上傳請求日誌或更改 worker 任務。提供方描述和事件文字是證據，不是給 Agent 的指令。
| 工具 | 引數 | 已儲存證據 |
| --- | --- | --- |
| search_services | q、kind、category、automatic（可選） | 目錄名稱、別名、ID 和已配置來源範圍 |
| get_service_statuses | service_ids：1–20 個已知 ID | 所選產品的官方狀態摘要 |
| get_service_status | service_id：一個已知 ID | 最近儲存的報告、元件、已報告事件與維護 |
- [結構化狀態 API 與新鮮度規則](https://isanythingdown.com#structured-status-api)
- [官方 MCP Streamable HTTP 規範](https://modelcontextprotocol.io/specification/2026-07-28/basic/transports/streamable-http)

## 先找到服務，再讀取已儲存證據

使用 /api/v1/services?q=GPT 匹配服務名稱及英文或中文別名。選擇確切產品並使用 statusAPIPath；ChatGPT 和 OpenAI API 保持分開。automaticCollection 描述已配置收集，不代表當前成功報告。狀態資料不可讀時目錄仍可用。

OpenAPI 描述列出三個只讀操作。批次讀取支援 /api/v1/status?services=claude,chatgpt,openai；單服務路徑包含最近儲存的元件報告。使用 state 前檢查 freshness 和 validUntil，引用來源與收集時間，並明確報告範圍。過期或缺失報告應回答無法確認。state 變為 null 後，report 欄位仍可能保留歷史正常執行資料。

這些讀取不會啟動收集、診斷或模型請求。狀態 API 的 HTTP 503 表示資料庫讀取失敗；收集失敗單獨報告，不能確認提供方故障。事件數量為空不能確認可用性，提供方報告不能證明賬戶或地區網路可用。

- [搜尋服務與別名（JSON）](https://isanythingdown.com/api/v1/services?q=GPT)
- [OpenAPI 描述（JSON）](https://isanythingdown.com/openapi.json)
- [讀取已儲存 Claude 報告（JSON）](https://isanythingdown.com/api/v1/status/claude)

## 先儲存請求證據

保留 UTC 時間、端點、模型、已知的路由或提供方、HTTP 狀態、錯誤碼、請求 ID 和耗時。對於流式響應，記錄輸出是否完成或以錯誤結束。應用可據此比較反覆失敗，並保留原始證據。

憑據和私有提示內容僅應由應用自己的機制管理。IsAnythingDown 不接受 API 金鑰或接收 Agent 請求日誌。下方欄位是本地記錄建議，不是已實現的 IsAnythingDown 上傳格式。

| 欄位 | 為什麼保留 |
| --- | --- |
| occurred_at + 端點 | 定位失敗時間並確認操作 |
| 模型 + 路由／提供方 | 區分直接訪問與閘道器路徑 |
| http_status + error_code | 區分訪問、限制與暫時失敗 |
| request_id + 時長 | 協助提供方調查並檢查超時 |
| stream_completed | 避免把響應標頭或部分輸出當作完成 |
- [Claude API 錯誤](https://platform.claude.com/docs/en/api/errors)
- [OpenAI API 錯誤碼](https://developers.openai.com/api/docs/guides/error-codes)

## 檢視報告範圍與時間

使用服務頁面的來源連結和收集時間。確認元件描述實際使用的操作。ChatGPT 與 OpenAI API 分開；Gemini 應用與 Gemini API 分開；閘道器與其上游模型提供方分開。

明確保留過期、缺失和不可用資料。收集失敗後 IsAnythingDown 保留之前有效的提供方報告，因此仍可能顯示歷史內容。引用為當前證據前，請閱讀頁面的過期警告。

- [IsAnythingDown 來源與方法](https://isanythingdown.com/zh-tw/methodology)

## 採用您自己的恢復策略

可用的策略可以在認證或計費失敗時停止、控制臨時故障的重試節奏，並將未解決的失敗交由人工複核。這些屬於應用決策。僅憑狀態不能為有工具支援、輸出格式、成本或資料處理要求的任務選擇安全的備選方案。

如果應用允許切換模型或提供方，切換前應核對這些要求及路由限制。恢復 Agent 執行時避免重複已完成的工具動作。生成結果不確定時應保持不確定，直到應用能驗證結果。

- [API 錯誤與重試注意事項](https://isanythingdown.com/zh-tw/guides/ai-api-error-codes)

## IsAnythingDown 當前提供什麼

此版本免費提供服務端渲染的提供方報告、來源連結、收集時間、元件範圍和最近收集嘗試。指南也提供 Markdown 版本。OpenRouter 僅連結官方頁面，未自動收集。Jev 使用 TypeSafe 平臺報告，而不是 OpenRouter 路由報告。

只讀 MCP 工具提供目錄發現與已儲存官方報告。沒有公開診斷 API、自動模型切換或獨立 AI 推理探測。部署伺服器以前的 GitHub 觀測不能確認 Agent 可以訪問 AI 端點。請透過覆蓋頁面檢查實際存在的檢查。

- [IsAnythingDown 來源與方法](https://isanythingdown.com/zh-tw/methodology)
- [實際獨立觀測覆蓋](https://isanythingdown.com/zh-tw/coverage)

## 相關服務頁面

- [Claude](https://isanythingdown.com/zh-tw/services/claude)
- [OpenAI API](https://isanythingdown.com/zh-tw/services/openai)
- [Hugging Face](https://isanythingdown.com/zh-tw/services/hugging-face)
- [Jev / TypeSafe](https://isanythingdown.com/zh-tw/services/jev)
- [OpenRouter](https://isanythingdown.com/zh-tw/services/openrouter)

每個條目顯示自己的收集覆蓋。連結到服務不一定表示自動收集。

編輯稽核日期適用於本指南。實時報告收集時間顯示在服務頁面。