Klon din Microsoft Copilot Studio agent i Microsoft Visual Studio Code

Når du kloner en agent fra Microsoft Copilot Studio ved hjælp af udvidelsen, downloader du agentdefinitionen og relaterede komponentdefinitioner fra Copilot Studio til din lokale computer. Du kan redigere disse filer ved hjælp af Microsoft Visual Studio Code. Klonoperationen opretter et lokalt arbejdsområde med alle agentfiler i et struktureret mappeformat.

Forudsætninger

Før du begynder at klone agenter, er der nogle vigtige forudsætninger og overvejelser.

Vælg en arbejdspladsplacering

Vælg en passende lokal mappe til dine agentfiler. Dette er stedet, hvor udvidelsen gemmer agentfilerne. Her er nogle vigtige tips til valg af sted:

  • Sørg for tilstrækkelig diskplads. Et typisk middel kan variere i størrelse afhængigt af antallet af komponenter.
  • Brug en sti uden mellemrum, hvis muligt, selvom mellemrum understøttes.
  • Overvej at bruge en lokation, der allerede er sporet af Git.

Forstå, hvad der bliver klonet

Når du kloner en agent, klones agentfilerne lokalt på den placering, du vælger, og opretter en strukturdefinition som følgende 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

Hvis du bruger udvidelsen for første gang eller endda ny til at Visual Studio Code, er den nemmeste måde at klone en agent på at vælge Clone Agent når ruden Extension er åben. Denne mulighed er dog ikke tilgængelig, når du allerede har en agent klonet og åben lokalt. Følgende metoder kan anvendes i stedet:

Dette er den mest ligetil og anbefalede metode til at klone en agent.

  1. Åbn udvidelsen Copilot Studio ved at vælge ikonet Copilot Studio på aktivitetslinjen. Du kan også trykke på Ctrl+Shift+P og skrive "Copilot Studio: Focus on Agents View". Ruden Copilot Studio åbnes i sidepanelet.

  2. I Agent-panelet vælger du dit målmiljø fra dropdown-listen (for eksempel "Miljø 1") for at se en liste over agenterne i miljøet.

    > Environment 1
  Environment 2
  Environment 3

  3. Vælg agenten, der skal klones fra listen. Agenter viser deres seneste ændrede dato. Højreklik på agentens navn og vælg Klonagent.

    > Customer Support Agent
    HR Assistant
    Sales Agent
    IT Helpdesk Agent

    En filvælger-dialog åbnes.

  4. Navigér til den ønskede placering i filvælger-dialogen eller opret en ny mappe og vælg Vælg Mappe. Kloneprocessen begynder.

  5. Vent på, at kloningsprocessen er færdig. En statusmeddelelse vises med "Cloning agent: Customer Support Bot," efterfulgt af en succesbesked "Agent klonet succesfuldt." Denne proces tager normalt 10-30 sekunder.

  6. Bekræfte, at kloningen er gennemført med succes. Mappen Agent åbnes i Visual Studio Code stifinder, ruden med kildekontrolelementet viser et rent arbejdstræ, og navnet på mappen vises i filvinduet.

Metode 3: Klon ved hjælp af kommandopaletten

Brug denne metode, hvis du foretrækker tastaturfokuserede arbejdsgange.

  1. Åbn kommandopaletten ved at trykke Ctrl+Shift+P.

  2. Skriv "Copilot Studio: Clone Agent", og tryk på Enter. Kommandoen udføres, og prompts vises.

  3. Følg prompterne for at vælge dit miljø, vælg agenten, vælg destinationsmappen og vent på, at kloningen er færdig. Agenten bliver klonet til din valgte placering.

Metode 3: Klon ved hjælp af agent-URL

Denne metode er nyttig, når nogen deler en agent-URL med dig.

  1. Åbn din agent på Copilot Studio-webportalen.

  2. Vælg Indstillinger>Agentdetaljer, og kopier agentens URL. URL'en bør have formatet: https://copilotstudio.microsoft.com/environments/{guid}/bots/{guid}. URL'en er nu i din udklipsholder.

  3. Vend tilbage til Visual Studio Code, og åbn udvidelsen Copilot Studio.

  4. Vælg Klonagent. Udvidelsen registrerer URL'en i dit udklipsforum og viser agenten markeret som "(fra udklipsholder)."

  5. Vælg agenten markeret "(fra udklipsholder)", vælg en destinationsmappe, og vent på, at kloningen er færdig. Agenten bliver klonet til din valgte placering.

Almindelige kloningsscenarier

Her er nogle almindelige scenarier for, hvornår kloning af agenter er nyttigt, med overordnede detaljer om den foreslagne arbejdsgang.

Scenarie 1: Klon til solo-udvikling

Mål: Arbejd på en agent alene

  1. Klon agenten til en lokal mappe.

  2. Initialiser et Git-repository fra Versionskontrol i navigationen.

  3. Foretag ændringer lokalt.

  4. Lav dine forpligtelser.

  5. Anvend ændringerne på Copilot Studio, når du er klar.

Scenarie 2: Klon til teamsamarbejde

Mål: Flere udviklere, der arbejder på samme agent

  1. Den første udvikler kloner agenten.

  2. Den første udvikler initialiserer Git og overfører indholdet til et delt lager (GitHub, Azure DevOps).

  3. Andre udviklere kloner fra det fælles Git-repository.

  4. Hver udvikler kører Copilot Studio: Reattach Agent for at forbinde deres lokale mappe med Copilot Studio.

  5. Teamet bruger Git til at samarbejde og spore ændringer og bruger udvidelsen Visual Studio Code til at arbejde med agenten.

  6. Hver udvikler anvender derefter ændringer af Copilot Studio til test eller push til et andet downstreammiljø baseret på deres softwareudviklingslivscyklus eller automatiserede pipelines.

Scenarie 3: Klon flere miljøer

Mål: Styr udviklings-, test- og produktionsversioner

Den anbefalede tilgang til implementering med flere miljøer er at bruge løsninger. Overvej en automatiseret implementeringsproces med organisatoriske processer, der er reviderbare og skalerbare, såsom pipelines. For brugere, der vælger ikke at arbejde med løsninger, giver udvidelsen Copilot Studio mulighed for at synkronisere en Copilot Studio-agentdefinition fra en lokal computer til et andet miljø. Du bør stadig overveje den organisatoriske proces for at flytte tekniske aktiver til downstream-miljøer for at levere revision, telemetri og andre kritiske komponenter i softwareudviklingscyklussen, når du leverer software til dine kunder og slutbrugere.

  1. Klon agenten fra udviklingsmiljøet til en lokal udviklingsmappe.

  2. Lav ændringer i udviklingsmappen.

  3. Påfør disse ændringer og test dem i det samme miljø.

  4. Brug Copilot Studio: Reattach Agent til at oprette forbindelse mellem agenten og det alternative miljø.

  5. Test agenten i Copilot Studio-testområdet.

Bedste praksis

Foretag

  • Klon alle agenter til et fast sted.
  • Initialiser Git lige efter kloning.
  • Brug et meningsfuldt mappenavn.
  • Tjek at klonen virker, før du laver ændringer.
  • Hold din klonplacering sikkerhedskopieret (f.eks. i GitHub eller Azure DevOps).
  • Dokumentér din klonplacering i din interne team-wiki eller dokumentation.

Gør ikke

  • Klon ikke til midlertidige mapper.
  • Klon ikke flere gange til forskellige steder. Det kan skabe forvirring.

Næste trin

Efter du har klonet din agent:

  • Last updated on