Usar e migrar fluxos de trabalho do agente declarativo com Microsoft Foundry Toolkit

Use o Microsoft Foundry Toolkit para o Visual Studio Code para trabalhar com fluxos de trabalho declarativos existentes e prepará-los para a migração. Você pode testar um fluxo de trabalho salvo, editar seu YAML exportado e usar o GitHub Copilot para ajudar a converter a definição em código do Microsoft Agent Framework.

Importante

Os fluxos de trabalho declarativos no Microsoft Foundry estão em versão prévia e desativam-se em 1º de dezembro de 2026. Use o Microsoft Agent Framework para o desenvolvimento de novos fluxos de trabalho. Essa desativação não afeta a orquestração baseada em código em agentes hospedados. Consulte o guia de migração de fluxo de trabalho para caminhos de migração com suporte.

Pré-requisitos

Exibir um fluxo de trabalho de agente declarativo

Localize o fluxo de trabalho na lista de agentes consolidados do projeto.

  1. Na visualização Foundry Toolkit, em Meus Recursos, confirme o projeto do Foundry selecionado.
  2. Selecione Agentes e selecione a guia Fluxo de Trabalho .
  3. Selecione o nome do fluxo de trabalho para abrir seu respectivo playground.
  4. Use o seletor de versão para escolher a versão salva que você deseja inspecionar.

O playground mostra o grafo de fluxo de trabalho e uma área de conversa. O grafo é apenas para leitura. Use o YAML exportado ou o portal do Foundry para editar a definição.

Editar uma definição de fluxo de trabalho existente

Exporte a definição antes de editá-la ou migrá-la. Mantenha uma cópia do YAML original para que você possa compará-la com suas alterações.

  1. Abra o fluxo de trabalho existente no portal do Foundry.
  2. No designer de fluxo de trabalho, alterne para o modo de exibição YAML e copie ou exporte a definição. Para obter detalhes, consulte Exportar sua definição de fluxo de trabalho.
  3. Salve a definição em seu workspace local com um nome que termina em .workflow.yaml, como support.workflow.yaml.
  4. Abra o arquivo no Visual Studio Code e edite o YAML.
  5. Salve o arquivo. As alterações de arquivo local não atualizam o fluxo de trabalho na Foundry.

Salvar uma nova versão do fluxo de trabalho existente

Antes da desativação, você pode implantar uma definição editada para o mesmo fluxo de trabalho. Confirme o nome do projeto e do fluxo de trabalho para evitar a criação de um recurso diferente.

  1. Confirme se o projeto do fluxo de trabalho original está selecionado no Foundry Toolkit.
  2. Com o .workflow.yaml arquivo aberto, selecione Implantar na barra de ferramentas do editor.
  3. Em Inserir nome do fluxo de trabalho, insira o nome do fluxo de trabalho existente.
  4. Aguarde a notificação de êxito da implantação.
  5. Reabra o fluxo de trabalho doFluxo de Trabalho dos Agentes> e selecione a nova versão.

A implantação com um nome de fluxo de trabalho existente cria uma nova versão. Um nome diferente cria um fluxo de trabalho separado; não use esse caminho para iniciar o novo desenvolvimento de fluxo de trabalho.

Testar um fluxo de trabalho no playground

Teste a versão salva que você planeja manter ou migrar. Use as mesmas solicitações posteriormente para comparar a implementação migrada.

  1. Abra o playground do fluxo de trabalho e selecione a versão necessária.
  2. Na guia Playground , selecione Novo para iniciar uma nova sessão de playground.
  3. Insira uma solicitação que exerça o fluxo de trabalho e envie-o.
  4. Examine a resposta e o grafo de execução. Confirme se os agentes, as ramificações e as etapas esperadas estão em execução.
  5. Repita o processo com solicitações que percorram caminhos diferentes, entradas ausentes e eventuais etapas de aprovação no seu fluxo de trabalho.

O playground executa o fluxo de trabalho salvo do Foundry. Ele não executa alterações não salvas no arquivo YAML local ou no código que Copilot gera.

Converter um fluxo de trabalho YAML em código do Agent Framework

Use a ação de geração de código do playground para pedir ao GitHub Copilot para converter a definição de fluxo de trabalho selecionada. O código gerado é um ponto de partida que você deve examinar e testar.

  1. No playground de fluxo de trabalho, selecione a versão a ser migrada.
  2. Selecione Gerar Código.
  3. Escolha Python ou C#.
  4. Examine a solicitação de conversão no Copilot Chat e siga seus prompts para gerar o código.
  5. Examine o projeto, as dependências, as conexões de modelo, as ferramentas e a configuração de autenticação geradas.
  6. Compare sua orquestração com o YAML exportado. Verifique as etapas de ramificação, variáveis, chamadas de agente e aprovação humana.
  7. Execute o código localmente e teste-o com as solicitações usadas para o fluxo de trabalho original. Use o Inspetor do Agente para inspecionar a execução.
  8. Quando o código se comportar conforme necessário, siga Criar agentes hospedados para preparar um projeto de agente hospedado com suporte, implantá-lo e testar a versão implantada.

A conversão de código não implanta um agente hospedado nem garante um comportamento equivalente. Mantenha a definição original até concluir a migração e confirme se os aplicativos dependentes usam a substituição.

Use o Agent Inspector para inspecionar um fluxo de trabalho local do Agent Framework compatível. Para coletar spans desse código ou investigar um agente hospedado implantado, consulte Rastreamento no Foundry Toolkit. Essas etapas de inspeção local não substituem o playground remoto para um fluxo de trabalho declarativo.

Para outras opções de migração, incluindo YAML declarativo do Agent Framework, Aplicativos Lógicos do Azure e conexões A2A diretas, consulte o guia de migração de fluxo de trabalho.

Conteúdo relacionado

Use estes guias para escolher e concluir sua migração:

  • Última atualização em