Partilhar via

Clone o seu agente Microsoft Copilot Studio no Microsoft Visual Studio Code

Quando clonas um agente do Microsoft Copilot Studio usando a extensão, descarregas a definição do agente e as definições de componentes relacionadas do Copilot Studio para a tua máquina local. Pode editar estes ficheiros usando o Microsoft Visual Studio Code. A operação de clonagem cria um espaço de trabalho local com todos os ficheiros agente num formato de diretório estruturado.

Pré-requisitos

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

Escolha um local de espaço de trabalho

Selecione uma pasta local apropriada para os ficheiros do seu agente. É neste local que a extensão guarda os ficheiros do agente. Aqui ficam algumas dicas importantes para escolher um local:

  • Garanta espaço em disco adequado. Um agente típico pode variar em tamanho dependendo do número de componentes.
  • Utilize um caminho sem espaços, se possível, embora os espaços sejam suportados.
  • Considere usar uma localização que já seja rastreada pelo Git.

Compreender o que é clonado

Quando clonas um agente, os ficheiros do agente são clonados localmente na localização escolhida, criando uma definição de estrutura como a seguinte no Visual Studio Code Explorer:

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 estás a usar a extensão pela primeira vez, ou mesmo és novo em Visual Studio Code, a forma mais fácil de clonar um agente é selecionar Clone Agent quando o painel Extension estiver aberto. No entanto, esta opção não está disponível quando já tens um Agente clonado e aberto localmente. Os seguintes métodos podem ser usados em alternativa:

Este é 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. Também pode premir Ctrl+Shift+P e entrar em "Copilot Studio: Vista Foco nos Agentes". O painel Copilot Studio é aberto na barra lateral.

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

    > Environment 1
  Environment 2
  Environment 3

  3. Selecione o agente a clonar da lista. Os agentes apresentam a última data de 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

    Abre-se um diálogo de seletor de ficheiros.

  4. Navegue até à localização desejada na caixa de diálogo do seletor de ficheiros ou crie uma nova pasta e selecione Selecionar Pasta. Começa o processo de clonagem.

  5. Esperar que o processo de clonagem termine. Aparece uma notificação de progresso a mostrar "Agente de clonagem: Bot de Suporte ao Cliente", seguida de uma mensagem de sucesso "Agente Clonado com sucesso." Este processo normalmente demora entre 10 a 30 segundos.

  6. Verifique se a clonagem foi concluída com sucesso. A pasta agente abre no explorador de Visual Studio Code, o painel de controlo de versões mostra uma árvore de trabalho limpa, e a janela de ficheiros mostra o nome da sua pasta.

Método 3: Clonar usando a paleta de comandos

Use este método se preferir fluxos de trabalho focados no teclado.

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

  2. Escreva "Copilot Studio: Clone Agent" e pressione Enter. O comando é executado e aparecem pedidos.

  3. Siga as instruções para selecionar o seu ambiente, selecione o agente, escolha a pasta de destino e espere que a clonagem termine. O agente é clonado para a localização selecionada.

Método 3: Clonar usando o URL do agente

Este método é útil quando alguém partilha um URL de agente consigo.

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

  2. SelecioneDetalhes do Agente> e copie o URL do agente. O URL deve ter o formato: https://copilotstudio.microsoft.com/environments/{guid}/bots/{guid}. O URL está agora na sua prancheta.

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

  4. Selecionar Agente clone. A extensão deteta o URL na sua área de transferência e mostra o agente marcado como "(da área de transferência)".

  5. Selecione o agente marcado como "(da prancheta)", selecione uma pasta de destino e espere que a clonagem termine. O agente é clonado para a localização selecionada.

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 individual

Objetivo: trabalhar sozinho num agente

  1. Clona o agente para uma pasta local.

  2. Inicialize um repositório Git a partir do Controlo de Versões na navegação.

  3. Faça alterações localmente.

  4. Faz os teus compromissos.

  5. Aplica as alterações ao Copilot Studio quando estiveres pronto.

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

Objetivo: Vários programadores a trabalhar no mesmo agente

  1. O primeiro programador clona o agente.

  2. O primeiro programador inicializa o Git e envia o conteúdo para um repositório partilhado (GitHub, Azure DevOps).

  3. Outros programadores clonam a partir do repositório Git partilhado.

  4. Cada programador executa Copilot Studio: Reattach Agent para ligar a sua pasta local ao Copilot Studio.

  5. A equipa utiliza o Git para colaboração e acompanhamento de alterações, e utiliza a extensão Visual Studio Code para trabalhar no agente.

  6. Cada desenvolvedor aplica então alterações ao Copilot Studio para testes ou envia para outro ambiente a jusante com base no seu ciclo de vida de desenvolvimento de software ou em pipelines automatizados.

Cenário 3: Clonar múltiplos ambientes

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

A abordagem recomendada para implementação em múltiplos ambientes é utilizar soluções. Considere um processo de implementação automatizado com processos organizacionais auditáveis e escaláveis, como pipelines. Para os utilizadores que optam por não trabalhar com soluções, a extensão Copilot Studio oferece a capacidade de sincronizar a definição de um agente Copilot Studio de uma máquina local para outro ambiente. Deve ainda considerar o processo organizacional para transferir ativos técnicos para ambientes posteriores para fornecer auditoria, telemetria e outros componentes críticos no ciclo de vida do desenvolvimento de software ao enviar software para os seus clientes e utilizadores finais.

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

  2. Faz alterações na pasta de desenvolvimento.

  3. Aplica essas alterações e testa as alterações no mesmo ambiente.

  4. Use Copilot Studio: Reattach Agent para ligar o agente ao ambiente alternativo.

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

Melhores práticas

Fazer

  • Clone todos os agentes para um local consistente.
  • Inicialize o Git logo após clonar.
  • Usa um nome de pasta com significado.
  • Verifique se o clone funciona antes de fazer alterações.
  • Mantenha uma cópia de segurança da sua localização do seu clone (por exemplo, no GitHub ou no Azure DevOps).
  • Documenta a localização do teu clone na wiki interna da equipa ou nos documentos.

Não

  • Não clone para diretórios temporários.
  • Não clones várias vezes para locais diferentes. Fazer isso pode causar confusão.

Próximos passos

Depois de clonares o teu agente:

  • Last updated on