> 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 %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.poweromni.ai/administracao-e-configuracao/artefatos/conectores/logic-apps.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.