Microsoft Foundry Toolkit: a extensão que leva o desenvolvimento de IA para dentro do VS Code
Se você desenvolve aplicações com inteligência artificial e usa o Visual Studio Code, aposto que já viveu esta cena: o código de um lado, o portal do Microsoft Foundry em outra aba para configurar um agente, a documentação em uma terceira, e você pulando de uma para outra o tempo todo.
É uma rotina comum, principalmente para quem trabalha com agentes de IA. E a Microsoft vem tentando deixar isso mais simples com o Microsoft Foundry Toolkit, uma extensão para o VS Code que reúne várias ferramentas de desenvolvimento com IA em um só lugar.

Com ela, dá para explorar modelos, criar agentes, testar instruções, conectar ferramentas e até acompanhar o comportamento das aplicações, tudo sem sair do editor.
Ah, e tem um detalhe: talvez você já tenha usado essa extensão, só que com outro nome. Vamos a ele.
Do AI Toolkit ao Microsoft Foundry Toolkit
Se você acompanha as ferramentas de IA da Microsoft, provavelmente já ouviu falar do AI Toolkit for Visual Studio Code. Ele nasceu para facilitar a experimentação com modelos: explorar opções, rodar modelos localmente e testar prompts direto no VS Code.
Com o crescimento do Microsoft Foundry e a chegada de recursos para desenvolvimento de agentes, a proposta foi ficando maior. Em maio de 2026, a Microsoft anunciou a evolução do AI Toolkit para o Microsoft Foundry Toolkit, trazendo também funcionalidades que antes ficavam na extensão Microsoft Foundry.

Na prática, dois mundos que andavam meio separados se aproximaram: a experimentação com modelos e o desenvolvimento de aplicações e agentes conectados aos serviços do Azure.
Hoje a extensão vai muito além de um espaço para conversar com modelos. Ela dá acesso a recursos do Foundry, permite trabalhar com agentes hospedados, configurar ferramentas, executar avaliações e desenvolver soluções com modelos locais ou na nuvem.
E isso acompanha uma mudança na própria forma de desenvolver com IA. Não faz muito tempo, a maioria dos exemplos se resumia a mandar um prompt e receber uma resposta. Agora lidamos com agentes que acessam ferramentas, consultam sistemas e participam de processos mais complexos. Faz todo sentido ter isso perto do código.

Mas o que dá para fazer com ela?
Quando você instala o Foundry Toolkit, a primeira impressão é: “nossa, quanta coisa”. A interface organiza tudo em áreas como My Resources e Developer Tools. Em My Resources ficam os recursos do seu ambiente, como modelos e agentes existentes. Em Developer Tools ficam as ferramentas do dia a dia de desenvolvimento.

Em vez de passar tela por tela, prefiro mostrar algumas situações em que a extensão realmente ajuda.
Explorando modelos sem sair do editor
Imagine que você está começando uma aplicação e ainda não decidiu qual modelo usar. Talvez precise de um mais rápido para tarefas simples, ou de outro com mais capacidade de raciocínio para interpretar informações complexas.
Com o Foundry Toolkit, você explora o catálogo de modelos e abre um Playground direto no VS Code. Lá dá para conversar com os modelos, mexer nas instruções e testar parâmetros suportados antes mesmo de integrar qualquer coisa ao código.

Também dá para trabalhar com modelos locais. Dependendo do seu ambiente e dos requisitos de hardware, o Toolkit se integra a tecnologias como Ollama, ONNX e Foundry Local, o que permite testar certos cenários sem depender de uma chamada ao Azure a cada execução.
Só vale lembrar que rodar modelos localmente não significa que todas as máquinas terão o mesmo desempenho. Mas é uma ótima opção para quem gosta de experimentar durante o desenvolvimento.
Criando agentes diretamente no VS Code
Essa talvez seja a parte mais legal, principalmente para quem já trabalha com Microsoft Foundry. O Toolkit permite criar e configurar agentes por uma interface visual, sem precisar começar tudo pelo portal.
Vamos a um exemplo. Digamos que queremos um agente para ajudar uma equipe de suporte técnico: o usuário descreve um problema, e o agente interpreta o pedido, organiza as informações e sugere uma prioridade de atendimento.
No Agent Builder, a gente define o nome do agente, escolhe um modelo disponível no projeto e escreve as instruções. Algo assim:
Você é um assistente de suporte técnico. Sua função é analisar os problemas relatados pelos usuários, identificar possíveis causas e sugerir os próximos passos. Quando não houver informações suficientes, faça perguntas antes de apresentar um diagnóstico.
Depois é só testar diferentes situações no Playground e observar as respostas. Percebeu que o agente está se precipitando e dando diagnóstico sem informação suficiente? Ajusta as instruções e testa de novo. Tudo isso sem sair do VS Code.
O agente também pode ser salvo no Microsoft Foundry, e suas configurações ficam disponíveis para outras aplicações. E, se você precisar de algo mais personalizado, a extensão oferece recursos para trabalhar com agentes hospedados, inclusive com projetos baseados em código.

E quando o agente precisa acessar ferramentas?
Até aqui, nosso agente só responde com base nas instruções e no conhecimento do próprio modelo. Mas, em projetos reais, isso costuma ser só o começo.
Pense no mesmo agente de suporte precisando consultar um chamado existente, buscar algo na documentação interna ou acionar um serviço externo. É aí que entram as ferramentas.

O Foundry Toolkit oferece um catálogo de ferramentas, incluindo integrações baseadas no Model Context Protocol (MCP). Se você ainda não conhece, o MCP é um protocolo que facilita a conversa entre aplicações de IA e ferramentas externas. Em vez de criar uma integração diferente para cada agente, você usa servidores MCP que expõem funcionalidades de forma padronizada.
Dentro do Toolkit, dá para explorar essas possibilidades e configurar as ferramentas compatíveis com o seu projeto.
Outro recurso bacana são as Toolboxes, que ajudam a organizar ferramentas reutilizáveis e a trabalhar com Skills em configurações suportadas. Pense numa empresa com vários agentes que precisam acessar as mesmas funcionalidades internas: organizar essas integrações em Toolboxes facilita a manutenção, principalmente conforme a quantidade de agentes cresce.

Testou uma vez e gostou? Calma, ainda não acabou
Esse comportamento é bem comum: a gente escreve as instruções, faz algumas perguntas no Playground, gosta das respostas e já considera o agente pronto. O problema é que modelos generativos nem sempre respondem do mesmo jeito em todas as situações.
Um agente pode ir muito bem numa pergunta simples e tropeçar quando recebe uma solicitação longa, ambígua ou diferente dos exemplos que você usou nos testes.
Por isso acho os recursos de avaliação do Foundry Toolkit especialmente interessantes. A extensão traz ferramentas para avaliar modelos e agentes usando conjuntos de testes e critérios que ajudam a analisar a qualidade das respostas.
Voltando ao nosso agente de suporte, dá para montar casos que representem situações diferentes: uma falha de autenticação, um problema de desempenho, um sistema fora do ar para parte dos usuários. Depois é só ver como o agente se comporta em cada cenário. Mudou as instruções ou trocou o modelo? Repete os testes e compara os resultados. Assim, o desenvolvimento deixa de depender daquela sensação de que “a resposta pareceu boa”.
A extensão também tem recursos de inspeção e observabilidade, como o Agent Inspector, que ajudam a acompanhar mensagens, chamadas de ferramentas e eventos durante a execução de agentes baseados em código. Para quem precisa de aplicações consistentes, vale muito a atenção.

E para quem desenvolve com .NET?
Se você está se perguntando se o Foundry Toolkit é só para quem programa em Python, a resposta é não. Embora algumas funcionalidades, exemplos e opções de geração de código usem Python, a extensão também pode fazer parte do desenvolvimento de soluções .NET.
Imagine uma aplicação ASP.NET Core que usa um agente hospedado no Microsoft Foundry. Você pode usar o Toolkit para explorar modelos, configurar o agente e testar as instruções. Depois, sua aplicação C# conversa com esse agente pelas APIs e SDKs compatíveis.
Essa divisão é boa: o Foundry cuida de parte da configuração e da execução do agente, e sua aplicação continua responsável pelas regras de negócio, pela autenticação e pelo resto das funcionalidades. Se você precisa de mais controle sobre a implementação, também dá para trabalhar com agentes hospedados baseados em código.
O ponto principal: o Toolkit não substitui o Visual Studio, o SDK .NET nem as ferramentas que você já usa. Ele complementa, principalmente nas etapas de experimentação, configuração e testes das funcionalidades de IA. Para quem alterna toda hora entre código e serviços do Foundry, isso ajuda bastante.
Uma extensão em constante evolução
Vale ficar de olho na frequência com que a Microsoft atualiza o Foundry Toolkit. Ao longo de 2026, vimos a consolidação das extensões, melhorias no desenvolvimento de agentes e a chegada de recursos como Toolboxes e Skills.

Na versão 1.6.20, publicada em 11 de novembro de 2026, uma das novidades foi a inclusão de verificações de restrições do Azure Policy durante a criação e a implantação de agentes hospedados. Pode parecer pequeno perto de criar um agente ou integrar um MCP, mas em ambientes corporativos faz toda a diferença: não basta conseguir implantar uma aplicação de IA, também é preciso respeitar as políticas de segurança e governança da organização.
Outra evolução está nas configurações de deployment dos modelos, que facilitam parte do gerenciamento direto pelo ambiente de desenvolvimento. Como as atualizações são frequentes, vale acompanhar o changelog oficial para saber o que chegou em cada versão.
Então, vale a pena?
Na minha opinião, o maior atrativo do Foundry Toolkit é trazer o trabalho com agentes de IA para a rotina que a gente já conhece. O portal do Microsoft Foundry continua sendo importante, principalmente para configurar recursos, cuidar de governança e gerenciar os serviços. Mas nem todo ajuste nas instruções de um agente ou teste de modelo precisa começar com uma aba nova no navegador.
Também gosto de poder começar com algo simples, como testar um modelo no Playground, e ir avançando para agentes com ferramentas, avaliações e integrações com aplicações reais.
Claro, tem alguns pontos de atenção. Nem todos os recursos estarão disponíveis em qualquer ambiente, já que algumas funcionalidades dependem de modelos compatíveis, permissões no Azure ou versões específicas da extensão. E os custos: instalar o Foundry Toolkit é gratuito, mas usar modelos e serviços hospedados no Azure pode gerar cobranças.
Ainda assim, para quem trabalha com Microsoft Foundry ou quer começar a desenvolver agentes de IA, é uma ferramenta que vale conhecer.
Como começar?
O Foundry Toolkit está disponível gratuitamente no marketplace de extensões do VS Code. É só pesquisar por Foundry Toolkit for VS Code, escolher a extensão publicada pela Microsoft e instalar. Depois, conecte sua conta Azure e explore os recursos do seu projeto no Microsoft Foundry.
Minha sugestão para o primeiro contato: abra o Model Playground, experimente um modelo e depois crie um agentezinho com o Agent Builder. Não precisa de nada complexo. Um agente que interpreta solicitações ou organiza informações já é suficiente para você entender como a extensão funciona. E, conforme for explorando, vai descobrir outras funcionalidades que fazem sentido para os seus projetos.
Conclusão
O Microsoft Foundry Toolkit é mais um sinal de que o desenvolvimento com inteligência artificial está ficando cada vez mais perto das ferramentas que já usamos no dia a dia. A extensão reúne recursos que antes estavam espalhados e permite trabalhar com modelos, agentes e integrações direto no VS Code.
Para quem desenvolve com .NET e Azure, abre possibilidades interessantes, principalmente na hora de experimentar novidades do Foundry antes de levá-las para uma aplicação. Se você ainda não conhece, vale instalar e explorar. É uma ótima maneira de acompanhar a evolução das ferramentas de desenvolvimento de agentes da Microsoft.
E aí, já usa o Foundry Toolkit ou ainda vai testar?
Se quiser continuar o papo me chama la no Linkedin!
Referências e documentação oficial
Foundry Toolkit para Visual Studio Code
https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/get-started-projects-vs-code
Instalando o Foundry Toolkit
https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/install-foundry-toolkit-visual-studio-code
Criando agentes pelo Visual Studio Code
https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/create-prompt-agent-visual-studio-code
Agent Builder no VS Code
https://code.visualstudio.com/docs/intelligentapps/agentbuilder
Novidades e atualizações do Foundry Toolkit
https://microsoft.github.io/foundry-dev-tools/