Clonar seu agente de Microsoft Copilot Studio no Microsoft Visual Studio Code

Ao clonar um agente de Microsoft Copilot Studio usando a extensão, você baixa a definição do agente e as definições de componente relacionadas do Copilot Studio para o computador local. Você pode editar esses arquivos usando o Microsoft Visual Studio Code. A operação de clonagem cria um espaço de trabalho local com todos os arquivos de agente em formato de diretório estruturado.

Pré-requisitos

Antes de começar a clonar agentes, há alguns pré-requisitos e considerações importantes.

Escolha um local de trabalho

Selecione uma pasta local apropriada para os arquivos do seu agente. Esse local é onde a extensão salva os arquivos do agente. Aqui estão algumas dicas importantes para escolher um local:

  • Garanta espaço adequado em disco. Um agente típico pode variar em tamanho dependendo do número de componentes.
  • Use um caminho sem espaços, se possível, embora os espaços sejam compatíveis.
  • Considere usar um local que já seja rastreado pelo Git.

Entenda o que é clonado

Quando você clona um agente, os arquivos do agente são clonados localmente no local escolhido, criando uma definição de estrutura como a seguinte no Gerenciador de Visual Studio Code:

my-agent/
├── actions                   # Connectors
│   ├── DevOpsAction.mcs.yml  
│   └── GetItems.mcs.yml      
├── knowledge/files                # Knowledge sources
│   ├── source1.yaml
│   └── source2.yaml
├── topics/                   # Conversation topics
│   ├── greeting.mcs.yaml
│   ├── help.mcs.yaml
│   └── escalate.mcs.yaml
├── workflows/                    # Agent tools and actions
│   └── GetDevOpsItems
│       ├── metadata.yaml
│       └── workflow.json
│   └── GetMeetings
│       ├── metadata.yaml
│       └── workflow.json
├── trigger/                 # Event triggers
│   └── welcometrigger.mcs.yaml
├── agent.mcs.yaml                # Main agent definition
├── icon.png                      # Icon used for the agent, visible in test panel and in supported channels
├── settings.mcs.yml              # Configuration settings for the agent
└── connectioreferences.mcs.yml   # Connection References used by Connectors and other actions

Métodos de clonagem

Se você estiver usando a extensão pela primeira vez ou até mesmo nova para Visual Studio Code, a maneira mais fácil de clonar um agente é selecionar Clone Agent quando o painel Extension estiver aberto. No entanto, essa opção não está disponível quando você já tem um Agente clonado e aberto localmente. Os seguintes métodos podem ser usados em vez disso:

Esse é o método mais simples e recomendado para clonar um agente.

  1. Abra a extensão Copilot Studio selecionando o ícone Copilot Studio na barra de atividades. Você também pode pressionar Ctrl+Shift+P e inserir "Copilot Studio: foco na exibição Agentes". O painel do Copilot Studio é aberto na barra lateral.

  2. No painel de Agentes , selecione seu ambiente alvo na lista suspensa (por exemplo, "Ambiente 1") para ver uma lista dos agentes no ambiente.

    > Environment 1
  Environment 2
  Environment 3

  3. Selecione o agente para clonar da lista. Os agentes exibem a data da última modificação. Clique com o botão direito no nome do agente e selecione Clonar agente.

    > Customer Support Agent
    HR Assistant
    Sales Agent
    IT Helpdesk Agent

    Um diálogo de seletor de arquivos se abre.

  4. Navegue até o local desejado na caixa de diálogo do seletor de arquivos ou crie uma nova pasta e selecione Selecionar Pasta. O processo de clonagem começa.

  5. Espere o processo de clonagem terminar. Uma notificação de progresso aparece exibindo "Cloning agent: Customer Support Bot", seguida de uma mensagem de sucesso "Agente clonado com sucesso." Esse processo geralmente leva de 10 a 30 segundos.

  6. Verifique se a clonagem foi concluída com sucesso. A pasta do agente é aberta no explorador do Visual Studio Code, o painel de controle do código-fonte mostra uma árvore de trabalho limpa e a janela do arquivo exibe o nome da pasta.

Método 3: Clonar usando a paleta de comandos

Use esse método se preferir fluxos de trabalho focados em teclado.

  1. Abra a paleta de comandos pressionando Ctrl+Shift+P.

  2. Digite "Copilot Studio: Clone Agent" e pressione Enter. O comando é executado e os prompts aparecem.

  3. Siga as instruções para selecionar seu ambiente, selecione o agente, escolha a pasta de destino e espere a clonagem terminar. O agente é clonado para o local selecionado por você.

Método 3: Clonar usando a URL do agente

Esse método é útil quando alguém compartilha uma URL de agente com você.

  1. Abra seu agente no portal web do Copilot Studio.

  2. Selecione Configurações>Detalhes do Agente e copie a URL do agente. A URL deve ter o formato: https://copilotstudio.microsoft.com/environments/{guid}/bots/{guid}. A URL agora está na sua prancheta.

  3. Retorne ao Visual Studio Code e abra a extensão do Copilot Studio.

  4. Selecione Agente clone. A extensão detecta a URL na área de transferência e exibe o agente marcado como "(da área de transferência)".

  5. Selecione o agente marcado como "(da prancheta)", selecione uma pasta de destino e espere a clonagem terminar. O agente é clonado para o local selecionado por você.

Cenários comuns de clonagem

Aqui estão alguns cenários comuns em que clonar agentes é útil, com detalhes gerais sobre o fluxo de trabalho sugerido.

Cenário 1: Clone para desenvolvimento individualizado

Meta: trabalhar com um agente sozinho

  1. Clone o agente para uma pasta local.

  2. Inicialize um repositório Git a partir do Controle de Versão, na navegação.

  3. Faça alterações localmente.

  4. Faça seus compromissos.

  5. Aplique as alterações ao Copilot Studio quando estiver pronto.

Cenário 2: Clone para colaboração em equipe

Objetivo: Vários desenvolvedores trabalhando no mesmo agente

  1. O primeiro desenvolvedor clona o agente.

  2. O primeiro desenvolvedor inicializa o Git e envia o conteúdo por push para um repositório compartilhado (GitHub, Azure DevOps).

  3. Outros desenvolvedores clonam do repositório Git compartilhado.

  4. Cada desenvolvedor executa Copilot Studio: Recolocar o Agent para conectar sua pasta local ao Copilot Studio.

  5. A equipe usa o Git para colaboração e controle de alterações e usa a extensão Visual Studio Code para trabalhar no agente.

  6. Cada desenvolvedor aplica alterações ao Copilot Studio para testar ou fazer push para outro ambiente inferior com base em seu ciclo de vida de desenvolvimento de software ou processos automatizados.

Cenário 3: Clonar múltiplos ambientes

Objetivo: Gerenciar versões de desenvolvimento, teste e produção

A abordagem recomendada para implantação em múltiplos ambientes é usar soluções. Considere um processo automatizado de implantação com processos organizacionais auditáveis e escaláveis, como pipelines. Para usuários que optam por não trabalhar com soluções, a extensão Copilot Studio fornece a capacidade de sincronizar uma definição de agente do Copilot Studio de um computador local para outro ambiente. Você ainda deve considerar o processo organizacional para mover ativos técnicos para ambientes downstream para fornecer auditoria, telemetria e outros componentes críticos dentro do ciclo de vida do desenvolvimento de software ao enviar software para seus clientes e usuários finais.

  1. Clone o agente do ambiente de desenvolvimento para uma pasta local de desenvolvimento.

  2. Faça alterações na pasta de desenvolvimento.

  3. Aplique essas mudanças e teste as mudanças no mesmo ambiente.

  4. Use Copilot Studio: Reconectar Agente para conectar o agente ao ambiente alternativo.

  5. Teste o agente no painel de teste do Copilot Studio.

Práticas Recomendadas

Fazer

  • Clone todos os agentes para uma localização consistente.
  • Assim que clonar, inicialize o Git imediatamente.
  • Use um nome de pasta significativo.
  • Verifique se o clone funciona antes de fazer alterações.
  • Mantenha o backup do local do clone (por exemplo, em GitHub ou Azure DevOps).
  • Documente a localização do clone na wiki ou nos documentos da equipe interna.

Não

  • Não clone para diretórios temporários.
  • Evite clonar múltiplas vezes em locais diferentes. Fazer isso pode causar confusão.

Próximas etapas

Depois que você clona seu agente:

  • Last updated on