Klona din Microsoft Copilot Studio-agent i Microsoft Visual Studio Code

När du klonar en agent från Microsoft Copilot Studio med tillägget laddar du ned agentdefinitionen och relaterade komponentdefinitioner från Copilot Studio till den lokala datorn. Du kan redigera dessa filer med hjälp av Microsoft Visual Studio Code. Klonoperationen skapar en lokal arbetsyta med alla agentfiler i ett strukturerat katalogformat.

Förutsättningar

Innan du börjar klona agenter finns det några viktiga förutsättningar och överväganden.

Välj en arbetsplatsplats

Välj en lämplig lokal mapp för dina agentfiler. Det är på denna plats som filändelsen sparar agentfilerna. Här är några viktiga tips för att välja plats:

  • Säkerställ tillräckligt med diskutrymme. En typisk agent kan variera i storlek beroende på antalet komponenter.
  • Använd en bana utan mellanslag om möjligt, även om mellanslag stöds.
  • Överväg att använda en plats som redan spåras av Git.

Förstå vad som klonas

När du klonar en agent klonas agentfilerna lokalt på den plats du väljer, vilket skapar en strukturdefinition som följande i 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

Kloningsmetoder

Om du använder tillägget för första gången, eller till och med nytt för Visual Studio Code, är det enklaste sättet att klona en agent att välja Clone Agent när fönstret Extension är öppet. Detta alternativ finns dock inte när du redan har en agent klonad och öppen lokalt. Följande metoder kan användas istället:

Detta är den mest okomplicerade och rekommenderade metoden för att klona en agent.

  1. Öppna Copilot Studio-tillägget genom att välja ikonen Copilot Studio i aktivitetsfältet. Du kan också trycka på Ctrl+Shift+P och ange "Copilot Studio: Fokusera på agentvyn." Fönstret Copilot Studio öppnas i sidofältet.

  2. I Agenternas fönster väljer du din målmiljö från rullgardinsmenyn (till exempel "Miljö 1") för att se en lista över agenterna i miljön.

    > Environment 1
  Environment 2
  Environment 3

  3. Välj den agent som ska klonas från listan. Agenter visar sitt senaste ändrade datum. Högerklicka på agentens namn och välj Klonagent.

    > Customer Support Agent
    HR Assistant
    Sales Agent
    IT Helpdesk Agent

    En filväljardialog öppnas.

  4. Navigera till din önskade plats i filväljarens dialog eller skapa en ny mapp och välj Välj mapp. Klonningsprocessen börjar.

  5. Vänta på att kloningsprocessen ska vara klar. En framstegsnotis visas med "Kloningsagent: Kundsupportbot", följt av ett framgångsmeddelande "Agent klonad framgångsrikt." Denna process tar vanligtvis 10–30 sekunder.

  6. Verifiera att kloningen slutfördes framgångsrikt. Agentmappen öppnas i Visual Studio Code explorer, källkontrollfönstret visar ett rent arbetsträd och filfönstret visar namnet på mappen.

Metod 3: Klona med kommandopaletten

Använd denna metod om du föredrar tangentbordsfokuserade arbetsflöden.

  1. Öppna kommandopaletten genom att trycka på Ctrl+Shift+P.

  2. Skriv "Copilot Studio: Clone Agent" och tryck på Enter. Kommandot utförs och promptar visas.

  3. Följ instruktionerna för att välja din miljö, välj agenten, välj destinationsmappen och vänta på att kloningen ska slutföras. Agenten klonas till din valda plats.

Metod 3: Klona med agent-URL

Denna metod är användbar när någon delar en agent-URL med dig.

  1. Öppna din agent i Copilot Studio-webbportalen.

  2. Välj Inställningar>Agentdetaljer och kopiera agentens URL. URL:en ska ha formatet: https://copilotstudio.microsoft.com/environments/{guid}/bots/{guid}. URL:en finns nu i din urklipptavla.

  3. Gå tillbaka till Visual Studio Code och öppna tillägget Copilot Studio.

  4. Välj Klonagent. Tillägget känner igen URL:en i ditt urklipp och visar agenten markerad som "(från urklipp)."

  5. Välj agenten märkt "(från urklippet)", välj en destinationsmapp och vänta på att kloningen ska slutföras. Agenten klonas till din valda plats.

Vanliga kloningsscenarier

Här är några vanliga scenarier för när kloning av agenter är användbart, med övergripande detaljer om det föreslagna arbetsflödet.

Scenario 1: Klon för soloutveckling

Mål: Jobba på en agent på egen hand

  1. Klona agenten till en lokal mapp.

  2. Initiera ett Git-repository från Versionshantering i navigeringen.

  3. Gör ändringar lokalt.

  4. Gör dina åtaganden.

  5. Tillämpa ändringarna på Copilot Studio när du är klar.

Scenario 2: Klon för teamsamarbete

Mål: Flera utvecklare arbetar på samma agent

  1. Den första utvecklaren klonar agenten.

  2. Den första utvecklaren initierar Git och push-överför innehållet till en delad lagringsplats (GitHub, Azure DevOps).

  3. Andra utvecklare klonar från det gemensamma Git-arkivet.

  4. Varje utvecklare kör Copilot Studio: Reattach Agent för att ansluta sin lokala mapp till Copilot Studio.

  5. Teamet använder Git för samarbete och spåra ändringar och använder tillägget Visual Studio Code för att arbeta med agenten.

  6. Varje utvecklare tillämpar sedan ändringar i Copilot Studio för testning eller pushar till en annan sekundärmiljö baserat på deras livscykel för programvaruutveckling eller automatiserade pipelines.

Scenario 3: Klon flera miljöer

Mål: Hantera utvecklings-, test- och produktionsversioner

Den rekommenderade metoden för distribution med flera miljöer är att använda lösningar. Tänk på en automatiserad distributionsprocess med organisatoriska processer som är granskabara och skalbara, såsom pipelines. För användare som väljer att inte arbeta med lösningar ger Copilot Studio-tillägget möjlighet att synkronisera en Copilot Studio-agentdefinition från en lokal dator till en annan miljö. Du bör fortfarande ta hänsyn till organisationsprocessen för att flytta tekniska tillgångar till nedströmsmiljöer för att tillhandahålla revision, telemetri och andra kritiska komponenter inom mjukvaruutvecklingslivscykeln när du levererar programvara till dina kunder och slutanvändare.

  1. Klona agenten från utvecklingsmiljön till en lokal utvecklingsmapp.

  2. Gör ändringar i utvecklingsmappen.

  3. Tillämpa dessa ändringar och testa dem i samma miljö.

  4. Använd Copilot Studio: Reattach Agent för att ansluta agenten till den alternativa miljön.

  5. Testa agenten i testfönstret Copilot Studio.

Regelverk

Gör

  • Klona alla agenter till en konsekvent plats.
  • Initiera Git direkt efter kloning.
  • Använd ett meningsfullt mappnamn.
  • Kontrollera att klonen fungerar innan du gör ändringar.
  • Håll din klonplats säkerhetskopierad (till exempel i GitHub eller Azure DevOps).
  • Dokumentera din klonplats i din interna teamwiki eller dokumentation.

Gör inte

  • Klon inte till tillfälliga kataloger.
  • Klona inte flera gånger till olika platser. Att göra det kan orsaka förvirring.

Nästa steg

Efter att du klonar din agent:

  • Last updated on