Use e migre fluxos de trabalho de agentes declarativos com o Microsoft Foundry Toolkit

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

Importante

Os fluxos de trabalho declarativos no Microsoft Foundry estão em pré-visualização e serão retirados a 1 de dezembro de 2026. Use o Microsoft Agent Framework para desenvolvimento de novos fluxos de trabalho. Esta aposentação não afeta a orquestração baseada em código nos agentes alojados. Consulte o guia de migração do fluxo de trabalho para os caminhos de migração suportados.

Pré-requisitos

Visualizar um workflow de agente declarativo

Encontre o fluxo de trabalho na lista consolidada de agentes do seu projeto.

  1. Na vista Foundry Toolkit, em Os meus recursos, confirme o projeto Foundry selecionado.
  2. Selecione Agentes e depois selecione o separador Workflow.
  3. Selecione o nome do fluxo de trabalho para abrir o seu playground.
  4. Use o seletor de versões para escolher a versão guardada que quer inspecionar.

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

Editar uma definição de fluxo de trabalho existente

Exporte a definição antes de a editar ou migrar. Guarda uma cópia do YAML original para poderes comparar com as tuas alterações.

  1. Abra o fluxo de trabalho existente no portal Foundry.
  2. No designer de workflow, muda para a vista YAML e copia ou exporta a definição. Para mais detalhes, consulte Exportar a definição do seu fluxo de trabalho.
  3. Guarde a definição no seu espaço de trabalho local com um nome terminado em .workflow.yaml, como support.workflow.yaml.
  4. Abra o ficheiro no Visual Studio Code e edite o YAML.
  5. Salve o arquivo. As alterações locais de ficheiros não atualizam o fluxo de trabalho no Foundry.

Guardar uma nova versão do fluxo de trabalho existente

Antes da desativação, pode implementar uma definição editada para o mesmo fluxo de trabalho. Confirme o nome do projeto e do fluxo de trabalho para evitar criar um recurso diferente.

  1. Confirme que o projeto do fluxo de trabalho original está selecionado no Foundry Toolkit.
  2. Com o .workflow.yaml ficheiro aberto, selecione Implementar na barra de ferramentas do editor.
  3. Em Introduzir nome do fluxo de trabalho, introduza o nome do fluxo de trabalho existente.
  4. Aguarde pela notificação de sucesso da implantação.
  5. Volte a abrir o fluxo de trabalho em Agentes>Fluxo de trabalho e selecione a nova versão.

A implementação com um nome de workflow existente cria uma nova versão. Um nome diferente cria um fluxo de trabalho separado; não uses este caminho para iniciar o desenvolvimento de novos fluxos de trabalho.

Testar um fluxo de trabalho no recreio

Testa a versão guardada que planeias manter ou migrar. Use os mesmos pedidos mais tarde para comparar a implementação migrada.

  1. Abra o ambiente de teste do fluxo de trabalho e selecione a versão pretendida.
  2. No separador Playground , selecione Novo para iniciar uma nova sessão de playground.
  3. Introduz um pedido que exercite o fluxo de trabalho e envie-o.
  4. Revê a resposta e o gráfico de execução. Confirma que os agentes, ramificações e passos esperados funcionam.
  5. Repita com solicitações que percorram diferentes percursos, dados em falta e eventuais etapas de aprovação no seu fluxo de trabalho.

O playground executa o fluxo de trabalho guardado do Foundry. Não executa alterações não guardadas no teu ficheiro YAML local nem no código que o Copilot gera.

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

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

  1. No ambiente de teste do fluxo de trabalho, selecione a versão a migrar.
  2. Selecione Gerar Código.
  3. Escolhe Python ou C#.
  4. Revise o pedido de conversão no Copilot Chat e siga as suas instruções para gerar o código.
  5. Revise o projeto gerado, dependências, ligações ao modelo, ferramentas e configuração de autenticação.
  6. Compare a sua orquestração com a YAML exportada. Verifique as ramificações, as variáveis, as chamadas de agentes e as etapas de aprovação humana.
  7. Executa o código localmente e testa-o com os pedidos que usaste para o fluxo de trabalho original. Use o Agente Inspetor para inspecionar a execução.
  8. Quando o código se comporta como necessário, siga o Create hosted agents para preparar um projeto de hosted-agent suportado, implementá-lo e testar a versão implementada.

A conversão de código não implementa um agente hospedado nem garante um comportamento equivalente. Mantém a definição original até completares a migração e confirmares que as aplicações dependentes usam o substituto.

Utilize o Agent Inspector para inspecionar um fluxo de trabalho local suportado pelo Agent Framework. Para recolher spans desse código ou investigar um agente alojado que foi implementado, consulte Rastreio no Foundry Toolkit. Estes passos 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, Azure Logic Apps e ligações diretas A2A, consulte o guia de migração de fluxos de trabalho.

Conteúdo relacionado

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

  • Última atualização a