Saltar al contenido principal

🔌 Solución de Problemas de Integración

A continuación se presentan soluciones a problemas comunes al integrar Beak AI con sistemas externos, bases de datos y APIs.

No se puede conectar a una base de datos​

  • Verifique el host, el puerto, el nombre de usuario y la contraseña de la base de datos en sus variables de entorno.
  • Asegúrese de que la base de datos sea accesible desde la red de implementación de Beak AI.
  • Revise las reglas del firewall y los grupos de seguridad.
  • Confirme que el controlador de base de datos correcto esté instalado y configurado.

Falla la integración con la API (tiempos de espera, errores 401/403)​

  • Verifique la URL del endpoint de la API y las credenciales (claves de API, tokens OAuth).
  • Asegúrese de que la API sea accesible desde su entorno de Beak AI.
  • Revise los límites de velocidad y las cuotas de la API externa.
  • Consulte la documentación de la API para conocer los encabezados o parámetros requeridos.
  • Para las APIs de Microsoft, asegúrese de que los permisos de API necesarios estén concedidos en su aplicación de Azure.
  • Asegúrese de que la credencial incluya el alcance correcto según la API que se utilice.
  • Si el agente falla debido a un token de acceso faltante, elimine la información relacionada con el token de la especificación OpenAPI.

Error de tiempo de espera durante la ejecución de una habilidad de API​

  • Si el agente está llamando a múltiples APIs y la ejecución tarda demasiado, considere utilizar la ejecución de código Python, que será más rápida.

La fuente de datos no aparece en Studio​

  • Actualice la interfaz de Studio y revise los registros en busca de errores.
  • Confirme que la fuente de datos esté registrada y habilitada en la configuración.
  • Verifique si hay problemas de esquema o permisos en el sistema externo.
  • Asegúrese de que el filtro de tipo de fuente de datos coincida con el tipo que creó (Base de datos, Sistema, Archivo o Sitio web).

Identificar qué fuente de datos utilizó mi agente​

  • Revise el rastreo en AI Observability para su consulta.
  • Examine qué fuente de datos fue seleccionada y el resultado devuelto por dicha fuente.

Mis credenciales cambian constantemente​

  • Las credenciales no están siendo modificadas ni perdidas; se muestran en forma cifrada por razones de seguridad.
  • Seguirán funcionando según lo esperado.
  • Puede actualizarlas con nuevos valores en cualquier momento.

Las credenciales recién creadas no aparecen en la asignación de credenciales de habilidades​

  • Primero agregue la habilidad a su agente.
  • Luego abra la configuración del agente y asigne la credencial allí.

No se puede encontrar el tipo de credencial adecuado para mi habilidad de API​

  • Utilice el tipo de credencial Personalizado, que le permite definir la clave y el valor del encabezado de autenticación.
  • Si la API requiere un mecanismo de autenticación más complejo, comuníquese con el equipo de Beak para agregar el tipo de credencial necesario.
  • Revise la documentación de la API para comprender qué método de autenticación y formato de credencial requiere.

El agente no puede obtener registros del espacio de trabajo de Log Analytics​

  • Asegúrese de que las credenciales estén configuradas correctamente con el acceso requerido.
  • Utilice AI Observability para verificar si la consulta KQL fue generada según lo esperado.
  • Si la consulta es incorrecta, revise el esquema de su tabla y la información adicional para orientar la generación correcta de KQL.

El webhook o la integración de eventos no se activa​

  • Verifique que la URL del webhook sea correcta y esté disponible públicamente si es necesario.
  • Compruebe los requisitos de autenticación o firma.
  • Inspeccione los registros en busca de solicitudes entrantes y respuestas de error.

Solicitud incorrecta en una habilidad de API​

  • Verifique su especificación OpenAPI y la URL de la API en la configuración de la habilidad.
  • En AI Observability → Traces, revise la URL final y el cuerpo de la solicitud para asegurarse de que sean correctos.
  • Configure únicamente los endpoints que realmente existen en la API externa.

Etiquetas en un prompt​

  • Las etiquetas son campos opcionales utilizados para categorizar y filtrar prompts.
  • Ayudan a organizar y gestionar los prompts de manera más eficiente dentro de Studio.

El prompt no se guarda​

  • Intente cambiar el nombre del prompt; puede que ya exista otro prompt con el mismo nombre.
  • Asegúrese de que el nombre del prompt no contenga caracteres no admitidos o especiales.

Errores de SSL/TLS o de certificados​

  • Asegúrese de que haya certificados válidos instalados tanto en Beak AI como en el sistema externo.
  • Para certificados autofirmados, agréguelos al almacén de confianza o deshabilite la verificación (no se recomienda para producción).

Para problemas de integración persistentes, consulte la Guía de Integración o comuníquese con el soporte de Beak AI.