🛠️ Solución de Problemas de Agentes
A continuación se presentan soluciones a problemas comunes relacionados con agentes, orquestación y habilidades en Beak AI.
No se puede ver el agente después de crearlo
- Asegúrese de haber iniciado sesión con la misma cuenta utilizada para crear el agente.
- Verifique que está aplicando los filtros correctos de Industria y Tipo de Agente.
- Revise la sección de Agentes Inactivos por si fue desactivado por error.
- Si está inactivo, simplemente reactívelo para que vuelva a ser visible.
El agente no responde o agota el tiempo de espera
- Revise los registros del agente en Beak AI Observability para detectar errores o tiempos de espera agotados.
- Asegúrese de que todas las fuentes de datos y habilidades requeridas estén conectadas y en buen estado.
- Verifique que el agente tenga los permisos necesarios y las variables de entorno configuradas.
- Reinicie el agente o el servicio subyacente si es necesario.
Errores de orquestación (p. ej., flujos de trabajo fallidos, tareas atascadas)
- Revise el rastreo de orquestación en Observability para identificar el paso que falla.
- Verifique si hay flujos de trabajo mal configurados, dependencias faltantes o referencias circulares.
- Compruebe que todos los subagentes y habilidades estén registrados y sean accesibles.
Habilidades rotas o faltantes
- Confirme que la habilidad esté correctamente registrada en Studio y habilitada para el agente.
- Busque incompatibilidades de versiones o dependencias faltantes en habilidades personalizadas.
- Pruebe la habilidad de forma independiente en el área de pruebas de Studio.
El agente produce resultados inesperados o incorrectos
- Revise la configuración de prompt y memoria del agente.
- Verifique si hay habilidades desactualizadas o en conflicto.
- Utilice Observability para rastrear el razonamiento y los resultados del agente paso a paso.
Cómo usar AI Observability para depuración
- Busque su agente en la pestaña Tracing y localice el mensaje de chat específico.
- Revise el flujo de trabajo para ver cómo se están activando las fuentes de datos y las habilidades.
- Compruebe las entradas enviadas y las salidas devueltas por cada fuente de datos y habilidad.
- Busque errores o entradas con formato incorrecto en el rastreo y realice los ajustes necesarios.
El agente no puede acceder a APIs externas o fuentes de datos
- Verifique la conectividad de red y las reglas del firewall.
- Asegúrese de que las claves API y las credenciales estén correctamente configuradas en las variables de entorno.
- Revise la configuración de integración en Studio.
El agente no está llamando a mi habilidad
- Asegúrese de que la habilidad esté correctamente agregada al agente.
- Revise las instrucciones de la habilidad: asegúrese de que describan claramente de qué es responsable.
Límites de longitud de instrucciones y resolución de errores relacionados con instrucciones
- Existen límites de tamaño estrictos para las instrucciones de habilidades en OpenAI.
- Resuma o acorte las instrucciones de sus habilidades siempre que sea posible.
- Evite colocar especificaciones OpenAPI o esquemas de tablas dentro de las instrucciones de habilidades.
- Mueva los detalles adicionales a las instrucciones del agente o a las preguntas del usuario cuando corresponda.
La habilidad de ejecución de código Python falla en el agente, pero funciona localmente
- Revise AI Observability → Trace para detectar mensajes de error específicos.
- Asegúrese de que su código pueda ejecutarse de principio a fin sin requerir entrada del usuario durante la ejecución.
Cómo configurar el agente para enviar correos electrónicos
- Configure la habilidad preintegrada Send Email en su agente.
- Use contraseñas de aplicación de correo electrónico codificadas en base64 junto con los nombres de usuario y direcciones de correo correctos.
- Configure el servidor SMTP y el puerto apropiados según su proveedor de correo electrónico (p. ej., Gmail, Outlook).
- Personalice la plantilla de correo electrónico HTML según sus preferencias de formato.
Lógica de selección de habilidades cuando hay múltiples habilidades presentes
- El agente elige una habilidad según las instrucciones de la habilidad y la pregunta del usuario.
- Asegúrese de que las instrucciones de cada habilidad describan claramente su propósito y responsabilidades.
El chat con un archivo grande no funciona, el agente no responde
- Esto puede deberse a las limitaciones de tokens de OpenAI al enviar contenido extenso directamente.
- Suba sus archivos como fuente de datos en su lugar.
- Elija Smart Search o Structured Smart Search y envíe los archivos correctamente.
Editar la habilidad no cambia el comportamiento del agente
- Después de adjuntar una habilidad a un agente, evite editarla desde la sección de Habilidades.
- En su lugar, edite la habilidad desde la sección Agente → Configurar para asegurarse de que los cambios se reflejen.
Pautas para configurar un agente ambiental
- Evite crear agentes no supervisados y sin pruebas con programaciones recurrentes abiertas.
- Primero verifique el comportamiento del agente en modo de chat para asegurarse de que responde correctamente.
- Configure la programación ambiental según sus requisitos solo después de confirmar que el agente se comporta como se espera.
- No cree el agente ambiental con un mensaje de activación vacío.
Para problemas persistentes, consulte las Preguntas Frecuentes Generales o póngase en contacto con el soporte de Beak AI.