Implementando dab AI Analyst

Sugerencia

Revise primero los requisitos técnicos. La mayoría de los problemas de implementación se deben a que algún requisito previo no fue preparado.

Antes de comenzar

dab AI Analyst se implementa desde Azure Marketplace como una aplicación administrada de Azure. El despliegue tiene seis pestañas de configuración y un paso final revisar y crear, los cuales usted completa en orden. Confirme lo siguiente antes de iniciar:

• dab Nexus ya está en uso
• La clave AI Analyst License proporcionada por dab como parte de la licencia de AI Analyst está disponible, consulte https://knowledge.dab-europe.com/portal/license-management
• Se ha seleccionado la suscripción de Azure de destino
• Los proveedores de recursos requeridos están registrados
• El usuario que implementa tiene Owner, o Contributor más el/los rol(es) User Access Administrator
• Las cuotas de App Service compute están disponibles en las regiones de destino
• La cadena de conexión de la base de datos a la base de datos que almacena los resultados de ejecución analítica de su Nexus
• Las cuotas de Azure Foundry LLM deployment están disponibles en las regiones de destino

Nota

La cadena de conexión de la base de datos debe hacer referencia a la base de datos utilizada por la ejecución dab AnalyticSuite, no la base de datos de la aplicación dab Nexus.

Abra la oferta en el Marketplace

dab AI Analyst se publica como una oferta pública dentro de Azure Marketplace y debe ser seleccionada.

1. Aspectos básicos

Esta pestaña define dónde se crean la aplicación y sus recursos.

Campo	Qué ingresar
Suscripción	La suscripción de Azure en la que se implementa AI Analyst
Grupo de recursos	Un grupo de recursos nuevo o existente para la aplicación administrada
Región	La región de Azure para la red virtual, Key Vault y App Service
Nombre de la aplicación	Un nombre para la aplicación administrada
Grupo de recursos administrado	El grupo de recursos que contiene los recursos de la aplicación administrada

Sugerencia

Seleccione una región cercana a su base de datos. La región elegida aquí no determina dónde se implementa el modelo de IA. Usted la selecciona por separado en el paso 6.

2. Configuración de la aplicación

Esta pestaña define la configuración general de implementación.

2.1 Tamaño del plan de App Service

Seleccione el tamaño del plan para el App Service que ejecuta AI Analyst. Este es el backend de AI Analyst: ejecuta los agentes que se construyen sobre el modelo Azure AI Foundry implementado. Puede escalar el plan hacia arriba o hacia abajo posteriormente sin necesidad de volver a implementar.

SKU	Núcleos	RAM	Recomendado para
P1v3	2	8 GB	Predeterminado recomendado
P1mv3	2	16 GB	Cargas de trabajo intensivas en memoria
P1v4	2	8 GB	Generación actual, comparable con P1v3
P2v4	4	16 GB	Gran cantidad de usuarios en paralelo
P3v4	8	32 GB	Escala empresarial

Se recomienda iniciar con P1v3 y escalar solo si el rendimiento lo requiere.

2.2 Secretos

Ambos secretos son valores que usted crea.

Campo	Por qué se necesita
AIA API Key	Asegura la comunicación entre el elemento visual AI Analyst en el panel de PowerBi y el backend de AI Analyst. Cada cliente que llama a la API necesita esta clave.
Session Token Secret	Firma las sesiones de usuario para que la aplicación pueda verificar que un usuario ha iniciado sesión. Los usuarios nunca ven este valor.

Cada valor debe tener al menos 32 caracteres de longitud y es necesario almacenarlos, ya que se requieren después de la implementación.

Sugerencia

Utilice un gestor de contraseñas para crear y almacenar sus secretos.

Importante

Utilice solo los caracteres A-Z, a-z y 0-9. Caracteres como ;, ", &, % o espacios pueden causar problemas de análisis en los encabezados HTTP y en la configuración posterior.

3. Seguridad de red

Por defecto, AI Analyst y sus servicios de soporte solo son accesibles a través de su propia red virtual. Esta pestaña determina si los usuarios pueden también acceder a la aplicación desde fuera de esa red, por ejemplo desde su oficina corporativa.

Campo	Qué ingresar
Añadir direcciones IP a la lista permitida	Yes si los usuarios acceden a AI Analyst desde fuera de la red virtual, en caso contrario No
Rangos de IP permitidos (CIDR)	Los rangos de IP permitidos en notación CIDR, separados por comas, por ejemplo 203.0.113.0/27, 198.51.100.42/32

Agregue el rango de IP de su oficina para que pueda abrir la interfaz de AI Analyst y leer los secretos de Key Vault en Azure Portal. Puede modificar la lista permitida posteriormente en Azure Portal bajo App Service -> Networking -> Access restrictions.

Nota

Si selecciona No, la API no es accesible desde fuera de la red virtual y necesita configurar una conexión personalizada a la red virtual, como el emparejamiento de redes.

4. Conexión de base de datos

Esta pestaña define la base de datos que consulta AI Analyst. El valor se almacena en Key Vault tras la implementación y nunca se escribe en registros ni en la configuración de la aplicación.

Campo	Qué ingresar
Cadena de conexión de la base de datos	La cadena de conexión para la base de datos que contiene los resultados de ejecución analítica
Esquema de la tabla base SQL	El esquema en el que dab Nexus exporta las tablas requeridas por AI Analyst, por defecto Results

Se admiten los siguientes formatos de cadena de conexión:

• Formato ADO.NET, recomendado:

  Server=tcp:myserver.database.windows.net,1433;Database=mydb;User ID=myuser;Password=mypassword;Encrypt=yes;TrustServerCertificate=no;

• Formato ODBC, alternativamente:

  Driver={ODBC Driver 18 for SQL Server};Server=tcp:myserver.database.windows.net,1433;Database=mydb;Uid=myuser;Pwd=mypassword;Encrypt=yes;TrustServerCertificate=yes;

Métodos de autenticación admitidos:

• Usuario SQL y contraseña (recomendado) — cree un usuario SQL dedicado y de solo lectura para dab AI Analyst e inserte sus credenciales en la cadena de conexión como se muestra arriba. Funciona directamente y no requiere configuración adicional.
• Identidad administrada (opcional) — el App Service puede autenticar con la identidad administrada de la aplicación administrada con la que se implementa. Utilice una cadena de conexión sin User ID/Password y con Authentication=Active Directory Managed Identity. Esto requiere configuración adicional por su parte después del despliegue: debe crear un usuario contenido en la base de datos para la identidad administrada y otorgarle acceso de lectura. Elija esto solo si la política de su organización lo exige.

Advertencia

Dado que se utiliza IA generativa, asegúrese de que el usuario que permite que dab AI Analyst interactúe con sus datos tiene acceso solo de lectura.

Importante

La base de datos debe ser accesible por el Azure App Service para que dab AI Analyst funcione. Si su base de datos no está disponible públicamente, debe configurar manualmente su accesibilidad después de la implementación.

Una base de datos inaccesible no detiene la implementación como tal. La aplicación inicia, registra Database warm-up failed, y permanece inutilizable hasta que se corrija la ruta de red. Confirme la ruta con el equipo que administra la base de datos antes del día de implementación.

5. Configuración del modelo de IA

Esta pestaña define el modelo Azure OpenAI con el que razona AI Analyst y cuánto rendimiento se le permite usar.

Campo	Qué ingresar
Región de Cognitive Services	La región en la que se implementa el modelo. Debe contar con cuota disponible para el modelo seleccionado. Se recomienda una cuota de 1,2 millones de tokens por minuto por cada 10 usuarios.
Modelo	El modelo que utiliza AI Analyst. El menú desplegable solo muestra los modelos disponibles en la región seleccionada.
Capacidad (Unidades de cuota)	El rendimiento reservado para AI Analyst. Una unidad equivale a 10.000 tokens por minuto.

Recomendamos el modelo gpt5.6-luna, que combina un razonamiento sólido con un costo bajo; gpt5.6-terra es ligeramente mejor, pero su costo es considerablemente mayor. Seleccione una región que tenga cuota disponible para este modelo y que esté cerca de su región de implementación.

Importante

La capacidad se comparte entre todas las implementaciones de la misma familia de modelos en la misma suscripción y región. Si solicita más capacidad que la disponible, la implementación fallará. Comience con un valor bajo y auméntelo posteriormente en el Azure Portal.

5.1. Capacidad del modelo de IA

5.2. Rendimiento del modelo de IA

6. Licencia y Knowledge Hub

AI Analyst enriquece sus respuestas con la experiencia SAP y analítica del dab Knowledge Hub. Esta pestaña conecta su implementación a ese servicio mediante una Link privada, de modo que el tráfico nunca atraviesa internet pública.

Campo	Qué ingresar
Knowledge Hub API Key	La clave de licencia que usted recibió de dab
Mensaje de solicitud de Link privada	Un mensaje que identifique su solicitud (empresa y persona responsable), por ejemplo Contoso AG (m.mustermann(at)cag.com) - productive AI Analyst deployment

Nota

La conexión Link privada se crea en el estado Pendiente y debe ser aprobada por dab. AI Analyst no funciona sin dicha aprobación.

Advertencia

Un Mensaje de solicitud de Link privada que no contenga el nombre de la empresa ni la persona responsable será rechazado.

Revisar y crear

Azure valida todos los parámetros y muestra un resumen. Verifique que todos los secretos estén completados, que las regiones y el modelo sean correctos y que la cadena de conexión esté completa. Luego haga clic en crear. La implementación toma alrededor de tres a cinco minutos.

Sugerencia

Continúe con Después de la implementación para verificar el resultado y solicitar la aprobación de la Link privada.