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 e faça login.

2. No campo de busca, pesquise por "Assinaturas" (Subscriptions).

   
3. Selecione a assinatura onde está instalado o Power omni.

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

1. Pesquise por "Logic App" e selecione a Logic Apps Standard Contributor e clique em Próximo

   
2. Na próxima tela (Membros), clique em "+ Selecionar membros", e procure por Power Omni, após encontrar pode selecionar e avançar

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

2. Pesquise por "Logic Apps" e clique em "Criar".

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

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

• É 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.

• Após preencher é só clicar em Revisar + Criar e posteriormente clicar em criar.

• Só aguardar a implantação.

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

  

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

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

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

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

2. Ações: Adicione as ações necessárias (ex: conectar-se a um sistema via API, enviar e-mail, buscar dados, etc.).

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

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

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.

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

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

1. Verifique se o Schema foi configurado automáticamente.

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

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

1. Salve as alterações.

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.