Compartilhar via

Instalar a extensão de Microsoft Copilot Studio para o Microsoft Visual Studio Code

Pré-requisitos

Antes de instalar a extensão Microsoft Copilot Studio para o Microsoft Visual Studio Code, verifique se você atende aos seguintes requisitos:

Requisitos do sistema

  • Sistema Operacional:
    • Windows (arquitetura x64)
      • Windows 10 versão 1809 ou posterior
      • Windows 11 (qualquer versão)
    • macOS
  • Visual Studio Code: versão 1.80 ou posterior (versão estável mais recente recomendada)
  • Conexão com a Internet: Necessário para instalação e autenticação

Requisitos da conta

  • Conta do Microsoft: conta Microsoft ativa com licença do Copilot Studio ou acesso
  • Copilot Studio license: licença apropriada atribuída à sua conta
  • Acesso ao ambiente: permissões para acessar pelo menos um ambiente do Copilot Studio
  • Permissões de agentes: Acesso de leitura e escrita a qualquer um dos agentes que você planeja editar

Etapas de instalação

Há duas maneiras de instalar a extensão do Copilot Studio no Visual Studio Code:

  • Instalar de dentro de Visual Studio Code
  • Instalar no site do Visual Studio Code Marketplace

Método 1: instalar a partir de Visual Studio Code

  1. Selecione o ícone Extensões na barra de atividades ou pressione Ctrl+Shift+X. O painel Extensions é aberto em Visual Studio Code.

  2. Na barra de pesquisa, insira "Copilot Studio". Procure a extensão oficial do Copilot Studio na lista de resultados. Verifique se a publicadora é a "Microsoft".

  3. Quando encontrar a extensão correta, selecione-a para abrir a página de detalhes da extensão.

  4. Selecione Instalar para iniciar a instalação.

  5. Aguarde pela conclusão da instalação. Você pode ver um prompt para recarregar Visual Studio Code, nesse caso, selecione Reload quando solicitado.

  6. Verifique a instalação. Procure o ícone Copilot Studio na barra de atividades. O ícone é exibido com a identidade visual do Copilot Studio.

Método 2: instalar no site do marketplace Visual Studio Code

  1. Acesse https://marketplace.visualstudio.com/ e pesquise "Copilot Studio". Você também pode usar o link direto: https://marketplace.visualstudio.com/items?itemName=ms-CopilotStudio.vscode-copilotstudio.

  2. Selecione Instalar na página do marketplace. Os prompts do navegador podem solicitar que você baixe o Visual Studio Code antes de pedir para abrir o Visual Studio Code.

  3. Permitir que o navegador abra Visual Studio Code e confirme a instalação procurando o ícone de extensão na barra de atividades.

Configuração inicial

Primeiro lançamento

  1. Selecione o ícone Copilot Studio na barra de atividades. A extensão abre como um painel de aplicação. Uma notificação pop-up é exibida, indicando que a extensão Copilot Studio precisa que você entre.

  2. Selecione Entrar no pop-up e depois selecione Permitir. Seu navegador padrão abre em uma página de autenticação da Microsoft.

  3. Insira suas credenciais de autenticação e complete qualquer autenticação multifator, se necessário.

  4. Verifique as permissões solicitadas

    • Ler e gravar agentes do Copilot Studio
    • Acesse informações ambientais
    • Sincronizar arquivos para a nuvem

    Selecione Aceitar ou Permitir. O navegador solicita que você possa fechar a janela e retornar ao Visual Studio Code.

  5. Volte para Visual Studio Code. O painel de extensão carrega os ambientes aos quais você tem acesso e os agentes nesses ambientes.

Verificar a configuração bem-sucedida

Após a autenticação, você deverá ver uma estrutura no painel Agents dentro da extensão Copilot Studio em Visual Studio Code. Você deve ver uma lista de grupos de ambiente, com ambientes aninhados e agentes, semelhante à seguinte estrutura:

AGENTS
  └─ Environment Group (for example, developer, default, sandbox, production)
      ├─ Example Environment 1
      │   ├─ Agent 1
      │   └─ Agent 2
      └─ Example Environment 2
          └─ Agent 3

Solucione problemas de instalação

Veja a seguir as etapas de solução de problemas para alguns problemas que podem ocorrer ao instalar ou configurar a extensão Copilot Studio Visual Studio Code.

A extensão não aparece

Problem: O ícone do Copilot Studio não aparece na barra de atividades.

Solution:

  1. Recarregar Visual Studio Code
  2. Selecione Extensões e procure a extensão na lista Instalados. Certifique-se de que a extensão não esteja desativada.
  3. Atualize Visual Studio Code para a versão mais recente.
  4. Reinstale a extensão.

Falhas de autenticação

Problema: A autenticação falha ou se repete repetidamente.

Solution:

  1. Limpe o cache do navegador e os cookies para microsoft.com.

  2. Tente fazer login usando outro navegador. Defina temporariamente este navegador como padrão.

  3. Desative extensões do navegador que possam bloquear a autenticação.

  4. Verifique as configurações do firewall corporativo e do proxy.

  5. Certifique-se de usar um tipo de conta suportado.

Extensão não encontrada no marketplace Visual Studio Code

Problem: Não é possível localizar a extensão do Copilot Studio ao pesquisar.

Solution:

  1. Certifique-se de que você está pesquisando no painel de Extensões , não na busca na web.

  2. Verifique a ortografia: "Copilot Studio".

  3. Entre em contato com o seu administrador para ver se sua organização restringe acesso ao marketplace do Visual Studio Code.

Desinstalar a extensão

Para remover a extensão:

  1. Abra o painel de Extensões.

  2. Localize Copilot Studio nas extensões instaladas.

  3. Na entrada da lista, selecione oGerenciar (ícone de engrenagem) >Desinstalar.

  4. Recarregar Visual Studio Code quando solicitado.

Observação

Desinstalar a extensão não apaga arquivos de agente clonados localmente. Você precisa remover esses arquivos manualmente.

Próximas etapas

Depois de instalar a extensão e autenticar com o Copilot Studio, você estará pronto para:

  • Last updated on