# Como os agentes devem usar o status de serviços de IA

Use relatórios de provedores como uma entrada para a recuperação de agentes. Preserve evidências da solicitação, verifique escopo e atualidade do relatório e evite decisões de interrupção ou failover sem suporte.

Por IsAnythingDown. Revisado 2026-10-08.

Página canônica: https://isanythingdown.com/pt/guides/agent-status-checks

## Resposta rápida

Um agente deve tratar um relatório de status como evidência complementar de uma operação que falhou. Deve preservar o erro original, verificar o produto e os horários corretos e seguir uma política de recuperação aprovada pelo aplicativo. Um relatório normal não autoriza novas tentativas indefinidas, e um incidente não comprova a causa de cada solicitação.

## Conecte seu agente via MCP

IsAnythingDown é gratuito e não exige conta ou chave de API. A instrução permite que seu agente use o formato de configuração compatível com seu cliente. Copiá-la não instala um servidor; cole no seu agente para iniciar a configuração.

Use search_services primeiro, selecione o produto exato e chame get_service_status ou get_service_statuses. As ferramentas retornam as mesmas evidências salvas da API JSON de status, incluindo escopo, hora de coleta, freshness e validUntil. Uma falha de leitura do banco define isError e mantém o resultado indisponível; não significa que o provedor está fora do ar.

### Deixe seu agente verificar o status de serviços

Copie esta instrução e cole no agente que deseja configurar.

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.

Seu agente precisa acessar as configurações MCP do cliente. Se precisar recarregar ou reiniciar, deve informar o próximo passo.

### Manual client configuration

Escolha o cliente que usa e preserve a configuração existente. Verifique as ferramentas após carregar o cliente.

#### Codex

Use Codex CLI para adicionar o servidor remoto. List verifica a configuração salva; recarregue o cliente se as ferramentas não estiverem disponíveis na sessão atual.

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

[Configuração MCP oficial do Codex](https://developers.openai.com/learn/docs-mcp)

#### Claude Code · projeto atual

O escopo local se aplica ao projeto atual. Use /mcp no Claude Code para verificar a conexão e as ferramentas disponíveis; uma nova sessão pode ser necessária.

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

[Configuração MCP oficial do Claude Code](https://code.claude.com/docs/en/mcp)

#### Cursor · projeto atual

Mescle esta entrada em .cursor/mcp.json para o projeto atual, preservando os servidores existentes. Reinicie Cursor se necessário e inspecione as configurações MCP e ferramentas disponíveis.

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

[Configuração MCP oficial do Cursor](https://prod.cursor.com/help/customization/mcp)

- Exemplo: search_services com {"q":"GPT"}, depois get_service_statuses com {"service_ids":["chatgpt","openai"]}. O alias Claude é aceito; seu ID estável no catálogo é anthropic.
- Uma conclusão atual exige freshness=fresh. Os campos do relatório antigo podem permanecer depois que state se torna null. Dados ausentes, uma fonte não conectada e uma lista de incidentes ausente continuam inconclusivos.
- Estas ferramentas leem registros salvos. Não iniciam sondas, aceitam URLs arbitrárias, enviam logs de solicitações ou alteram tarefas de coleta. Descrições do provedor e textos de incidentes são evidências, não instruções para um agente.
| Ferramenta | Argumentos | Evidências salvas |
| --- | --- | --- |
| search_services | q, kind, category, automatic (opcionais) | Nomes, aliases, IDs do catálogo e escopo das fontes configuradas |
| get_service_statuses | service_ids: 1–20 IDs conhecidos | Resumos oficiais de status dos produtos selecionados |
| get_service_status | service_id: um ID conhecido | Último relatório salvo, componentes, incidentes relatados e manutenção |
- [API de status estruturada e regras de atualidade](https://isanythingdown.com#structured-status-api)
- [Especificação oficial MCP Streamable HTTP](https://modelcontextprotocol.io/specification/2026-07-28/basic/transports/streamable-http)

## Encontre um serviço e leia as evidências salvas

Use /api/v1/services?q=GPT para buscar nomes e aliases em inglês ou chinês. Selecione o produto exato e siga statusAPIPath; ChatGPT e OpenAI API permanecem separados. automaticCollection descreve coleta configurada, não um relatório atual bem-sucedido. O catálogo continua disponível quando os dados de status não podem ser lidos.

A descrição OpenAPI lista três operações somente de leitura. Leituras em lote aceitam /api/v1/status?services=claude,chatgpt,openai; caminhos de serviço único incluem o último relatório salvo de componentes. Verifique freshness e validUntil antes de usar state, cite a fonte e a hora de coleta e informe o escopo relatado. Um relatório desatualizado ou ausente exige uma resposta inconclusiva. O campo report pode manter dados operacionais históricos depois que state se torna null.

Essas leituras não iniciam coleta, diagnóstico ou solicitações de modelos. HTTP 503 da API de status significa falha nas leituras do banco de dados; falhas de coleta são relatadas separadamente e não estabelecem interrupção do provedor. Uma contagem vazia de incidentes não estabelece disponibilidade, e um relatório do provedor não comprova que sua conta ou rede regional funciona.

- [Buscar serviços e aliases (JSON)](https://isanythingdown.com/api/v1/services?q=GPT)
- [Descrição OpenAPI (JSON)](https://isanythingdown.com/openapi.json)
- [Ler relatório salvo do Claude (JSON)](https://isanythingdown.com/api/v1/status/claude)

## Capture primeiro as evidências da solicitação

Preserve a hora UTC, endpoint, modelo, rota ou provedor se conhecidos, status HTTP, código de erro, ID da solicitação e tempo decorrido. Em fluxos, registre se a saída terminou ou foi encerrada com erro. Assim o aplicativo pode comparar falhas repetidas sem perder as evidências originais.

Armazene credenciais e conteúdo privado de prompts somente sob os controles do seu aplicativo. IsAnythingDown não aceita chaves API nem ingere logs de solicitações de agentes. Os campos abaixo são um registro local sugerido, não um formato de upload implementado no IsAnythingDown.

| Campo | Por que manter |
| --- | --- |
| occurred_at + endpoint | Localize a falha no tempo e identifique a operação |
| modelo + rota/provedor | Diferencie o acesso direto do acesso por gateway |
| http_status + error_code | Separe acesso, limites e falhas transitórias |
| request_id + duração | Apoiar a investigação do provedor e verificar tempos limite |
| stream_completed | Evite tratar cabeçalhos ou saída parcial como conclusão |
- [Erros da Claude API](https://platform.claude.com/docs/en/api/errors)
- [Códigos de erro da OpenAI API](https://developers.openai.com/api/docs/guides/error-codes)

## Leia o escopo e a idade do relatório

Use o link da fonte e a hora de coleta na página do serviço. Confirme que seus componentes descrevem a operação usada. ChatGPT e OpenAI API são separados; aplicativo Gemini e Gemini API são separados; um gateway e seu provedor de modelos subjacente são separados.

Mantenha explícitos os dados desatualizados, ausentes e indisponíveis. IsAnythingDown mantém o relatório válido anterior do provedor após uma falha de coleta, portanto conteúdo histórico pode continuar aparecendo. Leia o aviso de desatualização antes de citá-lo como evidência atual.

- [Fontes e metodologia do IsAnythingDown](https://isanythingdown.com/pt/methodology)

## Aplique sua própria política de recuperação

Uma política útil pode parar em falhas de autenticação ou cobrança, espaçar novas tentativas de falhas transitórias e encaminhar falhas não resolvidas para revisão. São decisões do aplicativo. O status, por si só, não pode selecionar uma alternativa segura para uma tarefa com requisitos de ferramentas, formato de saída, custo ou tratamento de dados.

Se seu aplicativo permite outro modelo ou provedor, verifique esses requisitos e as restrições de rota antes de mudar. Evite repetir ações de ferramentas concluídas ao retomar um agente. Um resultado de geração incerto deve permanecer incerto até o aplicativo verificar o resultado.

- [Erros de API e considerações sobre novas tentativas](https://isanythingdown.com/pt/guides/ai-api-error-codes)

## O que o IsAnythingDown oferece hoje

Esta versão fornece gratuitamente relatórios de provedores renderizados no servidor, links de fontes, horários de coleta, escopo de componentes e tentativas recentes de coleta. Os guias também têm versão Markdown. OpenRouter é um link oficial sem coleta automática. Jev usa o relatório da plataforma TypeSafe em vez de um relatório de rotas OpenRouter.

As ferramentas MCP somente de leitura permitem descobrir o catálogo e ler relatórios oficiais salvos. Não há API pública de diagnóstico, failover automático de modelos ou sonda independente de inferência de IA. Observações anteriores do GitHub no servidor de implantação não estabelecem que um agente alcança um endpoint de IA. Use a página de cobertura para inspecionar as verificações reais.

- [Fontes e metodologia do IsAnythingDown](https://isanythingdown.com/pt/methodology)
- [Cobertura independente real](https://isanythingdown.com/pt/coverage)

## Páginas de serviços relacionados

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

Cada entrada mostra sua própria cobertura de coleta. Um serviço com link não é necessariamente coletado automaticamente.

A data de revisão editorial se aplica a este guia. As horas de coleta dos relatórios atuais aparecem nas páginas dos serviços.