• TRACE
  • SPAN
  • LOGIC
  • HUMAN

Cómo depurar fallos de agentes con tu IA y AgentOps

Conecta AgentOps con tu cliente de IA para inspeccionar la lógica interna de tus agentes. Podrás ver el momento exacto en que un bucle se rompe o surge un error de razonamiento.

Pregunta a la IA sobre esta página

Respuesta rápida

¿Cómo puede mi IA encontrar un fallo del agente?

Tu IA utiliza la telemetría de AgentOps para extraer trazas y spans específicos que mapean la ruta de decisión del agente. Esto te permite ver el paso exacto donde ocurrió una alucinación o un error de bucle. Obtendrás una visión clara del punto de fallo.

Dónde se encuentran los errores.

Resultados de la depuración.

La IA usa datos de telemetría para identificar la causa raíz de los errores de los agentes.

TRACE

Rutas de ejecución completas

La IA extrae la secuencia completa de eventos para mostrarte el camino que siguió el agente antes de fallar.

SPAN

Análisis de pasos detallado

La IA aísla sub-tareas específicas para mostrarte qué función o llamada individual causó el error.

LOGIC

Detección de alucinaciones

La IA compara el razonamiento del agente con los datos de la traza para hallar dónde se desvió del plan.

HUMAN

Correcciones manuales

La IA identifica vacíos lógicos que requieren que reescribas el prompt o ajustes las instrucciones del agente.

El flujo

Lo que hace tu IA cuando llega el error.

La IA actúa como tu investigador, extrayendo telemetría para explicar por qué un bucle de agentes perdió el control.

  1. Recuperar la traza

    La IA extrae el historial completo de ejecución de una ejecución específica para entender el contexto del fallo.

    get_trace
  2. Inspeccionar spans específicos

    La IA profundiza en segmentos individuales de la ejecución para hallar el momento exacto del fallo.

    get_span
  3. Mapear la ruta del error

    La IA usa los datos de la traza para reconstruir la secuencia de eventos que llevó a una alucinación.

    get_trace
  4. Aislar la falla

    La IA identifica el span específico que falló para que puedas centrar tu corrección.

    get_span

Pruébalo

Copia estos ejemplos para empezar.

Pega estos comandos en tu chat para iniciar la depuración.

Puntos de partida

Reemplaza los IDs de traza o span por los IDs reales de tu panel de AgentOps.

AgentOps Connector

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

Enlace del conectorhttps://edge.vinkius.com/vk_preview_OCln8CM8I7G7rNCo6QKijZPwPeMGY7W7gj6qBqEG/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 — AgentOps capabilities are ready to use.
Configuración · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "agentops-agent-telemetry-and-monitoring-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_OCln8CM8I7G7rNCo6QKijZPwPeMGY7W7gj6qBqEG/mcp"
    }
  }
}
Copia en el chat04
  • Obtén la traza para run_id_8821 y dime por qué falló el agente.

  • Analiza los spans de esta traza para encontrar dónde ocurrió la alucinación.

  • Revisa el span de 'tool_call' en trace_abc_123 para ver por qué devolvió un error.

  • Analiza la traza de ejecución del último fallo de bucle y explica el error de lógica.

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

Empieza aquí

Conecta AgentOps una vez y luego pregunta.

Vincula tu cuenta de AgentOps a Vinkius. Tus credenciales permanecen cifradas en nuestro lado y podrás empezar a preguntar a tu IA sobre la telemetría de tus agentes de inmediato.

Conectar AgentOps con tu IA

FAQ

Cómo funciona esta tarea.

  • 01

    ¿Puede la IA corregir el código de mi agente?

    No. La IA solo puede leer las trazas y los spans para explicar qué falló. Debes corregir el código o los prompts tú mismo.

  • 02

    ¿Puede la IA borrar trazas de AgentOps?

    No. Las herramientas solo permiten que la IA lea datos. No puede borrar ni modificar ninguna telemetría en tu cuenta de AgentOps.

  • 03

    ¿Necesito proporcionar un ID de traza?

    Sí. Para analizar un fallo específico, debes indicarle a la IA qué ID de traza o span debe recuperar.

  • 04

    ¿Puede la IA ver todos los datos de mi agente?

    No. La IA solo ve las trazas y los spans específicos que le pidas explícitamente que recupere.

  • 05

    ¿Funciona con cualquier agente?

    Funciona con cualquier agente que esté configurado para enviar telemetría a AgentOps.

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

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