Requisitos técnicos

Sugerencia

Consulte la Guia rápida para los pasos de implementación de Azure Marketplace.

Descripción general

El AI Analyst se implementa en su propio inquilino de Azure como una Azure Managed Application. En esta página se enumeran todos los elementos que deben estar disponibles antes de iniciar la implementación. Validar estos puntos con antelación es la forma más eficaz de acortar el tiempo de implementación, ya que casi todas las implementaciones fallidas se deben a un permiso ausente, un proveedor de recursos no registrado, o una cuota insuficiente.

Requisitos previos existentes de dab

Antes de implementar AI Analyst, ya deben estar disponibles los siguientes elementos:

• dab Nexus
• Una licencia para dab AI Analyst

Nota

El dab Knowledge Hub proporciona la experiencia en SAP y analítica con la que razona AI Analyst. Por lo tanto, AI Analyst no puede operar sin un Knowledge Hub y para acceder a él se requiere la licencia de AI Analyst.

Requisitos de Azure

Suscripción y permisos

• Una suscripción de Azure en la que se implementará AI Analyst
• Owner en el alcance de destino, o Contributor más User Access Administrator
• Permiso para implementar la oferta de Azure Marketplace

Importante

El rol puro Contributor no es suficiente. La implementación crea asignaciones de roles para que la aplicación pueda leer sus propios secretos desde Key Vault usando su identidad administrada. Sin User Access Administrator, la implementación falla en el paso de asignación de roles.

Proveedores de recursos requeridos

Los siguientes proveedores de recursos deben estar registrados en la suscripción de destino:

Proveedor de recursos	Por qué es necesario
Microsoft.Web	App Service y App Service Plan que ejecutan AI Analyst
Microsoft.KeyVault	Key Vault que almacena la cadena de conexión, claves API y secretos
Microsoft.CognitiveServices	Cuenta de Azure AI Foundry y la implementación del modelo de IA
Microsoft.Network	Red virtual, subredes y el punto de enlace privado con el dab Knowledge Hub
Microsoft.ManagedIdentity	Identidad administrada que emplea AI Analyst para acceder a Key Vault Secrets
Microsoft.App	Componentes de plataforma de la aplicación administrada

Puede registrar los proveedores en el Portal de Azure bajo Subscription -> Settings -> Resource providers, o ejecutando:

az provider register --namespace Microsoft.Web
az provider register --namespace Microsoft.KeyVault
az provider register --namespace Microsoft.CognitiveServices
az provider register --namespace Microsoft.Network
az provider register --namespace Microsoft.ManagedIdentity
az provider register --namespace Microsoft.App

Nota

El registro es asíncrono y puede tardar algunos minutos. Espere hasta que cada proveedor muestre el estado Registered antes de iniciar la implementación.

Cuota necesaria

La implementación solicita capacidad en dos ubicaciones. Ambas son verificadas por Azure durante el despliegue, y la implementación fallará si la suscripción no cuenta con espacio suficiente.

Cuota	Qué se debe verificar
Tokens por minuto (TPM) de Azure OpenAI	En la región de Cognitive Services de destino, para la familia de modelos que planea usar. La cuota se comparte en todas las implementaciones de esa familia de modelos en la misma suscripción y región.
Cómputo de App Service	El tamaño de App Service Plan seleccionado debe estar disponible en la región de implementación. Las suscripciones nuevas o de prueba suelen tener un límite de 0 para la familia de VM requerida.

Puede verificar la cuota de modelos en el Portal de Azure bajo Azure AI Foundry -> Quotas, o ejecutando:

az cognitiveservices usage list --location <region> --output table

Nota

Si el espacio disponible es menor que la capacidad que planea implementar, solicite un aumento de cuota antes del día de implementación. Las solicitudes de aumento de cuota son gestionadas por Microsoft y pueden requerir tiempo.

Requisitos para la base de datos

Se requiere una base de datos que almacene las tablas de resultados relevantes, específicamente:

• Una base de datos de Microsoft SQL Server o Azure SQL Server que aloje los resultados de dab Nexus de ejecución analítica
• Un usuario de base de datos con acceso solo lectura a las tablas que analiza AI Analyst
• Una cadena de conexión en formato ADO.NET (u ODBC), con cifrado habilitado
• Conectividad de red desde Azure hacia esa base de datos

Nota

Utilice la cadena de conexión de la base de datos utilizada por la ejecución analítica, no la de la base de datos de aplicación dab Nexus.

Importante

AI Analyst accede a su base de datos a través del tráfico saliente de su red virtual. Aclare la ruta de red con el equipo que administra la base de datos antes de la implementación. Las opciones disponibles se describen en la Guia rápida.

Valores que necesita durante la implementación

Tenga listos los siguientes elementos antes de abrir el asistente:

Valor	De dónde proviene
Suscripción, grupo de recursos y región	Usted
Cadena de conexión de base de datos	Usted
Esquema base de tabla SQL	Usted, valor predeterminado Results
Rangos de IP permitidos en notación CIDR	El departamento de TI, por ejemplo 203.0.113.0/27
Clave API de AIA	Usted la genera, al menos 32 caracteres
Secreto de token de sesión	Usted lo genera, al menos 32 caracteres
Clave API de Knowledge Hub	Proporcionada por dab como parte de AIAnalyst License
Mensaje de solicitud privada de Link	Usted, usado por dab para identificar su solicitud

Importante

Los valores AIA API Key y Session Token Secret no se pueden recuperar posteriormente de los resultados de la implementación, y deberá ingresarlos nuevamente en cada reimplementación. Se recomienda crearlos y almacenarlos en un gestor de contraseñas antes de iniciar el proceso.