• OBSERVAR
  • AUDITAR
  • REPARAR
  • MANUAL

Depura estados de hilos de agentes con tu IA

Conecta tu agente a LangGraph Cloud para inspeccionar hilos activos. Podrás ver exactamente dónde se detuvo un proceso y corregirlo sin tener que empezar de cero.

Pregunta a la IA sobre esta página

Respuesta rápida

¿Cómo puedo depurar el estado del hilo de mi agente?

Tu IA utiliza las herramientas de LangGraph Cloud para obtener el estado actual de cualquier hilo o listar todos los hilos activos. Una vez detectado el error, puedes enviar un nuevo estado al hilo para saltar el fallo o corregir la lógica. Tendrás una ruta clara para desbloquear agentes detenidos.

Donde se concentran tus esfuerzos de depuración.

Corrección de la lógica del agente.

La IA gestiona la recuperación de datos y la inyección de estados para que tú te enfoques en la lógica.

OBSERVAR

Identifica el cuello de botella

La IA extrae el estado actual de un hilo específico. Obtendrás una visión clara de las variables y el historial que causan el bloqueo.

AUDITAR

Localiza el hilo correcto

La IA escanea tus sesiones activas. Podrás encontrar rápidamente el ID del hilo específico que requiere atención.

REPARAR

Inyecta el estado corregido

La IA envía una actualización manual al hilo. Esto te permite sobrescribir datos erróneos y mantener el flujo del agente.

MANUAL

Intervención humana

La IA identifica el error, pero tú decides si el cambio de estado es seguro. Tú eres el juez final de la lógica del agente.

El flujo

Lo que hace tu IA cuando llega la solicitud.

La IA actúa como un puente entre tu interfaz de chat y el entorno de ejecución de LangGraph Cloud.

  1. Localizar el hilo

    La IA busca la conversación o el proceso específico que te interesa revisando todos los hilos existentes.

    list_threads
  2. Inspeccionar los datos

    La IA lee los valores exactos, el historial de puntos de control y las variables actuales guardadas en ese hilo.

    get_thread_state
  3. Analizar el error

    Tu agente compara el estado actual con la lógica esperada para encontrar dónde ocurrió el bucle o el error.

    get_thread_state
  4. Corregir el estado

    La IA escribe nuevos datos en el hilo para corregir un error o saltar un nodo defectuoso.

    update_thread_state

Pruébalo

Copia estos ejemplos para empezar.

Usa estos prompts para iniciar la depuración de inmediato.

Puntos de partida

Sustituye los IDs de los hilos y los nombres de las variables por tus datos reales de LangGraph.

LangGraph Cloud Connector

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

Enlace del conectorhttps://edge.vinkius.com/vk_preview_W9eYJ3x7BufqP9zavlkhkY5HUux0v9z8z0xZYWei/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 — LangGraph Cloud capabilities are ready to use.
Configuración · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "langgraph-cloud-stateful-ai-agents-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_W9eYJ3x7BufqP9zavlkhkY5HUux0v9z8z0xZYWei/mcp"
    }
  }
}
Copia en el chat04
  • Lista todos mis hilos activos de LangGraph para que pueda encontrar el que está bloqueado.

  • Muéstrame el estado actual del hilo con ID 'abc-123' para ver por qué se detuvo el agente.

  • Actualiza el estado del hilo 'xyz-789' cambiando la variable 'user_input' a 'retry'.

  • Comprueba el estado del hilo 'debug-456' y dime cuál fue el último nodo ejecutado con éxito.

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

Empieza aquí

Conecta LangGraph Cloud una vez y luego pregunta.

Solo tienes que vincular tu cuenta. Tus credenciales permanecen cifradas y podrás empezar a depurar hilos mediante tu cliente de IA preferido al instante.

Conecta LangGraph Cloud a tu IA

FAQ

Cómo funciona esta tarea.

  • 01

    ¿Puede la IA eliminar un hilo?

    No. La IA solo puede listar, leer o actualizar los estados de los hilos. La eliminación de hilos debe hacerse manualmente en LangGraph Cloud.

  • 02

    ¿Actualizar un estado activará un nuevo nodo inmediatamente?

    La IA actualiza el estado, pero la ejecución real del siguiente nodo depende de tu configuración de LangGraph y de cómo actives el grafo.

  • 03

    ¿Puede la IA ver toda mi base de datos?

    No. La IA solo tiene acceso a los estados de los hilos específicos y a los metadatos proporcionados por las herramientas de LangGraph Cloud.

  • 04

    ¿Puede la IA cambiar el código del grafo?

    No. La IA solo puede modificar los datos dentro de un hilo en ejecución, no la lógica de Python ni la estructura del grafo.

  • 05

    ¿Cómo encuentro un ID de hilo específico?

    Puedes pedirle a la IA que liste todos los hilos; esto te devolverá los IDs disponibles para que elijas el que necesites.

  • ¿Tienes más dudas sobre LangGraph Cloud? La página del Connector tiene las respuestas. Ver todo lo que puede hacer el LangGraph Cloud Connector

Conecta LangGraph Cloud a Claude, Cursor, ChatGPT y más