Fuentes de Datos del Sistema
Beak AI Studio permite a los agentes conectarse con plataformas empresariales y sistemas de negocio, facilitando una integración perfecta con los procesos centrales del negocio y sus datos.
Flujo de Trabajo para la Creación de Fuentes de Datos
La creación de una fuente de datos del sistema en AI Studio implica dos fases principales para garantizar una integración sólida y una gestión del conocimiento eficaz.
Fase 1: Inicio
Comience proporcionando la siguiente información esencial:
- Nombre de la Fuente de Datos: Un nombre claro y descriptivo para la integración del sistema.
- Descripción: Un resumen del propósito y uso previsto de la fuente de datos.
- Instrucciones de Uso: (Opcional) Orientación para los miembros del equipo sobre cómo y cuándo utilizar esta fuente de datos.
- Tipo de Fuente de Datos: Seleccione "Sistema" como tipo.
Una vez introducida esta información, continúe con la fase de configuración.
Fase 2: Configuración
A. Conexión del Sistema
- Parámetros de Conexión: Introduzca los detalles de conexión requeridos (endpoints de API, autenticación, etc.) para el sistema empresarial.
- Métodos de Integración Compatibles:
- REST API: Conéctese a sistemas que exponen endpoints RESTful.
- OpenAPI/Swagger: Importe especificaciones OpenAPI para una integración rápida.
- API Personalizada: Configure endpoints personalizados y autenticación según sea necesario.
- Credenciales de Autenticación:
- Clave de API, ID/secreto de cliente OAuth2 o nombre de usuario/contraseña, según la plataforma.
- Permisos: Asegúrese de que el usuario de la API tenga permisos suficientes para las operaciones requeridas (lectura, escritura, actualización, etc.).
- Acceso a la Red: El entorno de Beak AI Studio debe poder alcanzar el endpoint de la API del sistema (considere VPN, firewall o listas de IPs permitidas si es necesario).
- Validación: El sistema prueba la conexión y valida las credenciales y los permisos.
B. Selección de Recurso (Paso Posterior)
Después de que la fuente de datos del sistema se haya establecido y validado, elija qué colección de registros desea incorporar:
- Recurso: Seleccione la colección (tickets, dispositivos, usuarios, etc.). Los conectores que declaran sus recursos los ofrecen como una lista; de lo contrario, introduzca el nombre del recurso.
- Detección automática: Beak AI puede explorar la API e informar sobre lo que está disponible: dónde se encuentran los registros, qué campos existen, cómo se pagina y qué campo marca un registro como modificado. Consulte Conectores Personalizados.
- Validación: Una fuente de datos sin recurso seleccionado no puede sincronizarse, y así lo indica.
Un recurso debe guardarse antes de la primera sincronización.
La fuente de datos del sistema solo estará disponible para su uso una vez que tanto la conexión como los pasos de selección de recurso se hayan completado y validado correctamente.
Integraciones de Sistema Compatibles
Beak AI Studio admite la integración con las siguientes plataformas. En cada caso, el método de integración típico es mediante REST API u OpenAPI, con autenticación y tipos de datos según se describe.
| Plataforma | Método(s) de Integración | Tipos de Datos Compatibles | Pasos de Configuración |
|---|---|---|---|
| Atlassian Jira | REST API, OpenAPI | Issues, proyectos, usuarios, comentarios | Endpoint de API, OAuth2/token de API, permisos |
| Azure | REST API, OpenAPI | Recursos, métricas, logs | Endpoint de API, OAuth2, Azure AD, permisos |
| Azure Log Analytics | REST API | Logs, consultas, métricas | ID de espacio de trabajo, clave de API, endpoint, permisos |
| Azure Metrics | REST API | Métricas, series temporales | ID de recurso, clave de API, endpoint, permisos |
| Beak FinOps | REST API | Datos de costes, uso y facturación | Endpoint de API, clave de API, permisos |
| Beak ITSM | REST API | Tickets, incidentes, activos | Endpoint de API, clave de API, permisos |
| Beak Observability | REST API | Métricas, trazas, logs | Endpoint de API, clave de API, permisos |
| Beak RMM | REST API | Estado de dispositivos, alertas, inventario | Endpoint de API, clave de API, permisos |
| Connectwise Manage | REST API, OpenAPI | Tickets, contactos, acuerdos | Endpoint de API, clave de API, ID de empresa, permisos |
| ManageEngine Endpoint Central | REST API | Dispositivos, parches, cumplimiento | Endpoint de API, clave de API, permisos |
| ManageEngine ServiceDesk Plus | REST API | Tickets, solicitudes, activos | Endpoint de API, clave de API, permisos |
| Microsoft 365 | REST API, OpenAPI | Usuarios, correo, calendario, archivos | Endpoint de API, OAuth2, Azure AD, permisos |
| Microsoft Entra | REST API | Identidades, políticas de acceso | Endpoint de API, OAuth2, Azure AD, permisos |
| Microsoft Intune | REST API | Dispositivos, cumplimiento, apps | Endpoint de API, OAuth2, Azure AD, permisos |
| N-Central | REST API | Dispositivos, monitorización, alertas | Endpoint de API, clave de API, permisos |
| Ninjaone | REST API | Dispositivos, tickets, monitorización | Endpoint de API, clave de API, permisos |
| Plumsail | REST API | Formularios, flujos de trabajo, documentos | Endpoint de API, clave de API, permisos |
| Qualys | REST API | Vulnerabilidades, activos, análisis | Endpoint de API, clave de API, permisos |
| SentinelOne | REST API | Endpoints, amenazas, políticas | Endpoint de API, clave de API, permisos |
| ServiceNow | REST API, OpenAPI | Tickets, incidentes, CMDB, usuarios | Endpoint de API, OAuth2/clave de API, permisos |
| SolarWinds Service Desk | REST API | Tickets, activos, usuarios | Endpoint de API, clave de API, permisos |
| Webhook | URL de Webhook | Cargas útiles JSON | URL de Webhook, autenticación (si es necesaria) |
| Windows Defender | REST API | Alertas, estado de dispositivos, amenazas | Endpoint de API, clave de API, permisos |
| Zendesk | REST API, OpenAPI | Tickets, usuarios, organizaciones | Endpoint de API, OAuth2/token de API, permisos |
| Zoho Desk | REST API | Tickets, contactos, base de conocimientos | Endpoint de API, clave de API, permisos |
Otros Sistemas Externos:
Cualquier otro sistema externo puede integrarse sin esperar a una nueva versión del producto: registre un manifiesto de conector y aparecerá de inmediato en el selector de conectores. Beak AI puede detectar automáticamente lo que expone la aplicación, en lugar de requerir un mapeo de datos escrito manualmente. Consulte Conectores Personalizados.
Plataformas que Sincronizan Registros Actualmente
Conectarse a una plataforma e incorporar sus registros son dos capacidades diferentes. Todas las plataformas anteriores aceptan una conexión y la validan. Las plataformas que se indican a continuación, además, declaran un recurso, por lo que pueden sincronizar registros en el almacén vectorial para que los agentes los recuperen:
| Plataforma | Categoría | Recurso | Incorporado como |
|---|---|---|---|
| Atlassian Jira | ITSM | Issues | ticket |
| Beak ITSM | ITSM | Tickets | ticket |
| ConnectWise Manage | ITSM | Service Tickets | ticket |
| ManageEngine ServiceDesk Plus | ITSM | Requests | ticket |
| ServiceNow | ITSM | Incidents | ticket |
| SolarWinds Service Desk | ITSM | Incidents | ticket |
| Zendesk | ITSM | Tickets | ticket |
| Zoho Desk | ITSM | Tickets | ticket |
| N-Central | Asset Management | Devices | asset |
| SentinelOne | Security | Agents | asset |
Una plataforma que no figure en esta lista igualmente se conecta, simplemente no tiene ningún recurso que incorporar aún, por lo que Sincronizar ahora no tiene nada que obtener. Use Detección automática para ver lo que expone su API y Conectores Personalizados para declarar un recurso sin esperar a una nueva versión.
Comportamiento de la Sincronización
Cada sincronización del sistema es una actualización completa: vuelve a leer el recurso completo y luego reemplaza los registros anteriores de la fuente de datos con lo que acaba de leer. Una copia de cada registro, que coincide con el sistema de origen en el momento de esa ejecución: las ediciones se corrigen, las eliminaciones desaparecen y ejecutar el proceso dos veces no duplica el recuento.
La lectura únicamente de los cambios producidos desde la última ejecución no está disponible todavía. Seis de los diez recursos anteriores exponen un campo de última modificación y cuatro no, y para al menos una plataforma no está confirmado si el filtro de fecha del proveedor cubre las ediciones o solo la creación de registros; un filtro que cubra únicamente la creación nunca volvería a leer silenciosamente un ticket editado. Hasta que esto se aclare por proveedor, un modo correcto es mejor que dos donde uno pierde datos silenciosamente.
Información completa, incluido lo que ocurre cuando un límite de seguridad interrumpe una ejecución: Conectores Personalizados — Sincronización.
Pasos de Configuración de Ejemplo
-
Seleccionar la Plataforma del Sistema:
Elija la plataforma deseada de la lista de compatibles. El selector agrupa las plataformas bajo encabezados de categoría — ITSM, Asset Management, Knowledge Base, Security, Identity, DevOps, Database, Other — de modo que una plataforma se encuentra según la función que desempeña y no explorando una larga lista alfabética. Un conector sin categoría asignada aparece en Other. -
Introducir los Detalles de Conexión:
Proporcione el endpoint de la API, las credenciales de autenticación (clave de API, OAuth2, etc.) y los parámetros requeridos. -
Establecer Permisos:
Asegúrese de que el usuario de la API o el registro de la aplicación tenga los permisos necesarios para las operaciones requeridas. -
Seleccionar el Recurso:
Elija qué colección incorporar o use Detección automática para que Beak AI informe sobre lo que expone la API. -
Guardar y Activar:
Guarde la fuente de datos. Ya está disponible para su uso en los flujos de trabajo de los agentes.
Buenas Prácticas
- Use OAuth2 o claves de API para una autenticación segura.
- Limite los permisos del usuario de la API únicamente a lo que sea necesario.
- Rote las credenciales periódicamente y monitorice los registros de acceso.
- Use Detección automática para confirmar la ruta del registro y el campo incremental en lugar de introducirlos manualmente.
- Ajuste el calendario de sincronización al recurso: cada ejecución vuelve a leer la colección completa, por lo que una colección grande con una frecuencia elevada supone una carga real sobre los límites de la API del sistema de origen.