Uw Microsoft Copilot Studio-agent klonen in Microsoft Visual Studio Code

Wanneer u een agent kloont van Microsoft Copilot Studio met behulp van de extensie, downloadt u de agentdefinitie en gerelateerde onderdeeldefinities van Copilot Studio naar uw lokale computer. U kunt deze bestanden bewerken met behulp van Microsoft Visual Studio Code. De kloonoperatie creëert een lokale werkruimte met alle agentbestanden in een gestructureerd directoryformaat.

Vereiste voorwaarden

Voordat je begint met het klonen van agenten, zijn er enkele belangrijke vereisten en overwegingen.

Kies een werkpleklocatie

Selecteer een geschikte lokale map voor je agentbestanden. Deze locatie is waar de extensie de agentbestanden opslaat. Hier zijn enkele belangrijke tips voor het kiezen van een locatie:

  • Zorg voor voldoende schijfruimte. Een typisch agent kan variëren in grootte afhankelijk van het aantal componenten.
  • Gebruik indien mogelijk een pad zonder spaties, hoewel spaties worden ondersteund.
  • Overweeg een locatie te gebruiken die al door Git wordt gevolgd.

Begrijp wat er gekloond wordt

Wanneer u een agent kloont, worden de agentbestanden lokaal gekloond op de locatie die u kiest, waardoor een structuurdefinitie wordt gemaakt zoals in de 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

Klonmethoden

Als u de extensie voor het eerst gebruikt of zelfs nieuw bent met Visual Studio Code, kunt u het eenvoudigst een agent klonen door Clone Agent te selecteren wanneer het deelvenster Extension is geopend. Deze optie is echter niet beschikbaar als je al een agent hebt gekloond en lokaal geopend. In plaats daarvan kunnen de volgende methoden worden gebruikt:

Dit is de meest eenvoudige en aanbevolen methode om een agent te klonen.

  1. Open de Copilot Studio-extensie door het Copilot Studio-pictogram in de activiteitenbalk te selecteren. Je kunt ook op Ctrl+Shift+P drukken en 'Copilot Studio: Focus op agentenweergave' invoeren. Het deelvenster Copilot Studio wordt geopend in de zijbalk.

  2. Selecteer in het Agents-paneel je doelomgeving uit de dropdownlijst (bijvoorbeeld "Environment 1") om een lijst van de agents in de omgeving te zien.

    > Environment 1
  Environment 2
  Environment 3

  3. Selecteer de agent die je wilt klonen uit de lijst. Agenten tonen hun laatste wijzigingsdatum. Klik met de rechtermuisknop op de naam van de agent en selecteer Clone agent.

    > Customer Support Agent
    HR Assistant
    Sales Agent
    IT Helpdesk Agent

    Er opent een bestandskiezer-dialoog.

  4. Navigeer naar de gewenste locatie in het bestandskiezer-venster of maak een nieuwe map aan en selecteer Select Folder. Het kloonproces begint.

  5. Wacht tot het kloonproces voltooid is. Er verschijnt een voortgangsmelding met "Klonagent: Customer Support Bot," gevolgd door een succesbericht "Agent succesvol gekloond." Dit proces duurt meestal 10-30 seconden.

  6. Controleer of het klonen succesvol is voltooid. De agentmap wordt geopend in Visual Studio Code Explorer, het deelvenster bronbeheer toont een schone werkstructuur en het bestandsvenster geeft de naam van uw map weer.

Methode 3: Klonen met het commandopalet

Gebruik deze methode als je de voorkeur geeft aan toetsenbordgerichte workflows.

  1. Open het commandopalet door op te drukken Ctrl+Shift+P.

  2. Typ 'Copilot Studio: Clone Agent' en druk op Enter. Het commando wordt uitgevoerd en er verschijnen prompts.

  3. Volg de instructies om je omgeving te selecteren, selecteer de agent, kies de bestemmingsmap en wacht tot het klonen voltooid is. De agent wordt gekloond naar de door jou gekozen locatie.

Methode 3: Klonen met agent-URL

Deze methode is handig wanneer iemand een agent-URL met je deelt.

  1. Open uw agent in de webportal van Copilot Studio.

  2. Selecteer Instellingen>Agentgegevens en kopieer de URL van de agent. De URL moet het formaat hebben: https://copilotstudio.microsoft.com/environments/{guid}/bots/{guid}. De URL staat nu in uw klembord.

  3. Ga terug naar Visual Studio Code en open de Copilot Studio-extensie.

  4. Selecteer Kloonagent. De extensie detecteert de URL in je klembord en toont de agent die als "(van het klembord)" is gemarkeerd.

  5. Selecteer de agent gemarkeerd met "(van klembord)", selecteer een bestemmingsmap en wacht tot het klonen is voltooid. De agent wordt gekloond naar de door jou gekozen locatie.

Veelvoorkomende kloonscenario's

Hier zijn een paar veelvoorkomende scenario's wanneer het klonen van agenten nuttig is, met gedetailleerde details over de voorgestelde workflow.

Scenario 1: Kloon voor solo ontwikkeling

Doel: Werk alleen aan een agent

  1. Kloneer de agent naar een lokale map.

  2. Initialiseer een Git-repository vanuit Source Control in de navigatie.

  3. Breng lokaal wijzigingen aan.

  4. Maak je toezeggingen.

  5. Pas de wijzigingen toe op Copilot Studio wanneer u klaar bent.

Scenario 2: Kloon voor teamsamenwerking

Doel: Meerdere ontwikkelaars werken aan dezelfde agent

  1. De eerste ontwikkelaar kloont de agent.

  2. De eerste ontwikkelaar initialiseert Git en pusht de inhoud naar een gedeelde opslagplaats (GitHub, Azure DevOps).

  3. Andere ontwikkelaars klonen uit de gedeelde Git-repository.

  4. Elke ontwikkelaar voert Copilot Studio: Agent opnieuw koppelen uit om de lokale map te verbinden met Copilot Studio.

  5. Het team gebruikt Git voor samenwerking en het bijhouden van wijzigingen en gebruikt de Visual Studio Code-extensie om aan de agent te werken.

  6. Elke ontwikkelaar past vervolgens wijzigingen toe op Copilot Studio voor het testen of pushen naar een andere downstreamomgeving op basis van hun levenscyclus van softwareontwikkeling of geautomatiseerde pijplijnen.

Scenario 3: Kloon meerdere omgevingen

Doel: Beheer ontwikkel-, test- en productieversies

De aanbevolen aanpak voor implementatie met meerdere omgevingen is het gebruik van oplossingen. Denk aan een geautomatiseerd implementatieproces met organisatorische processen die controleerbaar en schaalbaar zijn, zoals pipelines. Voor gebruikers die ervoor kiezen om niet met oplossingen te werken, biedt de Copilot Studio-extensie de mogelijkheid om een Copilot Studio-agentdefinitie van een lokale computer te synchroniseren naar een andere omgeving. U moet nog steeds rekening houden met het organisatorische proces voor het verplaatsen van technische middelen naar downstreamomgevingen om auditing, telemetrie en andere kritieke componenten binnen de softwareontwikkelingscyclus te bieden wanneer u software voor uw klanten en eindgebruikers levert.

  1. Klon de agent van de ontwikkelomgeving naar een lokale ontwikkelmap.

  2. Wijzigingen aanbrengen in de ontwikkelmap.

  3. Pas die wijzigingen toe en test ze in dezelfde omgeving.

  4. Gebruik Copilot Studio: Agent opnieuw koppelen om de agent te verbinden met de alternatieve omgeving.

  5. Test de agent in het testvenster van Copilot Studio.

Aanbevolen procedures

Doen

  • Kloon alle agenten naar een vaste locatie.
  • Initialiseer Git direct na het klonen.
  • Gebruik een betekenisvolle mapnaam.
  • Controleer of de kloon werkt voordat je wijzigingen aanbrengt.
  • Houd een back-up van uw kloonlocatie (bijvoorbeeld in GitHub of Azure DevOps).
  • Documenteer de locatie van je kloon in je interne teamwiki of documentatie.

Niet doen

  • Klon niet naar tijdelijke mappen.
  • Kloon niet meermaals naar verschillende locaties. Dat kan verwarring veroorzaken.

Volgende stappen

Nadat je je agent hebt gekloond:

  • Last updated on