Adicionar fluxos de trabalho de agentes declarativos no Visual Studio Code

Fluxos de trabalho declarativos de agentes definem sequências pré-definidas de ações para os seus agentes usando configurações em vez de lógica de programação explícita. Neste artigo, vai adicionar fluxos de trabalho do Foundry Agent a um agente e testá-los utilizando a extensão Microsoft Foundry para o Visual Studio Code.

Depois de construir um agente no Foundry Agent Service no portal, pode adicionar fluxos de trabalho para orquestrar múltiplos agentes em sequências de ações pré-definidas para cenários complexos de automação.

Pré-requisitos

• Um projeto Foundry com pelo menos um agente destacado. Para criar um no portal da Foundry, veja Quickstart: Conversar com um agente.
• Pelo menos um fluxo de trabalho criado no portal da Foundry. Para mais informações sobre fluxos de trabalho, consulte fluxos de trabalho do Foundry Agent.
• A extensão Microsoft Foundry para Visual Studio Code foi instalada.
• Uma subscrição GitHub Copilot (necessária para converter fluxos de trabalho YAML para código do Agent Framework).

Visualizar o fluxo de trabalho declarativo de agente

Para visualizar e editar um fluxo de trabalho declarativo de agente no VS Code for the Web, navegue primeiro até ao fluxo de trabalho no portal Foundry:

1. No portal Foundry, abra o seu projeto que contém o fluxo de trabalho.
2. Selecione o separador Workflows no menu esquerdo.
3. Seleciona o fluxo de trabalho que queres abrir.

Depois, escolha uma das seguintes opções para abrir o fluxo de trabalho no VS Code for the Web.

Abra o fluxo de trabalho YAML no VS Code for the Web

1. Selecione o separador Construir e depois selecione o botão YAML no lado direito.
2. Selecione o botão Abrir em VS Code para Web . O arquivo YAML do workflow é aberto no editor VS Code for the Web com a definição YAML à esquerda e um gráfico do fluxo de trabalho visual à direita.
3. Editar o YAML conforme necessário para modificar o fluxo de trabalho. As alterações refletem-se no editor visual.
4. Quando terminares, seleciona Deploy no menu de elipse (...) no canto superior direito para guardar as alterações de volta no Foundry.

Abra o código de fluxo de trabalho a partir do portal Foundry

1. Selecione o separador Construir e depois selecione o botão de Código no lado direito.
2. Selecione o botão Abrir em VS Code para a Web . O ficheiro do código do fluxo de trabalho abre no editor VS Code for the Web com a definição do código à esquerda e o gráfico visual do fluxo de trabalho à direita.
3. Edita o código conforme necessário para modificar o fluxo de trabalho. As alterações refletem-se no editor visual.
4. Quando terminares, seleciona Deploy no menu de elipse (...) no canto superior direito para guardar as alterações de volta no Foundry.

Testar um fluxo de trabalho no recreio

Teste o seu fluxo de trabalho de agente declarativo usando o remote agent playground na extensão Microsoft Foundry Toolkit for Visual Studio Code.

1. Na secção My Resources do Microsoft Foundry Toolkit para Visual Studio Code extensão, localize e selecione o seu projeto Foundry.
2. Selecione Agentes Declarativos.
3. Seleciona a versão do fluxo de trabalho que queres testar.
4. O painel do Remote Agent Playground abre e inicia uma conversa com o seu agente.
5. Na caixa de entrada no fundo do painel do Remote Agent Playground , escreva uma mensagem e pressione Enter.
6. Revise a resposta do agente. Verifique se a resposta corresponde ao comportamento esperado para as ações definidas pelo seu fluxo de trabalho.

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

Para personalizar os seus fluxos de trabalho baseados em YAML, converta-os para código Agent Framework com o GitHub Copilot.

1. Abre o ficheiro YAML do workflow no VS Code.
2. Selecione o botão Gerar Código no canto superior direito do editor YAML.
3. Selecione a linguagem de programação onde quer gerar o código (Python ou C#). O GitHub Copilot abre um painel com prompts de geração de código para a linguagem selecionada e gera código do Agent Framework com base na definição YAML.
4. Quando GitHub Copilot perguntar se queres executar o código gerado localmente, seleciona Sim para abrir o visualizador local. Pode ver cada passo enquanto o agente executa as ações.
5. Revise e modifique o código gerado conforme necessário para se adequar aos seus requisitos.
6. Clique com o botão direito no ficheiro de código gerado e selecione Deploy to Foundry para implementar o código no seu projeto Foundry.
7. No portal Foundry, navegue até ao seu projeto e verifique se o código aparece na secção de Agentes .

Conteúdo relacionado

• Fluxos de trabalho do Foundry Agent