A extensão VS Code para Copilot Studio chegou em disponibilidade geral (GA) e muda completamente a forma como desenvolvedores e makers criam agentes de IA na plataforma da Microsoft. Agora é possível clonar um agente localmente, editar tópicos direto no código, versionar com Git e sincronizar as alterações de volta ao Copilot Studio — tudo sem depender exclusivamente do editor web. Neste guia você vai aprender do zero como instalar, configurar e usar essa extensão no seu dia a dia.
O que é a extensão VS Code para Copilot Studio?
A extensão oficial do Copilot Studio para VS Code é uma ferramenta da Microsoft que permite conectar o Visual Studio Code diretamente ao seu ambiente de Copilot Studio. Com ela, você deixa de estar preso ao editor web e passa a trabalhar com os arquivos do seu agente de IA como qualquer outro projeto de software.
Na prática, a extensão expõe a estrutura interna do agente em arquivos YAML editáveis. Cada tópico do agente — incluindo triggers, mensagens, condições e ações — é representado por um arquivo de texto que você pode abrir, modificar e salvar diretamente no VS Code. Isso abre caminho para:
- Controle de versão com Git (commit, branch, pull request)
- Edição em massa de tópicos sem navegar pelo editor web
- Uso do GitHub Copilot como assistente enquanto escreve os tópicos
- Integração com pipelines de CI/CD para publicação automatizada
- Trabalho offline na estrutura do agente antes de sincronizar
A extensão está disponível gratuitamente no VS Code Marketplace e suporta qualquer tenant com licença do Copilot Studio.
Como instalar a extensão VS Code do Copilot Studio
A instalação é simples e leva menos de dois minutos. Siga os passos abaixo:
- Abra o Visual Studio Code (versão 1.85 ou superior recomendada)
- Acesse o painel de Extensões com
Ctrl+Shift+X - Pesquise por “Copilot Studio” na barra de busca
- Localize a extensão oficial da Microsoft e clique em Install
- Após a instalação, um novo ícone do Copilot Studio aparece na barra lateral do VS Code
Com a extensão instalada, clique no ícone para abrir o painel do Copilot Studio dentro do VS Code. O próximo passo é fazer o login no seu tenant.
Login e seleção de ambiente
Ao abrir a extensão pela primeira vez, ela vai solicitar autenticação com a conta Microsoft associada ao seu tenant do Power Platform. Faça o login pelo fluxo OAuth que o VS Code abre no navegador. Após autenticar, selecione o ambiente (environment) onde os seus agentes estão criados — o mesmo ambiente que você usa no portal do Copilot Studio.
Clonando um agente localmente no VS Code
Depois de selecionar o ambiente, a extensão lista todos os agentes de IA disponíveis. Para começar a trabalhar localmente, clique em Clone ao lado do agente desejado e escolha uma pasta no seu computador.
O processo de clonagem baixa a estrutura completa do agente como arquivos locais. Dependendo do tamanho e número de tópicos, isso pode levar alguns segundos. Quando concluído, o VS Code abre automaticamente a pasta do projeto.
Estrutura de arquivos do agente (assets e topics)
A estrutura de pastas gerada pelo clone segue um padrão bem organizado:
assets/— contém recursos estáticos do agente, como imagens e a configuração geraltopics/— pasta principal com um arquivo.yamlpara cada tópico do agente
Cada arquivo YAML dentro de topics/ representa um tópico completo: nome, frases de gatilho (trigger phrases), nós do diálogo, mensagens enviadas ao usuário, condições, ações de chamada de API e muito mais. Essa estrutura é legível, versionável e editável em qualquer editor de texto.
Editando tópicos diretamente no código
Com os arquivos abertos no VS Code, você pode editar qualquer aspecto de um tópico. A extensão oferece IntelliSense e validação de schema YAML em tempo real enquanto você digita, reduzindo erros de estrutura e acelerando o desenvolvimento.
Exemplos do que você pode editar diretamente no YAML:
- Adicionar ou remover frases de gatilho (trigger phrases)
- Alterar textos de mensagens em todos os idiomas de uma vez
- Modificar condições e ramificações do fluxo de diálogo
- Chamar conectores do Power Platform via actions
- Configurar variáveis e entidades do agente
Get Changes e Apply Changes: sincronizando com o Copilot Studio
Trabalhar localmente é ótimo, mas em algum momento você precisa sincronizar as mudanças. A extensão oferece dois comandos essenciais para isso:
Get Changes puxa as alterações mais recentes do Copilot Studio para o seu projeto local. Use esse comando antes de começar a trabalhar para garantir que está com a versão mais atualizada do agente — especialmente importante em ambientes onde mais de um desenvolvedor edita o mesmo agente.
Apply Changes envia as alterações locais de volta para o Copilot Studio. Após executar esse comando, as edições ficam disponíveis no editor web e podem ser testadas imediatamente no painel de testes do Copilot Studio.
Dica importante: antes do Apply Changes, sempre faça um Get Changes para evitar conflitos de sincronização. É um fluxo similar ao
git pullantes dogit push.
Como criar um novo tópico por código no VS Code
Uma das funcionalidades mais poderosas da extensão é criar tópicos diretamente pelo código, sem usar o editor web. Para criar um novo tópico:
- Na pasta
topics/, crie um novo arquivo com extensão.yaml - Defina o nome do tópico, as trigger phrases e os nós de diálogo seguindo o schema YAML do Copilot Studio
- Salve o arquivo
- Execute Apply Changes para sincronizar o novo tópico com o ambiente
- Abra o Copilot Studio no navegador e o novo tópico já estará disponível para teste
Essa abordagem é especialmente útil para criar tópicos em lote, duplicar estruturas existentes ou importar tópicos de outro projeto. É muito mais rápido do que criar tópico por tópico pelo editor web quando você tem dezenas de fluxos para configurar.
Boas práticas de versionamento e publicação de agentes de IA
Agora que você tem os arquivos do agente localmente, aproveite para adotar boas práticas de engenharia de software no desenvolvimento dos seus agentes:
- Use Git desde o primeiro dia: inicialize um repositório com
git initna pasta do projeto clonado e faça commits descritivos a cada mudança relevante. - Crie branches por funcionalidade: antes de desenvolver um conjunto novo de tópicos, crie uma branch separada para facilitar revisão de código e rollback em caso de erro.
- Faça Get Changes antes de cada sessão: garante que está sempre trabalhando sobre a versão mais recente do agente.
- Use o GitHub Copilot: com o assistente de IA ativo no VS Code, você pode pedir sugestões de tópicos, corrigir estruturas YAML incorretas e acelerar muito o desenvolvimento.
- Teste antes de publicar: após Apply Changes, teste os tópicos no painel de testes do Copilot Studio antes de publicar o agente para os usuários finais.
- Documente com comentários YAML: descreva o objetivo de cada tópico e suas dependências para facilitar a manutenção futura por outros membros da equipe.
Perguntas Frequentes
A extensão VS Code para Copilot Studio é gratuita?
Sim. A extensão em si é gratuita e está disponível no VS Code Marketplace sem custo adicional. Para utilizá-la, você precisa de uma licença do Microsoft Copilot Studio ativa no seu tenant do Power Platform.
Preciso fechar o editor web do Copilot Studio para usar a extensão no VS Code?
Não. As duas interfaces podem coexistir. Você pode editar tópicos no VS Code e revisá-los no editor web. A sincronização é feita pelos comandos Get Changes (web → local) e Apply Changes (local → web). Certifique-se apenas de sincronizar antes e depois de editar em cada ambiente para evitar conflitos.
Posso usar Git para versionar meu agente do Copilot Studio?
Sim, essa é uma das grandes vantagens da extensão. Como os arquivos do agente ficam localmente como YAML, você pode inicializar um repositório Git, criar branches, fazer commits, abrir pull requests e integrar com Azure DevOps ou GitHub para pipelines de CI/CD completos.
O que acontece se eu editar o mesmo tópico no VS Code e no editor web ao mesmo tempo?
Pode ocorrer um conflito de sincronização. O Apply Changes vai tentar enviar a versão local, que pode sobrescrever mudanças feitas no editor web. Para evitar isso, sempre faça um Get Changes antes de começar a editar localmente e comunique a equipe quando for fazer edições significativas.
A extensão funciona com todos os tipos de agentes do Copilot Studio?
A extensão funciona com agentes criados no Microsoft Copilot Studio. Suporta tópicos customizados, ações, variáveis e entidades. Recursos em preview ou muito específicos podem não estar totalmente disponíveis na estrutura YAML exportada — consulte sempre a documentação oficial da Microsoft para informações atualizadas.
Conclusão
A extensão VS Code para Copilot Studio é um divisor de águas para quem desenvolve agentes de IA na plataforma da Microsoft. Com ela, você ganha controle total sobre o código-fonte do seu agente, pode versionar com Git, editar tópicos em massa, usar o GitHub Copilot como assistente e publicar alterações com muito mais agilidade do que pelo editor web.
Se você ainda não instalou, o processo leva menos de dois minutos. Para ver na prática cada um dos passos descritos neste artigo — instalação, clonagem, edição de tópicos, Get Changes, Apply Changes e criação de tópicos por código — assista ao vídeo completo do Ronan Vico acima.
Quer aprender mais sobre Power Platform, Copilot Studio e automação com IA? Explore os outros conteúdos do canal e acesse a Formação VICO Power para um treinamento completo em Apps Canvas, Power Automate e agentes de IA.