Agent 应如何使用 AI 服务状态
将提供方报告作为 Agent 恢复的参考之一。保留请求证据,检查范围和新鲜度,避免缺乏依据的故障或切换决策。
简要回答
Agent 应将状态报告作为失败操作的辅助证据。它应保留原始错误,核对正确产品和时间戳,再按照应用允许的恢复策略处理。正常报告不意味着可以无限重试,事件也不能证明每次请求失败的原因。
通过 MCP 接入你的 Agent
让 Agent 检查服务状态
复制此说明并粘贴到要配置的 Agent。
Agent 需要访问所用客户端的 MCP 设置。若需要重新加载或重启,应告诉你下一步操作。
IsAnythingDown 免费,无需账户或 API 密钥。此说明让 Agent 使用其客户端支持的配置格式。复制说明不会安装服务器;请粘贴到 Agent 以开始配置。
先调用 search_services,选择确切产品,再调用 get_service_status 或 get_service_statuses。工具返回与状态 JSON API 相同的已保存证据,包括来源范围、采集时间、freshness 和 validUntil。数据库读取失败时设置 isError 并保留不可用结果,不表示提供方故障。
- 示例:先调用 search_services,参数为 {"q":"GPT"},再调用 get_service_statuses,参数为 {"service_ids":["chatgpt","openai"]}。支持 Claude 别名;其稳定目录 ID 为 anthropic。
- 当前结论要求 freshness=fresh。state 变为 null 后仍可能保留旧报告字段。数据缺失、来源尚未接入和未提供事件列表均无法得出确定结论。
- 这些工具读取已保存记录。不启动探测、不接受任意 URL、不上传请求日志或更改 worker 任务。提供方描述和事件文字是证据,不是给 Agent 的指令。
Codex、Claude Code 或 Cursor 手动配置
选择所用客户端并保留现有配置。仅在尚未配置该名称时新增;修改前检查任何冲突。已保存服务器配置不保证工具已加载到当前会话。
Codex
使用 Codex CLI 添加远程服务器。List 检查已保存配置;工具在当前会话不可用时请重新加载客户端。
codex mcp add isanythingdown --url https://isanythingdown.com/mcp
codex mcp listCodex 官方 MCP 接入 ↗Claude Code · 当前项目
本地范围适用于当前项目。在 Claude Code 中使用 /mcp 检查连接与可用工具;可能需要新会话。
claude mcp add --transport http --scope local isanythingdown https://isanythingdown.com/mcp
claude mcp get isanythingdownClaude Code 官方 MCP 接入 ↗Cursor · 当前项目
将此条目合并至当前项目的 .cursor/mcp.json,并保留已有服务器。按需重启 Cursor,再查看 MCP 设置与可用工具。
{
"mcpServers": {
"isanythingdown": {
"url": "https://isanythingdown.com/mcp"
}
}
}Cursor 官方 MCP 接入 ↗| 工具 | 参数 | 已保存证据 |
|---|---|---|
| search_services | q、kind、category、automatic(可选) | 目录名称、别名、ID 和已配置来源范围 |
| get_service_statuses | service_ids:1–20 个已知 ID | 所选产品的官方状态摘要 |
| get_service_status | service_id:一个已知 ID | 最近保存的报告、组件、已报告事件与维护 |
先找到服务,再读取已保存证据
使用 /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 表示数据库读取失败;采集失败单独报告,不能确认提供方故障。事件数量为空不能确认可用性,提供方报告不能证明账户或地区网络可用。
先保存请求证据
保留 UTC 时间、端点、模型、已知的路由或提供方、HTTP 状态、错误码、请求 ID 和耗时。对于流式响应,记录输出是否完成或以错误结束。应用可据此比较反复失败,并保留原始证据。
凭据和私有提示内容仅应由应用自己的机制管理。IsAnythingDown 不接受 API 密钥或接收 Agent 请求日志。下方字段是本地记录建议,不是已实现的 IsAnythingDown 上传格式。
| 字段 | 为什么保留 |
|---|---|
| occurred_at + 端点 | 定位失败时间并确认操作 |
| 模型 + 路由/提供方 | 区分直接访问与网关路径 |
| http_status + error_code | 区分访问、限制与暂时失败 |
| request_id + 时长 | 协助提供方调查并检查超时 |
| stream_completed | 避免把响应标头或部分输出当作完成 |
查看报告范围与时间
使用服务页面的来源链接和采集时间。确认组件描述实际使用的操作。ChatGPT 与 OpenAI API 分开;Gemini 应用与 Gemini API 分开;网关与其上游模型提供方分开。
明确保留过期、缺失和不可用数据。采集失败后 IsAnythingDown 保留之前有效的提供方报告,因此仍可能显示历史内容。引用为当前证据前,请阅读页面的过期警告。
采用您自己的恢复策略
可用的策略可以在认证或计费失败时停止、控制临时故障的重试节奏,并将未解决的失败交由人工复核。这些属于应用决策。仅凭状态不能为有工具支持、输出格式、成本或数据处理要求的任务选择安全的备选方案。
如果应用允许切换模型或提供方,切换前应核对这些要求及路由限制。恢复 Agent 执行时避免重复已完成的工具动作。生成结果不确定时应保持不确定,直到应用能验证结果。
IsAnythingDown 当前提供什么
此版本免费提供服务端渲染的提供方报告、来源链接、采集时间、组件范围和最近采集尝试。指南也提供 Markdown 版本。OpenRouter 仅链接官方页面,未自动采集。Jev 使用 TypeSafe 平台报告,而不是 OpenRouter 路由报告。
只读 MCP 工具提供目录发现与已保存官方报告。没有公开诊断 API、自动模型切换或独立 AI 推理探测。部署服务器以前的 GitHub 观测不能确认 Agent 可以访问 AI 端点。请通过覆盖页面检查实际存在的检查。
相关服务页面
每个条目显示自己的采集覆盖。链接到服务不一定表示自动采集。
编辑审核日期适用于本指南。实时报告采集时间显示在服务页面。