Logic Apps

Esta documentación detalla cómo crear un flujo en Azure Logic Apps y utilizarlo como conector en Power Omni, permitiendo que los Agentes de IA ejecuten acciones en sistemas externos (p. ej., APIs, bases de datos, ERPs).

1. Habilitar el permiso en Azure

Antes de crear el Logic App, es obligatorio asignar el permiso correcto a Power Omni a nivel de la Suscripción de Azure.

1. Acceda al Azure Portal e inicie sesión.

2. En el campo de búsqueda, busque "Subscriptions".

   

3. Seleccione la suscripción donde está instalado Power Omni.

4. Haga clic en IAM (Access Control) y luego en Add > Add role assignment.

5. Busque Logic App y seleccione Logic App Contributor, luego haga clic en Next.

6. En la siguiente pantalla (Members), haga clic en "+ Select members".

7. Busque Power Omni, selecciónelo y continúe.

• Haga clic en "Review + Assign" para completar la asignación del rol.

¡Listo! Después de asignar el rol, puede continuar con la creación del Logic App.

2. Configuración del Logic App en Azure

El Logic App actuará como el puente que recibe la solicitud de Power Omni y ejecuta la lógica de negocio deseada.

2.1 Creación del recurso Logic App

1. Acceda al Azure Portal .
2. Busque "Logic Apps" y haga clic en Create.

3. En la pantalla de creación, utilice las siguientes configuraciones:

• Plan Type: Seleccione Consumption (Multitenant).

• Es importante que el Logic App se cree en el MISMO Resource Group donde se instalaron los recursos de Azure AI Foundry (y el propio Power Omni), y en la misma región.

• Después de completar la información, haga clic en Review + Create y luego en Create.
• Espere a que finalice el despliegue.

• Después del despliegue, haga clic en Go to resource.

  

2.2 Diseño del flujo de trabajo

Después de crear el Logic App, debe diseñar el flujo de trabajo en el Logic App Designer.
Haga clic en Development Tools > Logic App Designer.

1. Trigger

   El flujo debe comenzar obligatoriamente con el trigger:
   "When an HTTP request is received".

2. Method: En la configuración del trigger HTTP, establezca el Method en "Allow all methods".

3. Schema: Para garantizar que Power Omni pueda enviar datos estructurados al Logic App, debe definir el esquema JSON. Este esquema define qué parámetros puede enviar el Agente de IA al Logic App.

4. Acciones

   Agregue las acciones necesarias (p. ej., conectarse a un sistema vía API, enviar correo electrónico, obtener datos, etc.).

5. Response

   El flujo debe terminar obligatoriamente con la acción "Response", que enviará el resultado de la ejecución de vuelta a Power Omni.

6. Después de crear el flujo, haga clic en Save.

3. Configuración del conector en Power Omni

Después de crear el Logic App, Power Omni lo identificará automáticamente en el listado de conectores.

3.1 Creación del conector

1. Acceda al Área de Administración de Power Omni.
2. Navegue hasta Artefactos > Conectores.
3. Power Omni listará los Logic Apps que estén en el mismo Resource Group. Localice y seleccione el Logic App deseado.

4. Complete la información del Conector:

• Nombre del Conector: Proporcione un nombre descriptivo (p. ej., "Consulta de Inventario ERP").
• Descripción: Defina el texto que el Agente de IA utilizará para reconocer y activar este conector (p. ej., "check_inventory", "verify_API").

5. Configuración de la conexión

• Crear Nueva Conexión: Si es la primera vez que utiliza este Logic App, proporcione un nombre para crear la conexión.
• Si la conexión ya fue creada anteriormente, haga clic en "Importar Conexión Existente" e ingrese el nombre de la conexión.

6. Verifique que el Schema se haya configurado automáticamente.
7. Haga clic en Guardar.

4. Vinculación del conector al agente

Para que un Agente de IA utilice el nuevo Logic App, debe estar vinculado:

1. Vaya a la sección Agentes (en el Portal de Administración).
2. Edite (o cree) el Agente de IA que debe tener acceso al conector.

3. En la configuración del Agente, vincule el conector recién creado.

4. Guarde los cambios.