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

Note

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

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.
  • Use 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.

Entenda 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 carregar em Ctrl+Shift+P e entrar em "Copilot Studio: Focus on Agents View." O painel Copilot Studio abre 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 mostram 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 prompts.

  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 detecta a 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: Trabalhe com um agente sozinho

  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

Faça

  • 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 o local do clone guardado (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 clones para diretórios temporários.
  • Não clones várias vezes para locais diferentes. Fazer isso pode causar confusão.

Passos seguintes

Depois de clonares o teu agente:

  • Last updated on