> For the complete documentation index, see [llms.txt](https://docs.poweromni.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.poweromni.ai/administracao-e-configuracao/artefatos/conectores/logic-apps.md).

# Logic Apps

Esta documentação detalha como criar um fluxo no Azure Logic Apps e utilizá-lo como um conector no Power Omni, permitindo que os Agentes de IA executem ações em sistemas externos (ex: APIs, bancos de dados, ERPs).

### 1. Habilitar permissão no Azure

Antes de criar o Logic App, é obrigatório atribuir a permissão correta ao Power Omni no nível da sua Assinatura do Azure (Subscription).

1. Acesse o [Portal do Azure](https://portal.azure.com/) e faça login. 
2. No campo de busca, pesquise por "Assinaturas" (*Subscriptions*).

   <figure><img src="/files/Pz7vV1kHrsC0gnPhIhSO" alt=""><figcaption></figcaption></figure>
3. Selecione a assinatura onde está instalado o Power omni.

<figure><img src="/files/CM2MqNP5sWuIR3w6n1Hw" alt=""><figcaption></figcaption></figure>

4. Clique em IAM (Controle de acesso) após isso clique em Adicionar > Adicionar atribuição de função

<figure><img src="/files/RI10KID3D9tmWO9fqyJD" alt=""><figcaption></figcaption></figure>

5. Pesquise por Aplicativo Lógico (Logic App) e selecione a Colaborador de Aplicativo Lógico (Logic App Contributor)  e clique em Próximo.

<figure><img src="/files/zvdByNWTdYUjmCo9kBxN" alt=""><figcaption></figcaption></figure>

6. Na próxima tela (Membros), clique em "+ Selecionar membros".

<figure><img src="/files/WAdtciQ6V4IKCW754FtQ" alt=""><figcaption></figcaption></figure>

7. Procure por Power Omni, após encontrar pode selecionar e avançar

<figure><img src="/files/mkhSagJvkyIWF5sUlCdn" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/bDc5eVZ2IlMnAvzxqphX" alt=""><figcaption></figcaption></figure>

* Clique em "Examinar + Atribuir" para finalizar a atribuição da função.

Pronto! Após realizar a atribuição de função, você já pode seguir para a criação do Logic App.

### 2. Configuração do Logic App no Azure

O Logic App funcionará como a ponte que recebe a solicitação do Power Omni e executa a lógica de negócios desejada.

#### 2.1 Criação do Recurso Logic App

1. Acessar o Azure: [Portal do Azure](https://portal.azure.com/).
2. Pesquise por "Logic Apps" e clique em "Criar".

<figure><img src="/files/OQBrK9txaXYwnBMeRy9r" alt=""><figcaption></figcaption></figure>

3. Configuração: Na tela de criação, utilize as seguintes configurações:

* Tipo de Plano: Selecione a opção "Consumo" (Multilocatário).

<figure><img src="/files/3RTdqaUm4J00jCj0QUXH" alt=""><figcaption></figcaption></figure>

* <mark style="color:$danger;">É importante que o Logic App seja criado no MESMO Grupo de Recursos (Resource Group) onde os recursos do Azure AI Foundry (e o próprio Power Omni) foram instalados e na mesma região.</mark>

<figure><img src="/files/V5VrCWRsLucfGu5baa4T" alt=""><figcaption></figcaption></figure>

* Após preencher é só clicar em Revisar + Criar e posteriormente clicar em criar.
* Só aguardar a implantação.

<figure><img src="/files/TQoQv3iioLRHvQDD3uzV" alt=""><figcaption></figcaption></figure>

* Após a implantação, clique em Ir para o recurso.

  <figure><img src="/files/sCkZ9qre318XdKRx2KNe" alt=""><figcaption></figcaption></figure>

#### 2.2 Design do Fluxo (Workflow)

Após a criação do Logic App, você deve desenhar o fluxo de trabalho no *Logic App Designer,* Clique em ferramentas de Desenvolvimento>Designer do aplicativo lógico

<figure><img src="/files/QVOWtW0OBLrsjT0CyGNW" alt=""><figcaption></figcaption></figure>

1. Gatilho (Trigger): O fluxo deve obrigatoriamente começar com o gatilho "When an HTTP request is received" (Quando uma solicitação HTTP é recebida).

<figure><img src="/files/HVVCbC28dgY7qaDtAz5g" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/GjkXlVh1UYjh0wvzULzC" alt=""><figcaption></figcaption></figure>

2. Método: Nas configurações do gatilho HTTP, defina o Método (Method) como "Allow all methods".

<figure><img src="/files/uKf3gQZcxuxUjavq4k3i" alt=""><figcaption></figcaption></figure>

3. Schema: Para garantir que o Power Omni possa enviar dados estruturados ao Logic App, é necessário definir o schema JSON. Este schema define quais parâmetros o Agente de IA pode enviar para o Logic App.
4. Ações: Adicione as ações necessárias (ex: conectar-se a um sistema via API, enviar e-mail, buscar dados, etc.).

<figure><img src="/files/ANHHr859EwqgpyZYmlC9" alt=""><figcaption></figcaption></figure>

5. Resposta (Response): O fluxo deve obrigatoriamente terminar com a ação "Response" (Resposta), que enviará o resultado da execução de volta ao Power Omni.

<figure><img src="/files/7k4d2HVMnniVG0OjcbkH" alt=""><figcaption></figcaption></figure>

6. Após o fluxo estar criado, pode clicar em salvar.

<figure><img src="/files/mAsxajWjvhDh9jMf5qnZ" alt=""><figcaption></figcaption></figure>

### 3. Configuração do Conector no Power Omni

Após o Logic App estar criado, o Power Omni irá identificá-lo automaticamente na listagem dentro do conector.

#### 2.1 Criação do Conector

1. Acesse a Área de Administração do Power Omni.
2. Navegue até a seção de Artefatos > Conectores.
3. O Power Omni fará a listagem dos Logic Apps que estão no mesmo Grupo de Recursos. Localize e selecione o Logic App desejado.

<figure><img src="/files/Ix80DEfp6HoR5p9BnOJY" alt=""><figcaption></figcaption></figure>

4. Preencha as informações do Conector:

* Nome do Conector: Dê um nome descritivo para o conector (ex: "Consulta de Estoque ERP").
* Descrição: Defina o texto que o Agente de IA usará para reconhecer e acionar este conector (ex: "consultar\_estoque", "verificar\_API").

5. Configuração de Conexão.

* Criar nova Conexão, Se for a primeira vez utilizando esse Logic App, basta informar um nome para criar a conexão.
* Caso a conexão já tenha sido criada anteriormente, clique em **“Importar Conexão Existente”** e informe o nome da conexão.

<figure><img src="/files/cK0LytgdRRNMJPxzGSbN" alt=""><figcaption></figcaption></figure>

6. Verifique se o Schema foi configurado automáticamente.
7. Clique em salvar.

### 4. Relacionando o Conector ao Agente

Para que um Agente de IA possa usar o novo Logic App, ele precisa ser relacionado:

1. Navegue até a seção de Agentes (no Portal de Administração).
2. Edite (ou crie) o Agente de IA que deverá ter acesso ao conector.

<figure><img src="/files/QpvFwtN9LpV0sULHPwL3" alt=""><figcaption></figcaption></figure>

3. Na configuração do Agente, relacione o conector recém-criado.

<figure><img src="/files/us6RWZImSszNcwlXsUHR" alt=""><figcaption></figcaption></figure>

4. Salve as alterações.

{% hint style="success" %}
Feito isso seu agente já está pronto para usar o logic app que foi criado, lembre sempre de ajustar as intruções do seu agente para que ele funcione de acordo com o logic app criado.
{% endhint %}