Criar um agente com Microsoft Foundry Toolkit para Visual Studio Code

Use Microsoft Foundry Toolkit para Visual Studio Code para configurar um agente de prompt ou desenvolver um agente hospedado baseado em código. Escolha uma rota de criação com base em se as instruções e as ferramentas compatíveis atendem às suas necessidades ou se você precisa de uma lógica de runtime personalizada.

Pré-requisitos

Escolher um tipo de agente

A Foundry dá suporte a agentes de prompt e agentes hospedados. Ambos os tipos de agente podem usar ferramentas e integrar-se a aplicativos. Os agentes baseados em prompts não se limitam a protótipos.

Compare Agente de prompt Agente hospedado
Definir comportamento Configure um modelo, instruções e ferramentas com suporte. Implemente a lógica personalizada com uma estrutura ou seu próprio código.
Use-o para Tarefas que podem ser realizadas por instruções e ferramentas compatíveis, como responder perguntas ou resumir documentos. Orquestração personalizada, dependências ou comportamento em tempo de execução, como um fluxo de trabalho multiagente.
O que você mantém A configuração do agente e as versões salvas. O código do agente, as dependências, o empacotamento e a configuração de implantação.
Por onde começar Construtor de Agentes. Exemplos de agente hospedado ou programação assistida pelo Copilot.

Comece com um agente de prompt quando suas opções de configuração atenderem às suas necessidades. Escolha um agente hospedado quando precisar de mais controle sobre a execução. Para obter detalhes, consulte Quando usar agentes hospedados.

Abrir o Agente de Criação

Abra a página de criação para escolher como criar seu agente.

  1. Na Barra de Atividades, selecione Foundry Toolkit.

  2. Em Ferramentas de Desenvolvedor, expanda Build e selecione Criar Agente.

    Captura de tela de Criar Agente com opções para codificar de exemplos, código com Copilot ou criar um agente no Construtor de Agentes.

Se as Ferramentas do desenvolvedor usarem Agrupar por recurso, procure Criar agente em Agent Dev Tools em vez de Build.

Escolha um caminho de criação

Selecione a rota que corresponde ao tipo de agente e siga seu guia para configurar, testar e salvar ou implantar o agente.

Route Ação em Criar Agente Próximo guia
Construtor de Agentes Selecione Criar um agente para configurar um agente de prompt sem um projeto de código de agente hospedado. Crie um agente de prompts.
Exemplos de agente hospedado Em Criar o código de um agente com base em exemplos, selecione um framework ou Ver todos os exemplos. Escolha um exemplo para seu cenário. Para orquestração baseada em código, crie agentes hospedados. Para outros cenários, siga o exemplo selecionado gerado README.md.
codificação assistida por Copilot Selecione Programar um agente com o Copilot para desenvolver o código do agente com o GitHub Copilot e as habilidades do Foundry. Use a habilidade de Microsoft foundry em agentes de codificação. Examine o código gerado e teste-o antes da implantação.

O Construtor de Agentes também dá suporte a prompts armazenados localmente. Suas opções de armazenamento, ferramentas e avaliação diferem dos agentes de prompt do Foundry. Consulte Trabalhar com prompts locais.

Escolha como orquestrar ou agendar o trabalho

Para novos fluxos de trabalho baseados em código, use o Microsoft Agent Framework por meio do exemplo ou do Copilot. Para invocar um agente existente por um gatilho ou agendamento, consulte Rotinas no Foundry Agent Service (versão prévia).

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. Essa desativação não afeta a orquestração baseada em código em agentes hospedados. Para trabalhar com um fluxo de trabalho declarativo existente, consulte Usar e migrar fluxos de trabalho declarativos do agente.

Use estes guias à medida que você desenvolve e integra seu agente: