Klone Microsoft Copilot Studio-agenten i Microsoft Visual Studio Code

Når du kloner en agent fra Microsoft Copilot Studio ved hjelp av utvidelsen, laster du ned agentdefinisjonen og relaterte komponentdefinisjoner fra Copilot Studio til den lokale maskinen. Du kan redigere disse filene ved hjelp av Microsoft Visual Studio Code. Kloneoperasjonen oppretter et lokalt arbeidsområde med alle agentfiler i et strukturert katalogformat.

Forutsetninger

Før du begynner å klone agenter, er det noen viktige forutsetninger og vurderinger.

Velg en arbeidsplasslokasjon

Velg en passende lokal mappe for agentfilene dine. Dette stedet er der utvidelsen lagrer agentfilene. Her er noen viktige tips for valg av sted:

  • Sørg for tilstrekkelig diskplass. Et typisk stoff kan variere i størrelse avhengig av antall komponenter.
  • Bruk en sti uten mellomrom hvis mulig, selv om mellomrom støttes.
  • Vurder å bruke et sted som allerede spores av Git.

Forstå hva som blir klonet.

Når du kloner en agent, kloner agentfilene lokalt på plasseringen du velger, og oppretter en strukturdefinisjon som følger 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 bruker utvidelsen for første gang, eller til og med nytt for Visual Studio Code, er den enkleste måten å klone en agent på, å velge Clone Agent når Extension-ruten er åpen. Dette alternativet er imidlertid ikke tilgjengelig når du allerede har en agent klonet og åpen lokalt. Følgende metoder kan brukes i stedet:

Dette er den mest enkle og anbefalte metoden for å klone en agent.

  1. Åpne Copilot Studio-utvidelsen ved å velge Copilot Studio-ikonet på aktivitetslinjen. Du kan også trykke Ctrl+Shift+P og skrive inn «Copilot Studio: Focus on Agents View». Copilot Studio-ruten åpnes i sidepanelet.

  2. I Agent-panelet velger du målmiljøet ditt fra nedtrekkslisten (for eksempel "Miljø 1") for å se en liste over agentene i miljøet.

    > Environment 1
  Environment 2
  Environment 3

  3. Velg agenten du skal klone fra listen. Agentene viser sin siste endrede dato. Høyreklikk på agentens navn og velg Klonagent.

    > Customer Support Agent
    HR Assistant
    Sales Agent
    IT Helpdesk Agent

    En filvelger-dialog åpnes.

  4. Naviger til ønsket plassering i filvelger-dialogen eller opprett en ny mappe og velg Velg mappe. Kloningsprosessen begynner.

  5. Vent til kloningsprosessen er ferdig. En fremdriftsvarsling vises som viser «Cloning agent: Customer Support Bot», etterfulgt av en suksessmelding «Agent klonet vellykket.» Denne prosessen tar vanligvis 10–30 sekunder.

  6. Sjekk at kloningen ble fullført med suksess. Agentmappen åpnes i Visual Studio Code utforsker, kildekontrollruten viser et rent fungerende tre, og filvinduet viser navnet på mappen.

Metode 3: Klon ved hjelp av kommandopaletten

Bruk denne metoden hvis du foretrekker tastaturfokuserte arbeidsflyter.

  1. Åpne kommandopaletten ved å trykke Ctrl+Shift+P.

  2. Skriv inn «Copilot Studio: Clone Agent», og trykk Enter. Kommandoen utføres, og prompts vises.

  3. Følg instruksjonene for å velge miljøet ditt, velg agenten, velg destinasjonsmappen, og vent på at kloningen er ferdig. Agenten klones til ditt valgte sted.

Metode 3: Klone ved bruk av agent-URL

Denne metoden er nyttig når noen deler en agent-URL med deg.

  1. Åpne agenten i nettportalen Copilot Studio.

  2. Velg Innstillinger>for agentdetaljer, og kopier agentens URL. URL-en skal ha formatet: https://copilotstudio.microsoft.com/environments/{guid}/bots/{guid}. URL-en er nå i utklippstavlen din.

  3. Gå tilbake til Visual Studio Code og åpne Copilot Studio-utvidelsen.

  4. Velg Kloneagent. Utvidelsen oppdager URL-en i utklippstavlen din og viser agenten merket som "(fra utklippstavlen)."

  5. Velg agenten merket "(fra utklippstavlen)", velg en destinasjonsmappe, og vent til kloningen er ferdig. Agenten klones til ditt valgte sted.

Vanlige kloningsscenarier

Her er noen vanlige scenarier for når kloning av agenter er nyttig, med overordnede detaljer om den foreslåtte arbeidsflyten.

Scenario 1: Klon for soloutvikling

Mål: Arbeid med en agent på egenhånd

  1. Klon agenten til en lokal mappe.

  2. Initialiser et Git-repositorium fra Source Control i navigasjonen.

  3. Gjør endringer lokalt.

  4. Gjør dine forpliktelser.

  5. Bruk endringene på Copilot Studio når du er klar.

Scenario 2: Klon for teamsamarbeid

Mål: Flere utviklere jobber på samme agent

  1. Den første utvikleren kloner agenten.

  2. Den første utvikleren initialiserer Git og sender innholdet til et delt repositorium (GitHub, Azure DevOps).

  3. Andre utviklere kloner fra det delte Git-arkivet.

  4. Hver utvikler kjører Copilot Studio: Reattach Agent for å koble den lokale mappen til Copilot Studio.

  5. Teamet bruker Git til samarbeid og sporing av endringer, og bruker Visual Studio Code-utvidelsen til å arbeide med agenten.

  6. Hver utvikler bruker deretter endringer i Copilot Studio for testing eller push til et annet nedstrømsmiljø basert på deres livssyklus for programvareutvikling eller automatiserte datasamlebånd.

Scenario 3: Klon flere miljøer

Mål: Administrere utviklings-, test- og produksjonsversjoner

Den anbefalte tilnærmingen for utrulling med flere miljøer er å bruke løsninger. Vurder en automatisert distribusjonsprosess med organisatoriske prosesser som er reviderbare og skalerbare, som pipelines. For brukere som velger å ikke arbeide med løsninger, gir Copilot Studio-utvidelsen muligheten til å synkronisere en Copilot Studio-agentdefinisjon fra en lokal maskin til et annet miljø. Du bør fortsatt vurdere den organisatoriske prosessen for å flytte tekniske eiendeler til nedstrømsmiljøer for å tilby revisjon, telemetri og andre kritiske komponenter i programvareutviklingslivssyklusen når du leverer programvare til kundene og sluttbrukerne dine.

  1. Klon agenten fra utviklingsmiljøet til en lokal utviklingsmappe.

  2. Gjør endringer i utviklingsmappen.

  3. Bruk disse endringene og test endringene i samme miljø.

  4. Bruk Copilot Studio: Reattach Agent til å koble agenten til det alternative miljøet.

  5. Test agenten i testpanelet til Copilot Studio.

Anbefalte fremgangsmåter

Gjør

  • Klon alle agenter til et fast sted.
  • Initialiser Git rett etter kloning.
  • Bruk et meningsfullt mappenavn.
  • Sjekk at klonen fungerer før du gjør endringer.
  • Hold kloneplasseringen sikkerhetskopiert (for eksempel i GitHub eller Azure DevOps).
  • Dokumenter kloneplasseringen din i din interne teamwiki eller dokumentasjon.

Ikke

  • Ikke klon til midlertidige kataloger.
  • Ikke klon gjentatte ganger til forskjellige steder. Å gjøre dette kan skape forvirring.

Neste trinn

Etter at du har klonet agenten din:

  • Last updated on