# 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**](https://portal.azure.com/) e inicie sesión.
2.  En el campo de búsqueda, busque **"Subscriptions"**.

    <figure><img src="../../../.gitbook/assets/image (177).png" alt=""><figcaption></figcaption></figure>
3. Seleccione la suscripción donde está instalado Power Omni.

<figure><img src="../../../.gitbook/assets/image (178).png" alt=""><figcaption></figcaption></figure>

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

<figure><img src="../../../.gitbook/assets/image (179).png" alt=""><figcaption></figcaption></figure>

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

<figure><img src="../../../.gitbook/assets/image (218).png" alt=""><figcaption></figcaption></figure>

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

<figure><img src="../../../.gitbook/assets/image (220).png" alt=""><figcaption></figcaption></figure>

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

<figure><img src="../../../.gitbook/assets/image (219).png" alt=""><figcaption></figcaption></figure>

<figure><img src="../../../.gitbook/assets/image (183).png" alt=""><figcaption></figcaption></figure>

* 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**](https://portal.azure.com/) .
2. Busque **"Logic Apps"** y haga clic en **Create**.

<figure><img src="../../../.gitbook/assets/image (163).png" alt=""><figcaption></figcaption></figure>

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

* **Plan Type:** Seleccione **Consumption (Multitenant)**.

<figure><img src="../../../.gitbook/assets/image (164).png" alt=""><figcaption></figcaption></figure>

* <mark style="color:$danger;">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.</mark>

<figure><img src="../../../.gitbook/assets/image (165).png" alt=""><figcaption></figcaption></figure>

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

<figure><img src="../../../.gitbook/assets/image (166).png" alt=""><figcaption></figcaption></figure>

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

    <figure><img src="../../../.gitbook/assets/image (167).png" alt=""><figcaption></figcaption></figure>

#### 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**.

<figure><img src="../../../.gitbook/assets/image (168).png" alt=""><figcaption></figcaption></figure>

1.  Trigger

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

<figure><img src="../../../.gitbook/assets/image (169).png" alt=""><figcaption></figcaption></figure>

<figure><img src="../../../.gitbook/assets/image (170).png" alt=""><figcaption></figcaption></figure>

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

<figure><img src="../../../.gitbook/assets/image (171).png" alt=""><figcaption></figcaption></figure>

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.).

<figure><img src="../../../.gitbook/assets/image (173).png" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="../../../.gitbook/assets/image (172).png" alt=""><figcaption></figcaption></figure>

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

<figure><img src="../../../.gitbook/assets/image (174).png" alt=""><figcaption></figcaption></figure>

### 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.

<figure><img src="../../../.gitbook/assets/image (200).png" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="../../../.gitbook/assets/image (201).png" alt=""><figcaption></figcaption></figure>

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.

<figure><img class="only-light" src="../../../.gitbook/assets/telas/con-logic-relacionamentos-light.png" alt=""><img class="only-dark" src="../../../.gitbook/assets/telas/con-logic-relacionamentos-dark.png" alt=""><figcaption></figcaption></figure>

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

<figure><img src="../../../.gitbook/assets/image (176).png" alt=""><figcaption></figcaption></figure>

4. Guarde los cambios.

{% hint style="success" %}
Después de eso, su Agente está listo para utilizar el Logic App creado. Recuerde siempre ajustar las instrucciones del Agente para que opere de acuerdo con el Logic App creado.
{% endhint %}