Executar fluxos de trabalho de automação de ações em agentes com o Azure AI Foundry e os Aplicativos Lógicos do Azure (versão prévia)

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-se a 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 a 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 usa um gatilho predefinido e ações de uma galeria com mais de 1.400 conectores, juntamente com operações nativas de runtime ou "internas".

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 na Fábrica de IA do Azure para que ele crie um fluxo de trabalho de aplicativo lógico de consumo que seja executado nos Aplicativos Lógicos do Azure multilocatário. 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 saber mais, confira a seguinte documentação:

• o que é o Azure AI Foundry?
• O que são Aplicativos Lógicos do Azure?
• Fluxo de trabalho do aplicativo lógico de consumo – opções de hospedagem

Pré-requisitos

• Uma conta e uma assinatura do Azure. Se você não tiver uma assinatura do Azure, inscreva-se em uma conta gratuita do Azure.

• 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 do privilégio mínimo:

  • Colaborador (privilégio mínimo)

  • Proprietário

  Se você tiver qualquer outra função, precisará ter o hub criado para você. Para saber mais, confira a seguinte documentação:

  • Funções padrão para projetos

  • Funções padrão para hubs

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

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

• Um agente em 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 aplicativo lógico por meio da galeria de ações no portal do Azure AI Foundry, seus fluxos de trabalho precisam atender aos seguintes requisitos:

• O recurso de aplicativo lógico 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 denominado Quando uma solicitação HTTP é recebida gatilho.

• 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 você a gerenciar, moldar, converter e transformar dados. Se nenhum conector predefinido existir para o que você deseja fazer, você também poderá criar o seu próprio.

Para saber mais, confira a seguinte documentação:

• Início Rápido: Criar um exemplo de fluxo de trabalho de aplicativo lógico de consumo usando o portal do Azure
• O que são os conectores nos Aplicativos Lógicos do Azure
• Conectores gerenciados executados no Azure global multilocatário
• Referência técnica de conectores gerenciados para Aplicativos Lógicos do Azure
• Operações internas executadas com o runtime dos Aplicativos Lógicos do Azure
• 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 o 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, selecioneAgentes. Na página Agentes , em Meus agentes, selecione seu agente.

   

3. Na seção Instalaçã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 Selecionar uma ação, selecione uma ação predefinida com um dos seguintes rótulos:

   Rótulo da ação	Descrição
   Criado pela Microsoft	Essa ação usa um modelo criado pela Microsoft para criar o fluxo de trabalho para a ação.
   Fluxo de trabalho	Essa 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. Observação: se você selecionar essa opção, vá para a seção chamada Confirmar detalhes da ação. Se os fluxos de trabalho não aparecerem conforme o esperado na galeria de ações, verifique os requisitos.

   O exemplo a seguir usa a ação de criação da Microsoft chamada Obtenha a previsão do tenho para hoje via MSN Clima:

   

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

   Parâmetro	Obrigatório	Valor	Descrição
   Seu nome de ação	Sim	< nome da ação>	Um nome amigável, mas focado na tarefa, com o verbo em destaque para mostrar a ação. Esse nome também é usado para o recurso de 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 um fluxo de trabalho são combinados e têm uma relação individual, portanto, usam o mesmo nome. Em comparação, um recurso de aplicativo lógico Standard pode ter vários fluxos de trabalho que usam nomes diferentes. Este exemplo usa Get-weather-forecast-today.
   Sua descrição da ação	Sim	< action-description>	Uma descrição que descreve claramente a finalidade da ação. Este exemplo usa Essa ação cria um fluxo de trabalho de aplicativo lógico de consumo que obtém a previsão do tempo para hoje e é executado em Aplicativos Lógicos do Azure globais e multilocatário.
   Subscrição	Sim	< Assinatura 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.
   Localidade	Sim	< Região do Azure>	A região do Azure em que hospedar o recurso de aplicativo lógico e o fluxo de trabalho.

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

   

7. Quando terminar, clique em Avançar.

Criar e autenticar conexões

Siga estas etapas para criar quaisquer conexões de que a ação precise 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 Adicionar ação do Aplicativo Lógico , em Autenticar, examine todas as conexões necessárias para criar e autenticar.

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

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

   

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

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

4. Quando terminar, clique em Avançar.

Confirmar detalhes da ação

Examine e verifique se todas as informações de ação aparecem corretas. Se você selecionou uma ação de criação da Microsoft, examine e concorde com a declaração de confirmação.

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

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

   1. Revise a declaração que você reconhece e entende os seguintes eventos que ocorrem após você sair da página Recurso selecionando Avançar:

      • Você não pode retornar às etapas anteriores.

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

      • Conectar-se aos Aplicativos Lógicos do Azure incorre em encargos em sua conta do Azure.

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

        • Medição de uso, cobrança 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, examine 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 não da Microsoft.

1. Na janela Adicionar Aplicativo Lógico , na página Esquema , examine as seguintes informações e forneça uma descrição sobre as circunstâncias para chamar a ferramenta:

   Parâmetro	Descrição
   Nome da ferramenta	O nome editável para a ferramenta que o agente usa para executar sua ação e acessar o Azure, 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 de 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 recursos externos, da Microsoft e do Azure sem precisar solicitar credenciais todas as vezes. Para obter mais informações, confira Conexões no portal do Azure AI Foundry.
   Descrever como invocar a ferramenta	A descrição que especifica as circunstâncias quando o agente chama a ferramenta.
   Esquema	O esquema do fluxo de trabalho do aplicativo lógico no formato JSON (JavaScript Object Notation).

   

2. Quando estiver pronto, selecione Criar.

   O portal retorna você para a 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 experimentar a nova ação para seu agente usando o Playground de agentes, siga estas etapas:

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

2. Na página Playground de agentes, na caixa de chat de consulta do usuário, faça uma pergunta sobre o clima, por exemplo:

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

   O agente retorna uma resposta semelhante ao seguinte exemplo:

   

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

Depois que a ação for executada, você poderá exibir o recurso de aplicativo lógico subjacente e o fluxo de trabalho no portal do Azure. Você pode examinar 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. Entre no portal do Azure. Na caixa de pesquisa da barra de título do portal, insira o nome da ação que você criou.

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

   

3. Para exibir o histórico de execuções, 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ções.

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

   

5. Depois que o modo de exibição de monitoramento for aberto e mostrar o status de cada operação no fluxo de trabalho, selecione uma operação para abrir o painel de informações e examinar 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ções de fluxo de trabalho, consulte Exibir o status do fluxo de trabalho e o histórico de execuções.

Abrir fluxo de trabalho no designer

Siga estas etapas para examinar a definição e as operações do fluxo de trabalho ou editar 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 examinar as operações do fluxo de trabalho, que se referem ao gatilho e às ações, por exemplo:

   

2. Para exibir os parâmetros e as 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 sempre deve atender aos seguintes requisitos:

   • O recurso de aplicativo lógico 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 acionador Quando uma solicitação HTTP é recebida.

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

   Cuidado

   Embora você possa adicionar ações e alterar o fluxo de trabalho, não edite o gatilho e as ações originais para evitar a interrupção da relação entre o fluxo de trabalho, o agente e a ação. Seus parâmetros são configurados para funcionar em conjunto, portanto, as alterações nessas operações correm o risco de interromper a ação no 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 chamar o gatilho:

   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 executada pelo gatilho.
   HTTPS URL	Quando o fluxo de trabalho é salvo pela primeira vez, essa URL é gerada e usada para chamar 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 especificará 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 meteorológico ou para testar um fluxo de trabalho diferente, siga estas etapas:

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

2. Depois que o painel Executar com carga for aberto, no campo Corpo, forneça as entradas de gatilho esperadas 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 a 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ções do fluxo de trabalho para que você possa examinar as entradas e saídas de cada operação usando as etapas relevantes em Examinar o aplicativo lógico subjacente e o fluxo de trabalho.

Cobrança e preços

Os fluxos de trabalho dos aplicativos logísticos de consumo incorrem em encargos com base no modelo de cobrança "pague conforme o uso". Para obter mais informações sobre esse modelo, consulte os seguintes recursos:

• Medição de uso, cobrança 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 do Azure AI Foundry
• Preços do Azure AI Foundry

Limpar os recursos

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

1. Para remover a ação do agente no Portal da Fábrica de IA do Azure, ao lado do nome da ação, selecione o botão de reticências (...) e 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 implantado.

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

5. Quando o painel de confirmação for exibido, 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 são Aplicativos Lógicos do Azure?