Saltar al contenido principal

Agentes IA – Guía de Solución de Problemas

Esta guía ayuda a los usuarios a identificar y resolver problemas comunes con las habilidades del Agente IA de BEAK (REST API, Python o PowerShell) antes de escalar al equipo de soporte de BEAK. Se recomienda a los usuarios utilizar esta guía, junto con las preguntas frecuentes, para solucionar problemas de forma independiente antes de contactar al equipo de BEAK para obtener asistencia.

1. Autoevaluación Inicial​

Antes de revisar BEAK, confirme que su habilidad funciona de forma independiente.

a. Para Habilidades REST API​

  • Pruebe la misma llamada a la API utilizando Postman o cualquier herramienta de prueba de API en línea.
  • Asegúrese de que la solicitud se complete correctamente sin errores.
  • Si la API en sí no funciona en Postman, corrija esto primero antes de realizar pruebas en BEAK.

b. Para Habilidades Python o PowerShell​

  • Ejecute el script localmente en su máquina.
  • Confirme que el código se ejecuta sin errores.
  • Si el script falla localmente, actualice o corrija el código antes de utilizarlo en BEAK.

2. Revisar el Rastro de Ejecución​

Si la API o el script funciona fuera de BEAK pero falla dentro de BEAK, el siguiente paso es inspeccionar la ejecución en AI Observability.

Abra AI Observability y vaya a Traces. Cada fila corresponde a una ejecución del agente.

Abra el rastro más reciente de su agente (identifíquelo por la marca de tiempo). Un rastro se abre con su árbol de intervalos a la izquierda y el detalle del intervalo seleccionado a la derecha.

Seleccione el intervalo de generación (LLM) o de herramienta que desea inspeccionar, luego abra la pestaña Input / Output. El campo Input muestra la solicitud exacta que el agente envió: el prompt del sistema y los mensajes para un intervalo de generación, o los argumentos para una llamada a herramienta.

El campo Output muestra lo que se devolvió: la respuesta del asistente o el resultado de la herramienta, incluido el texto exacto del error cuando un intervalo falla.

a. Para Habilidades REST API​

  1. Verifique la solicitud generada por el Agente IA en el Rastro.
  2. Compárela con la solicitud que ejecutó en Postman.

Próximos Pasos:

  • Si ambas solicitudes coinciden: El problema probablemente está en la plataforma BEAK. Escale al Soporte de BEAK.
  • Si las solicitudes difieren: Revise la especificación OpenAPI configurada en la habilidad y actualice los parámetros o ajuste la sección Additional Info.

b. Para Habilidades Python o PowerShell​

  1. Verifique que el script visible en el Rastro coincida con el que ejecutó localmente.
  2. Compare el comportamiento entre la ejecución local y la ejecución en BEAK.

Próximos Pasos:

  • Si el script funciona localmente pero no en BEAK: Escale al Soporte de BEAK.
  • Si el script no funciona localmente: Actualice y corrija el script antes de volver a probarlo en BEAK.