Executar fluxos de trabalho de automação a partir de ações em agentes com Azure AI Foundry e Azure Logic Apps (pré-visualização)

Aplica-se a: Aplicativos Lógicos do Azure (Consumo)

Quando você tem um aplicativo de IA no Azure AI Foundry que precisa automatizar processos de várias etapas ou integrar com vários serviços, sistemas, aplicativos e fontes de dados, você pode adicionar ações em agentes para executar fluxos de trabalho de automação nos Aplicativos Lógicos do Azure.

No Azure AI Foundry, um agente usa uma ação e um modelo de IA para concluir uma tarefa de forma autônoma ou interativa. Por exemplo, os agentes usam ações para responder perguntas, obter informações e executar outros trabalhos usando modelos de IA.

Nos Aplicativos Lógicos do Azure, um fluxo de trabalho de aplicativo lógico automatiza processos e pode integrar o Azure, a Microsoft e serviços, sistemas, aplicativos e fontes de dados em outros ecossistemas, geralmente sem nenhum código extra. O fluxo de trabalho utiliza um gatilho pré-definido e ações da galeria com 1.400+ conectores, juntamente com operações nativas de tempo de execução ou "integradas".

O diagrama a seguir mostra como uma ação em um agente no Azure AI Foundry se relaciona com um fluxo de trabalho de aplicativo lógico nos Aplicativos Lógicos do Azure:

Este guia mostra como adicionar uma ação a um agente no Azure AI Foundry para que o agente crie um fluxo de trabalho de aplicação lógica do tipo Consumption que é executado em ambiente de multilocação dos Aplicativos Lógicos do Azure. Um assistente orienta você pelas etapas para configurar essa ação com um fluxo de trabalho de aplicativo lógico predefinido. Depois de concluir a adição da ação, você pode estender esse fluxo de trabalho, com base nas necessidades do seu cenário, usando o designer gráfico nos Aplicativos Lógicos do Azure.

Para obter mais informações, veja a seguinte documentação:

• O que é o Azure AI Foundry?
• O que é o Azure Logic Apps?
• Fluxo de trabalho do aplicativo lógico de consumo - Opções de hospedagem

Pré-requisitos

• Uma conta Azure e uma assinatura. Se não tiver uma subscrição do Azure, inscreva-se para obter uma conta do Azure gratuita.

• Um projeto do Azure AI Foundry, que é criado com um hub padrão.

  Este projeto organiza seu trabalho e salva o estado enquanto você cria seus aplicativos de IA. O hub hospeda seu projeto e fornece um ambiente de colaboração em equipe.

  Para criar um projeto com um hub, você precisa de uma das seguintes funções para o RBAC (controle de acesso baseado em função) do Microsoft Entra, com base no princípio de menor privilégio:

  • Contribuidor (privilégio mínimo)

  • Proprietário

  Se você tiver qualquer outra função, precisará ter o hub criado para você. Para obter mais informações, veja a seguinte documentação:

  • Funções padrão para projetos

  • Funções padrão para hubs

• Um modelo de Serviço OpenAI do Azure implantado para seu projeto.

  Se você não tiver um modelo implantado, consulte Implantar um modelo.

• Um agente no seu projeto.

  Esse requisito inclui a implantação de um modelo no Serviço OpenAI do Azure para o agente usar enquanto o fluxo de trabalho é executado.

Posso criar e usar meus próprios fluxos de trabalho como ações?

Sim, para disponibilizar seus próprios fluxos de trabalho de aplicativos lógicos por meio da galeria de ações no portal do Azure AI Foundry, seus fluxos de trabalho precisam atender aos seguintes requisitos:

• O recurso da aplicação lógica que contém o fluxo de trabalho usa a opção de hospedagem Consumo.

• O recurso de aplicativo lógico usa a mesma assinatura do Azure que você usa com o Azure AI Foundry.

• O fluxo de trabalho começa com o gatilho chamado Quando um pedido HTTP é recebido.

• O gatilho inclui uma descrição, que você fornece no painel de informações do gatilho no designer de fluxo de trabalho.

• O fluxo de trabalho termina com a ação Resposta.

Seu aplicativo de IA tem opções quase infinitas para executar fluxos de trabalho que interagem com o Azure, a Microsoft e outros serviços ou produtos, além de operações que ajudam a gerenciar, moldar, converter e transformar dados. Se não existir nenhum conector pré-construído para o que você deseja fazer, você também pode criar o seu próprio.

Para obter mais informações, veja a seguinte documentação:

• Guia de início rápido: criar um exemplo de fluxo de trabalho do aplicativo lógico de consumo usando o portal do Azure
• O que são conectores nos Aplicativos Lógicos do Azure
• Conectores gerenciados que são executados no Azure global e multilocatário
• Referência técnica de conectores gerenciados para Aplicativos Lógicos do Azure
• Operações integradas que são executadas com o tempo de execução do Azure Logic Apps
• Conectores personalizados nos Aplicativos Lógicos do Azure

Limitações e problemas conhecidos

Esta versão tem as seguintes limitações ou problemas conhecidos:

Adicionar uma ação ao seu agente

Siga estas etapas para configurar uma ação para seu agente criar e executar um fluxo de trabalho de aplicativo lógico.

1. Entre no portal do Azure AI Foundry e abra seu projeto.

2. Na visão geral do projeto, no menu de navegação do portal, em Criar e personalizar, selecione Agentes. Na página Agentes , em Meus agentes, selecione seu agente.

   

3. Na seção Configuração ao lado da lista de agentes, role para baixo até a seção Ações e selecione Adicionar.

   

4. Na janela Adicionar ação , selecione Aplicativos Lógicos do Azure.

   

5. Em Selecione uma ação, selecione uma ação predefinida com um dos seguintes rótulos:

   Rótulo de ação	Descrição
   De autoria da Microsoft	Esta ação usa um modelo criado pela Microsoft para criar o fluxo de trabalho para a ação.
   Fluxo de Trabalho	Esta ação usa um fluxo de trabalho de aplicativo lógico qualificado em sua assinatura do Azure como um modelo para criar o fluxo de trabalho para a ação. Nota: Se selecionar esta opção, avance para a secção denominada Confirmar detalhes da ação. Se seus fluxos de trabalho não aparecerem como esperado na galeria de ações, verifique os requisitos.

   O exemplo a seguir usa a ação criada pela Microsoft chamada Obter previsão do tempo para hoje via MSN Weather:

   

6. Na janela de ação Adicionar Aplicativo Lógico , em Inserir algumas informações básicas, forneça as seguintes informações:

   Parâmetro	Obrigatório	Valor	Descrição
   O nome da sua ação	Sim	< nome-ação>	Um nome amigável, mas focado na tarefa, que coloque o verbo em primeiro lugar e seja conciso para a ação. Esse nome também é usado para o recurso do aplicativo lógico e o fluxo de trabalho nos Aplicativos Lógicos do Azure. Observação: - O nome da ação pode usar apenas letras, números e os seguintes caracteres especiais: -, (, ), _, ou '. - Você não pode usar espaço em branco ou outros caracteres especiais. - Um recurso de aplicativo lógico de consumo e fluxo de trabalho são combinados e têm uma relação 1:1, então eles usam o mesmo nome. Em comparação, um recurso de aplicativo lógico padrão pode ter vários fluxos de trabalho que usam nomes diferentes. Este exemplo usa Get-weather-forecast-today.
   Descrição da sua ação	Sim	< descrição da ação>	Uma descrição que descreva claramente o objetivo da ação. Este exemplo usa uma ação que cria um fluxo de trabalho chamável de aplicação lógica de Consumo, que obtém a previsão do tempo para hoje e é executado em aplicações lógicas do Azure globais e multicliente.
   Subscrição	Sim	< Subscrição do Azure>	A assinatura do Azure a ser usada, presumivelmente a mesma que seu projeto e modelo.
   Grupo de recursos	Sim	< Azure-resource-group>	O grupo de recursos do Azure a ser usado.
   Localização	Sim	< Azure-region>	A região do Azure onde hospedar o recurso e o fluxo de trabalho do aplicativo lógico.

   A captura de ecrã a seguir mostra os detalhes da ação de exemplo Get-weather-forecast-today:

   

7. Quando terminar, selecione Avançar.

Criar e autenticar conexões

Siga estas etapas para criar as conexões necessárias à ação e autenticar o acesso aos serviços, sistemas, aplicativos ou fontes de dados relevantes. O modelo subjacente especifica os conectores a serem usados para essa ação e o fluxo de trabalho do aplicativo lógico.

1. Na janela de ação Adicionar Aplicativo Lógico , em Autenticar, revise todas as conexões que você precisa criar e autenticar.

2. Na coluna Conexão , selecione Conectar para o serviço relacionado ou fonte de dados.

   A captura de tela a seguir mostra o exemplo de conexão para criar e autenticar para o serviço MSN Meteorologia:

   

   Algumas conexões exigem mais detalhes, portanto, siga as instruções para fornecer as informações solicitadas.

3. Para cada conexão necessária, repita estas etapas.

4. Quando terminar, selecione Avançar.

Confirmar detalhes da ação

Revise e verifique se todas as informações da ação parecem corretas. Se você selecionou uma ação de autoria da Microsoft, revise e concorde com a declaração de confirmação.

1. Na janela Adicionar Ação de Aplicativo Lógico, em Recurso, verifique todas as informações de ação fornecidas.

2. Para uma ação autorizada pela Microsoft selecionada, conclua as seguintes etapas:

   1. Revise a declaração em que reconhece e compreende os seguintes eventos que ocorrem depois de sair da página Recurso, selecionando Seguinte.

      • Não é possível retornar às etapas anteriores.

      • A ação cria um recurso de aplicativo lógico de consumo.

      • A ligação às Aplicações Lógicas do Azure incorre em encargos na sua conta do Azure.

        Para obter mais informações sobre o modelo de faturamento para fluxos de trabalho do aplicativo lógico de consumo, consulte a seguinte documentação:

        • Medição de uso, faturamento e preços

        • Preços dos Aplicativos Lógicos do Azure (Plano de Consumo - Multilocatário)

   2. Para consentir, selecione a caixa de confirmação, por exemplo:

      

3. Quando estiver pronto, selecione Avançar

Concluir a criação da ação

Para a etapa final, revise as informações que o portal gera sobre a ferramenta usada pelo agente para executar sua ação e autenticar o acesso a quaisquer serviços ou recursos relevantes do Azure, da Microsoft e que não sejam da Microsoft.

1. Na janela Adicionar Ação do Aplicativo Lógico, na página Esquema, revise as seguintes informações e certifique-se de fornecer uma descrição sobre as circunstâncias para a utilização da ferramenta.

   Parâmetro	Descrição
   Nome da ferramenta	O nome editável da ferramenta que o agente usa para executar sua ação e acessar o Azure, a Microsoft, serviços externos, fontes de dados ou modelos de IA especializados para que o agente possa obter dados, executar tarefas e interagir com outras plataformas. Observação: - O nome da ação pode usar apenas letras, números e o caractere sublinhado (_). - Você não pode usar espaço em branco ou outros caracteres especiais.
   Conexão para autenticação	O nome somente leitura para a conexão que o agente usa para acessar o Azure, a Microsoft e recursos externos sem precisar pedir credenciais sempre. Para obter mais informações, consulte Conexões no portal do Azure AI Foundry.
   Descrever como invocar a ferramenta	A descrição que especifica as circunstâncias de quando o agente chama a ferramenta.
   Esquema	O esquema para o fluxo de trabalho do aplicativo lógico no formato JSON (JavaScript Object Notation).

   

2. Quando estiver pronto, selecione Criar.

   O portal retorna você à página Agentes do agente selecionado. Na seção Instalação , a seção Ações agora mostra o nome da ferramenta que executa sua ação e exibe o ícone dos Aplicativos Lógicos do Azure ao lado do nome da ferramenta, por exemplo:

   

Testar a ação do agente

Para tentar a nova ação para o seu agente usando a Área de Teste de Agentes, siga estas etapas:

1. Na página Agentes, na parte superior da seção Configuração, selecione Testar no playground.

2. Na página Agentes playground, na caixa de chat de consulta do utilizador, pergunte sobre o tempo, por exemplo:

   Qual é o tempo em Londres? Mostrar os resultados em formato de lista de marcadores.

   O agente retorna uma resposta semelhante ao exemplo a seguir:

   

Revisar o aplicativo lógico subjacente e o fluxo de trabalho

Depois que a ação for executada, você poderá exibir o recurso e o fluxo de trabalho do aplicativo lógico subjacente no portal do Azure. Você pode revisar o histórico de execução do fluxo de trabalho, que pode ser usado para depurar ou solucionar problemas que o fluxo de trabalho pode enfrentar.

1. Inicie sessão no portal Azure. Na caixa de pesquisa da barra de título do portal, digite o nome da ação que você criou.

2. Na lista de resultados, em Recursos, selecione o recurso do aplicativo lógico.

   

3. Para exibir o histórico de execução, entradas, saídas e outras informações do fluxo de trabalho, no menu do aplicativo lógico, em Ferramentas de Desenvolvimento, selecione Histórico de execução.

4. Na lista Histórico de execução , selecione a execução mais recente do fluxo de trabalho, por exemplo:

   

5. Depois que a exibição de monitoramento for aberta e mostrar o status de cada operação no fluxo de trabalho, selecione uma operação para abrir o painel de informações e revise as entradas e saídas da operação.

   Este exemplo seleciona a ação chamada Obter previsão para hoje, por exemplo:

   

   Para obter mais informações sobre o histórico de execução do fluxo de trabalho, consulte Exibir status do fluxo de trabalho e histórico de execução.

Abrir fluxo de trabalho no designer

Siga estas etapas para revisar a definição e as operações do fluxo de trabalho ou edite o fluxo de trabalho abrindo o designer de fluxo de trabalho.

1. No menu do aplicativo lógico, em Ferramentas de Desenvolvimento, selecione o designer.

   O fluxo de trabalho é aberto no designer. Agora você pode revisar as operações do fluxo de trabalho, que se referem ao gatilho e às ações, por exemplo:

   

2. Para visualizar os parâmetros e configurações de uma operação, no designer, selecione a operação, por exemplo:

   

3. Para expandir o comportamento do fluxo de trabalho, você pode adicionar mais ações seguindo as etapas em Criar um fluxo de trabalho com um gatilho ou ação.

   Para que esse fluxo de trabalho ou qualquer outro fluxo de trabalho apareça na galeria de ações e seja executado como uma ação em um agente, o fluxo de trabalho deve sempre atender aos seguintes requisitos:

   • O recurso da aplicação lógica que contém o fluxo de trabalho deve usar a opção de hospedagem Consumo.

   • O recurso de aplicativo lógico deve usar a mesma assinatura do Azure que você usa com o Azure AI Foundry.

   • O fluxo de trabalho deve começar com o gatilho Quando um pedido HTTP é recebido.

   • O gatilho requer uma descrição, que você pode encontrar no painel de informações do gatilho no designer.

   • O fluxo de trabalho deve terminar com a ação Resposta.

   Atenção

   Embora você possa adicionar ações e alterar o fluxo de trabalho, não edite o gatilho e as ações originais para evitar quebrar a relação entre o fluxo de trabalho, o agente e a ação. Os seus parâmetros são configurados para trabalhar juntos, de modo que as mudanças nessas operações podem comprometer a função do agente. Em vez disso, considere criar uma versão personalizada ou um fluxo de trabalho diferente que você pode adicionar como uma ação a um agente.

   Por exemplo, o gatilho usa os seguintes parâmetros, que são necessários para chamá-lo:

   Parâmetro	Descrição
   Nome	Esse nome faz parte da URL HTTPS do gatilho. Chamadores externos, como outros serviços, fora do fluxo de trabalho enviam uma solicitação HTTPS para essa URL, que dispara o gatilho e inicia o fluxo de trabalho. O gatilho é sempre a primeira etapa em um fluxo de trabalho e especifica a condição a ser atendida para que o gatilho seja executado.
   HTTPS URL	Quando o fluxo de trabalho é guardado pela primeira vez, essa URL é gerada e usada para invocar um endpoint que o gatilho cria para o fluxo de trabalho.
   Método	Essa configuração especifica se o gatilho aceita todos ou apenas métodos HTTPS específicos.
   Esquema JSON do corpo da solicitação	Se você quiser validar a entrada que o gatilho espera receber na solicitação HTTPS enviada de chamadores externos, esse esquema especifica o esquema JSON a ser usado para validar essa entrada.

4. Para salvar as alterações feitas, na barra de ferramentas do designer, selecione Salvar.

Testar um fluxo de trabalho no designer

Se você fez alterações no fluxo de trabalho de clima ou para testar um fluxo de trabalho diferente, siga estas etapas:

1. Na barra de ferramentas do designer, selecione Executar>Executar com carga.

2. Depois de o painel Executar com carga útil ser aberto, no campo Corpo, forneça os dados de entrada esperados no formato JSON, por exemplo:

   {
       "location": {
           "type": "London",
           "description": "Location for the weather"
       }
   }
   

3. Quando estiver pronto, selecione Executar.

   Na guia Saída, o Corpo da Resposta contém os resultados e resposta do fluxo de trabalho.

4. Se a execução do fluxo de trabalho produzir erros ou exigir solução de problemas, abra o histórico de execução do fluxo de trabalho para que você possa examinar as entradas e saídas de cada operação usando as etapas relevantes em Revisar o aplicativo lógico subjacente e o fluxo de trabalho.

Faturação e preços

Os fluxos de trabalho da aplicação lógica de consumo incorrem em encargos com base no modelo de faturação "pay-for-use". Para obter mais informações sobre esse modelo, consulte os seguintes recursos:

• Medição de uso, faturamento e preços
• Preços dos Aplicativos Lógicos do Azure (Plano de Consumo - Multilocatário)

Para o Azure AI Foundry, consulte os seguintes recursos:

• Planejar e gerenciar custos para o Azure AI Foundry
• Preços do Azure AI Foundry

Limpeza de recursos

Se não precisar dos recursos que criou para este guia, elimine os recursos para não continuar a ser cobrado. Você pode seguir estas etapas para excluir o grupo de recursos que contém esses recursos ou pode excluir cada recurso individualmente.

1. No portal do Azure AI Foundry, para remover a ação do agente, ao lado do nome da ação, selecione o botão de reticências (...) e depois selecione Remover.

2. Na caixa de pesquisa da barra de título do portal do Azure , insira grupos de recursos e selecione Grupos de recursos.

3. Localize o grupo de recursos que contém os recursos do hub implantados.

4. Na barra de ferramentas da página Visão geral , selecione Excluir grupo de recursos.

5. Quando o painel de confirmação aparecer, insira o nome do grupo de recursos e selecione Excluir.

Conteúdo relacionado

• O que são conectores nos Aplicativos Lógicos do Azure?
• O que é o Azure AI Foundry?
• O que é o Azure Logic Apps?