• LOGS
  • PAYLOAD
  • FIX
  • HUMAN

Como depurar erros de API de LLM com seu AI

Conecte o Keywords AI ao seu editor uma única vez. Depois disso, seu agente assume o trabalho pesado de localizar requisições falhas e inspecionar payloads.

Pergunte à IA sobre esta página

Resposta rápida

Como posso depurar erros de API de LLM sem sair do editor?

Seu agente utiliza o Keywords AI para buscar logs de requisições recentes e extrair os detalhes completos de chamadas específicas que falharam. Você recebe uma análise direta do motivo da falha sem precisar trocar de aba para abrir um dashboard. Isso permite corrigir problemas de prompt ou divergências de payload imediatamente.

Onde cada problema é tratado.

Resultados da depuração

O agente organiza sua investigação nestas áreas específicas.

LOGS

Identificar chamadas falhas

O agente usa list_requests para encontrar os timestamps e IDs exatos dos erros. Você recebe uma lista limpa do que deu errado.

PAYLOAD

Inspecionar detalhes da requisição

O agente extrai o input e o output específicos via get_request. Você vê exatamente o que o modelo recebeu e enviou.

FIX

Identificar causas raiz

O agente compara a mensagem de erro com o payload. Ele aponta se o problema é um JSON malformado ou um timeout do modelo.

HUMAN

Alterações manuais de código

O agente identifica o erro, mas você deve aplicar a correção no seu código local. Ele não altera seus arquivos de origem.

O fluxo

O que seu AI faz quando ocorre um erro.

Em vez de você vasculhar logs, seu agente realiza a investigação.

  1. Encontrar o erro

    O agente varre seu histórico recente para localizar as chamadas falhas que você solicitou.

    list_requests

  2. Extrair os dados

    Assim que encontra o ID correto, o agente captura o corpo completo da requisição e da resposta.

    get_request

  3. Analisar a falha

    O agente analisa códigos de status e strings de erro para determinar se a API rejeitou o prompt ou se houve timeout.

    get_request

  4. Sugerir uma correção

    O agente fornece uma explicação clara do erro e sugere como ajustar seu prompt ou parâmetros.

    list_requestsget_request

Teste

Copie estes comandos para começar.

Use estes prompts para iniciar uma investigação.

Pontos de partida

Estes são exemplos iniciais. Substitua os tipos de erro ou períodos de tempo para combinar com sua situação atual.

Keywords AI Connector

Tudo pronto. Escolha seu cliente MCP e siga as instruções de configuração.

Link do conectorhttps://edge.vinkius.com/vk_preview_R4VkEIrwLVvP7dLw0Fdy9vfjO7WqxWYeI2hDwlBU/mcp

Claude Desktop

Siga os passos abaixo para conectar em segundos.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Keywords AI capabilities are ready to use.
Configuração · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "keywords-ai-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_R4VkEIrwLVvP7dLw0Fdy9vfjO7WqxWYeI2hDwlBU/mcp"
    }
  }
}
Copie no chat04

  • Liste minhas últimas 10 requisições do Keywords AI e me diga quais falharam.

  • Pegue os detalhes da requisição com ID req_12345 e explique o erro.

  • Analise minhas requisições falhas recentes e me diga se há um padrão nas mensagens de erro.

  • Verifique a requisição mais recente ao endpoint de completion e me diga por que ela retornou um erro 400.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Comece aqui

Conecte o Keywords AI uma vez e pronto.

Basta clicar no link para conectar sua conta. Suas credenciais permanecem criptografadas e seguras. Uma vez conectado, seu agente pode começar a buscar logs imediatamente.

Conectar Keywords AI ao seu AI

FAQ

Como funciona esta tarefa

  • 01

    O AI pode consertar meu código automaticamente?

    Não. O agente identifica o erro e sugere a correção, mas você precisa fazer as alterações reais no seu editor.

  • 02

    O AI pode deletar logs antigos?

    Não. As ferramentas permitem apenas que o agente liste e obtenha dados de requisição. Ele não pode deletar ou modificar nada no Keywords AI.

  • 03

    Como o agente encontra o erro correto?

    Ele usa a ferramenta list_requests para varrer seu histórico e depois usa get_request para extrair os dados específicos do erro encontrado.

  • 04

    Isso funciona com qualquer LLM?

    Funciona com qualquer cliente compatível com MCP, como Claude, Cursor ou Windsurf, independentemente do modelo que você estiver rodando.

  • 05

    O agente consegue ver minhas chaves de API?

    Não. O agente vê apenas os dados de requisição e resposta fornecidos pelas ferramentas. Ele não tem acesso às suas chaves secretas.

  • Mais dúvidas sobre o Keywords AI? A página do Connector responde. Veja tudo o que o Keywords AI Connector pode fazer

Conecte Keywords AI ao Claude, Cursor, ChatGPT e outros