Instale a extensão Microsoft Copilot Studio para Microsoft Visual Studio Code

Note

Este artigo descreve as funcionalidades usadas em agentes ou fluxos de agentes alimentados pelo arnês padrão.

Pré-requisitos

Antes de instalar a extensão Microsoft Copilot Studio para Microsoft Visual Studio Code, certifique-se de que cumpre os seguintes requisitos:

Requisitos do sistema

  • Sistema Operativo:
    • 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)
  • Ligação à Internet: Necessária para instalação e autenticação

Requisitos de conta

  • Conta Microsoft: Conta Microsoft ativa com licença ou acesso Copilot Studio
  • Licença do Copilot Studio: Licença apropriada atribuída à sua conta
  • Acesso ao ambiente: Permissões para aceder a pelo menos um ambiente Copilot Studio
  • Permissões do agente: Acesso de leitura e escrita a qualquer agente que pretenda editar

Etapas de instalação

Pode instalar a extensão Copilot Studio no Visual Studio Code de duas formas:

  • Instalar a partir do Visual Studio Code
  • Instalar a partir do site do Visual Studio Code Marketplace

Método 1: Instalar a partir do Visual Studio Code

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

  2. Na barra de pesquisa, introduza "Copilot Studio." Procure a extensão oficial do Copilot Studio na lista de resultados. Verifica se o editor é "Microsoft."

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

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

  5. Espere que a instalação termine. Podes ver um aviso para recarregar Visual Studio Code, nesse caso, seleciona Reload quando solicitado.

  6. Verifica a instalação. Procura o ícone do Copilot Studio na barra de atividades. O ícone aparece com a marca Copilot Studio.

Método 2: Instalar a partir do site do marketplace do Visual Studio Code

  1. Vai a https://marketplace.visualstudio.com/ e pesquisa por "Copilot Studio." Também podes usar o link direto: https://marketplace.visualstudio.com/items?itemName=ms-CopilotStudio.vscode-copilotstudio.

  2. Selecione Instalar na página do marketplace. Os avisos do seu navegador podem pedir-lhe para descarregar o Visual Studio Code antes de lhe pedir para abrir o Visual Studio Code.

  3. Permita que o navegador abra o 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 do Copilot Studio na barra de atividades. A extensão abre como um painel de aplicação. Aparece uma notificação pop-up, indicando que a extensão do Copilot Studio exige que faça login.

  2. Selecione Iniciar sessão no pop-up e depois selecione Permitir. O seu navegador predefinido abre-se numa página de autenticação Microsoft.

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

  4. Consulte as permissões solicitadas:

    • Leia e escreva agentes do Copilot Studio
    • Aceder a informações ambientais
    • Sincronizar ficheiros para a cloud

    Selecione Aceitar ou Permitir. O navegador informa que você pode fechar a janela e voltar ao Visual Studio Code.

  5. Retorne ao Visual Studio Code. O painel de extensão carrega os ambientes a que tem acesso e os agentes nesses ambientes.

Verificar a configuração bem-sucedida

Após a autenticação, vês uma estrutura no painel Agents dentro da extensão Copilot Studio no Visual Studio Code. Vê uma lista de grupos de ambientes, com ambientes aninhados e agentes, semelhante à estrutura seguinte:

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

Resolver problemas de instalação

Os seguintes passos de resolução de problemas resolvem alguns problemas que podem ocorrer na instalação ou configuração da extensão Copilot Studio Visual Studio Code.

A extensão não aparece

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

Solution:

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

Falhas de autenticação

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

Solution:

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

  2. Tenta iniciar sessão usando outro navegador. Defina temporariamente este navegador como predefinido.

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

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

  5. Certifica-te de que usas um tipo de conta suportado.

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

Problema: Não consegues encontrar a extensão Copilot Studio ao pesquisar.

Solution:

  1. Certifica-te de que estás a pesquisar no painel de Extensões , não na pesquisa web.

  2. Verifica a grafia: "Copilot Studio."

  3. Contacte o seu administrador para saber se a sua organização restringe o acesso ao marketplace do Visual Studio Code.

Desinstalar a extensão

Para remover a extensão:

  1. Abra o painel de Extensões.

  2. Encontre Copilot Studio nas extensões instaladas.

  3. Na entrada da lista, selecione o ícone Gerir e depois selecione Desinstalar.

  4. Recarregue o Visual Studio Code quando solicitado.

Note

Desinstalar a extensão não apaga ficheiros de agente clonados localmente. Tens de remover estes ficheiros manualmente.

Passos seguintes

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

  • Last updated on