• TRIAGEM
  • CAUSA RAIZ
  • STATUS
  • HUMANO

Como depurar falhas de subgraph com seu AI

Conecte o Goldsky ao seu agente para transformar erros de indexação em soluções práticas. Sua IA analisa os logs enquanto você foca no código.

Pergunte à IA sobre esta página

Resposta rápida

Por que meu subgraph está falhando?

Seu agente verifica o status do pipeline e extrai contagens de erros e logs de execução para encontrar a causa exata da falha. Isso ajuda a identificar se o problema é um erro de schema, um timeout de RPC ou uma falha de lógica no seu código de mapeamento.

Onde cada problema é resolvido.

Resultados da depuração

A IA categoriza as falhas nestes grupos específicos.

TRIAGEM

Identificar o tipo de falha

O agente usa a contagem de erros para determinar se o pipeline travou totalmente ou se está apenas com atraso. Você entende a escala do problema rapidamente.

CAUSA RAIZ

Localizar o erro exato

Ao analisar os logs de execução, seu agente encontra a linha ou o evento que causou a queda. Você evita buscas manuais exaustivas em milhares de linhas.

STATUS

Verificar a saúde do pipeline

O agente monitora o estado atual da sua indexação. Você saberá na hora se precisa reiniciar o processo ou fazer um novo deploy.

HUMANO

Correções manuais de código

A IA identifica o erro, mas você ainda precisa reescrever a lógica de mapeamento ou atualizar o schema. O agente fornece todo o contexto para você agir.

O fluxo

O que sua IA faz quando um pipeline falha.

Em vez de você procurar em dashboards, seu agente faz o trabalho pesado de buscar os dados.

  1. Verificar saúde

    O agente analisa o estado atual da indexação para ver se ela está ativa ou interrompida.

    get_pipeline_status

  2. Quantificar erros

    Ele extrai o número total de erros para saber se é um problema isolado ou uma falha total.

    get_pipeline_error_count

  3. Analisar logs

    O agente mergulha nos logs de execução para encontrar mensagens de erro específicas e stack traces.

    get_pipeline_logs

  4. Resumir causa

    Ele combina o status, a contagem de erros e os logs para dizer exatamente o que deu errado.

    get_pipeline_logs

Teste

Copie estes comandos para começar.

Use estes prompts para iniciar uma sessão de depuração.

Pontos de partida

Substitua os nomes dos pipelines pelos seus identificadores reais do Goldsky.

Goldsky Connector

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

Link do conectorhttps://edge.vinkius.com/vk_preview_vKwCn24rK9jiYRm7bJaactLmNUpPZSSNAnWrQ0l6/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 — Goldsky capabilities are ready to use.
Configuração · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "goldsky-web3-data-indexing-subgraphs-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_vKwCn24rK9jiYRm7bJaactLmNUpPZSSNAnWrQ0l6/mcp"
    }
  }
}
Copie no chat04

  • Verifique o status do meu pipeline 'main-subgraph-prod' e me diga se ele está rodando.

  • Quantos erros ocorreram no 'test-indexing-pipeline' na última hora?

  • Extraia os logs mais recentes do 'dev-subgraph-v2' e explique por que ele está falhando.

  • Analise a contagem de erros do 'production-indexer' e resuma os erros de log mais recentes.

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

Comece aqui

Conecte o Goldsky uma vez e pronto.

Uma única conexão dá ao seu agente acesso aos dados de indexação. Suas credenciais permanecem criptografadas e seguras.

Conectar Goldsky ao seu AI

FAQ

Como funciona esta tarefa

  • 01

    A IA pode consertar o código do meu subgraph automaticamente?

    Não. A IA lê os logs e identifica o erro, mas você deve editar e fazer o deploy do código manualmente.

  • 02

    A IA pode reiniciar um pipeline que falhou?

    Não. As ferramentas permitem apenas que a IA leia o status, a contagem de erros e os logs. Ela não pode disparar reinicializações ou deploys.

  • 03

    A IA tem acesso a todos os meus dados do Goldsky?

    Não. Ela acessa apenas os dados específicos do pipeline que você autorizar através da conexão.

  • 04

    Com que frequência a IA verifica erros?

    A IA só verifica quando você solicita. Ela não monitora seus pipelines em segundo plano, a menos que você configure uma automação externa.

  • 05

    A IA pode alterar o schema do meu subgraph?

    Não. O acesso da IA é limitado à leitura para fins de depuração.

  • Mais dúvidas sobre o Goldsky? Veja tudo o que o Goldsky Connector pode fazer

Conecte Goldsky ao Claude, Cursor, ChatGPT e outros