# 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FhCS2svPgzIGnQF1Acj0J%2Fimage.png?alt=media&#x26;token=cab11fc2-fbfd-4f16-8c34-0bd6e4f2c262" alt=""><figcaption></figcaption></figure>
3. Selecione a assinatura onde está instalado o Power omni.

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2F2T0jYTJYtUqJvDX9fd9X%2Fimage.png?alt=media&#x26;token=2b609a3c-847b-4c9d-b1dd-dcf336e134bd" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FJ2wZ8Tqzk1no1RglR0BI%2Fimage.png?alt=media&#x26;token=ceb9ba24-a4a0-451e-b04d-34838cb16424" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FKEw7AYcgydkNCvMW6J2V%2Fimage.png?alt=media&#x26;token=caba8c15-3607-40da-ac76-dcb6d43ace73" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FlViq2gqLaItR9zr7Uu8x%2Fimage.png?alt=media&#x26;token=1b2573d3-66cf-4028-9bde-3af20dcb9e5a" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2Fm2Ta2XmZweten4sUKL4M%2Fimage.png?alt=media&#x26;token=a295589b-3832-45ad-b975-4bd424ea5013" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FyrhMQjsQ0mVdxG0GoubX%2Fimage.png?alt=media&#x26;token=13fe284b-55fe-488d-a05b-c0e5b1d41dfa" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FpRBbP91HAMvM0st0ZndU%2Fimage.png?alt=media&#x26;token=0f21eb98-29ff-4beb-8da6-0cfd1e17a0ca" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FEI88H3wONdZnZLLOpHX8%2Fimage.png?alt=media&#x26;token=26889b8f-7cd9-4044-85d1-d5e376aeef69" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2F3HLbFnJ6O6J9j1Q2xrur%2Fimage.png?alt=media&#x26;token=30b3bee9-9d1e-4259-ac0c-0a399b1a474f" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FMleG2LJ15Ty0D1Er5bFP%2Fimage.png?alt=media&#x26;token=ce4d15eb-e06d-40e8-818c-46c89eb6eb8a" alt=""><figcaption></figcaption></figure>

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

  <figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FY6cPc1agEUPnzmyYI7RQ%2Fimage.png?alt=media&#x26;token=bd2a0307-1e2d-44fd-bc7f-0485a67fb720" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FBh1piwmAeEyrlkYBTaCY%2Fimage.png?alt=media&#x26;token=0edc4466-4711-43f6-b687-c63661d94864" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FblVte8mQlCDwXsnCv3wo%2Fimage.png?alt=media&#x26;token=d118e1b8-aa28-43bc-b1fa-e92b2ea0380f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FKBOSJRA61vl1I1ddrOfy%2Fimage.png?alt=media&#x26;token=39c3b57a-00b6-472b-90fc-fb4825ff8917" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FlhkOUFMEyj7JdawaBmva%2Fimage.png?alt=media&#x26;token=39311a32-c85d-4a9e-9c06-5e7e048a952d" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FXa4QqghDSkNYuG8BO5QQ%2Fimage.png?alt=media&#x26;token=450e7555-3466-43a1-a39d-94b9f6407e1e" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2Fxv4HGJIbR8IVgh1JOder%2Fimage.png?alt=media&#x26;token=f1e2b7cb-4bb6-4e1a-9482-138192db45c0" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FWYg1pISs8dRSIUvt5EOX%2Fimage.png?alt=media&#x26;token=9f0d8c07-3ae9-4093-b261-a330c56db3c0" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FEUNX7gYVwZbjf8hWLlW1%2Fimage.png?alt=media&#x26;token=b45a1d69-67dd-4692-84f7-08add3c4fb30" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FYWbKkgOm19IiJNXNYOlR%2Fimage.png?alt=media&#x26;token=28fa183a-3e66-46de-ad71-bfb0bdabba97" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FQx7OsBObte1Nvg1pLIkA%2Fimage.png?alt=media&#x26;token=7103cb4b-815c-4e18-910b-aa891e6574fa" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FfxbEq0SCqKIy8Sn314pj%2Fimage.png?alt=media&#x26;token=bd55ffca-16bf-4653-84c3-625f414cc396" 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 %}