• TRIAGE
  • CAUSA RAÍZ
  • ESTADO
  • HUMANO

Cómo depurar fallos de subgraphs con tu IA

Conecta Goldsky a tu agente para convertir errores de indexación en soluciones directas. Tu IA analiza los registros mientras tú te enfocas en el código.

Pregunta a la IA sobre esta página

Respuesta rápida

¿Por qué falla mi subgraph?

Tu agente revisa el estado del pipeline y extrae los recuentos de errores y los registros de ejecución para hallar la causa exacta. Así sabrás si el problema es un desajuste de esquema, un tiempo de espera de RPC o un error de lógica en tu código de mapeo.

Donde cada problema tiene su lugar.

Resultados de la depuración

La IA clasifica los fallos en estas categorías específicas.

TRIAGE

Identificar el tipo de fallo

El agente usa el recuento de errores para determinar si el pipeline está totalmente detenido o solo con retraso. Obtendrás una visión clara de la magnitud del problema.

CAUSA RAÍZ

Localizar el error exacto

Al analizar los registros de ejecución, tu agente encuentra la línea o el evento específico que causa la caída. Te ahorras buscar manualmente entre miles de líneas.

ESTADO

Verificar la salud del pipeline

El agente monitorea el estado actual de tu indexación. Sabrás de inmediato si necesitas reiniciar el proceso o realizar un nuevo despliegue.

HUMANO

Correcciones manuales de código

La IA identifica el error, pero tú debes reescribir la lógica de mapeo o actualizar el esquema. El agente te entrega todo el contexto necesario para hacerlo.

El flujo

Lo que hace tu IA cuando un pipeline falla.

En lugar de buscar en paneles de control, tu agente se encarga de la extracción de datos.

  1. Verificar estado

    El agente revisa primero el estado actual de tu indexación para ver si está activa o detenida.

    get_pipeline_status
  2. Cuantificar errores

    Extrae el número total de errores para saber si es un fallo menor o una interrupción total.

    get_pipeline_error_count
  3. Analizar registros

    El agente profundiza en los registros de ejecución para encontrar mensajes de error específicos y trazas de la pila.

    get_pipeline_logs
  4. Resumir causa

    Combina el estado, los errores y los registros para explicarte exactamente qué falló.

    get_pipeline_logs

Pruébalo

Copia estos ejemplos para empezar.

Usa estos prompts para iniciar una sesión de depuración.

Puntos de partida

Sustituye los nombres de los pipelines por tus identificadores reales de Goldsky.

Goldsky Connector

Todo listo. Elige tu cliente MCP y sigue las instrucciones de configuración.

Enlace del conectorhttps://edge.vinkius.com/vk_preview_vKwCn24rK9jiYRm7bJaactLmNUpPZSSNAnWrQ0l6/mcp

Claude Desktop

Sigue los pasos siguientes para conectarte en 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.
Configuración · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "goldsky-web3-data-indexing-subgraphs-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_vKwCn24rK9jiYRm7bJaactLmNUpPZSSNAnWrQ0l6/mcp"
    }
  }
}
Copia en el chat04
  • Revisa el estado de mi pipeline 'main-subgraph-prod' y dime si está funcionando.

  • ¿Cuántos errores han ocurrido en 'test-indexing-pipeline' en la última hora?

  • Extrae los últimos registros de 'dev-subgraph-v2' y explica por qué está fallando.

  • Mira el recuento de errores de 'production-indexer' y resume los errores más recientes de los registros.

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

Empieza aquí

Conecta Goldsky una vez y luego pregunta.

Una sola conexión da a tu agente acceso a tus datos de indexación. Tus credenciales permanecen cifradas y seguras.

Conectar Goldsky a tu IA

FAQ

Cómo funciona esta tarea

  • 01

    ¿Puede la IA corregir mi código de subgraph automáticamente?

    No. La IA lee los registros e identifica el error, pero tú debes editar y desplegar tu código manualmente.

  • 02

    ¿Puede la IA reiniciar un pipeline que ha fallado?

    No. Las herramientas solo permiten a la IA leer el estado, los errores y los registros. No puede ejecutar reinicios ni despliegues.

  • 03

    ¿La IA tiene acceso a todos mis datos de Goldsky?

    No. Solo accede a los datos del pipeline específico que autorices mediante la conexión.

  • 04

    ¿Con qué frecuencia revisa la IA si hay errores?

    La IA solo revisa cuando tú se lo pides. No monitorea tus pipelines en segundo plano a menos que configures una automatización externa.

  • 05

    ¿Puede la IA cambiar el esquema de mi subgraph?

    No. El acceso de la IA es de solo lectura para fines de depuración.

  • ¿Más preguntas sobre Goldsky? Ver todas las funciones del conector de Goldsky

Conecta Goldsky a Claude, Cursor, ChatGPT y más