Eksportere og importere agenter ved hjælp af løsninger

Du kan eksportere og importere agenter ved hjælp af løsninger, så du kan flytte dine agenter på tværs af flere miljøer.

Først skal du oprette en brugerdefineret løsning og føje din agent til den. Eksportér derefter løsningen med din agent, og importér den i et andet miljø. Du kan også opgradere eller opdatere en løsning med en agent og fjerne et ikke-administreret lag fra en administreret agent.

Du kan finde flere oplysninger om løsningsoversigten i Copilot Studio under Visning og administration af løsninger i Copilot Studio.

Forudsætninger

• Du skal have mindst sikkerhedsrollen Systemtilpasser til at bruge denne funktion. Få mere at vide om konfiguration af brugersikkerhed i et miljø.
• Du bør have kendskab til løsningskoncepter som beskrevet i Løsningskoncepter og Opret og administrer løsninger i Copilot Studio.

Ting du skal vide

• Du kan ikke eksportere kommentarer på emne- eller nodeniveau, når du eksporterer en agent.

  Bemærk

  Når du eksporterer og importerer en agent ved hjælp af løsninger, er det ikke alle agentkomponenter, der er inkluderet.

  Agentens instruktioner (hovedprompt) er inkluderet. Nogle komponenter, f.eks. brugerdefinerede emner og videnkilder, medtages muligvis ikke, hvis de gemmes som separate ressourcer eller Dataverse-tabeller, afhængigt af hvordan de oprettes eller sammenkædes.

• Hvis du fjerner en agent fra en løsning, fjernes dens komponenter ikke fra løsningen. Du kan fjerne komponenterne separat.

  Advarsel!

  Du skal ikke fjerne ikke-administrerede agenter, f.eks. agentemner, direkte fra løsningen, medmindre du også fjerner agenten fra løsningen.

  Du bør kun foretage ændringer af emner som en del af standardoprettelsesprocessen i brugergrænsefladen Copilot Studio. Hvis du fjerner eller ændrer en agents komponenter direkte fra løsningen, medfører det, at eksport og import mislykkes.

• Du kan ikke eksportere administrerede løsninger. Når du opretter en løsning, administreres den som standard ikke. Hvis du ændrer den til en administreret løsning, kan du ikke eksportere den. Du skal oprette en ny løsning.

• Du kan ikke eksportere en løsning, der indeholder en agent med punktummer (.) i navnet på nogen af emnerne.

Oprette en brugerdefineret løsning og tilføje din agent

1. Hvis du vil oprette en ny løsning i Copilot Studio løsningsoversigt, skal du følge trinnene i Opret og administrer løsninger i Copilot Studio.

2. Den løsning, du har oprettet, åbnes automatisk. Hvis den ikke vises, så vælg det på listen over løsninger.

3. Vælg Tilføj eksisterende, vælg derefter Agent, og vælg derefter Agent igen.

4. Vælg de agenter, du vil eksportere, på listen Tilføj eksisterende agenter , og vælg derefter Tilføj.

Føje komponenter til en agent i en brugerdefineret løsning

Hvis du føjer komponenter, f.eks. emner eller flow, til din agent i Copilot Studio, skal du også føje dem til agenten i din ikke-administrerede løsning, før du eksporterer.

1. Åbn løsningsoversigten i Copilot Studio.

2. Vælg den løsning, der indeholder din agent.

3. Find din agent under Agenter i ruden Objekter.

4. Vælg de tre prikker (⋮), vælg Avanceret, og vælg derefter Tilføj nødvendige objekter.

Gennemse instruktionerne og kravene i dokumentationen til Power Apps for at tilføj en eksisterende komponent til en løsning.

Tilføj specialstik til din løsning

Hvis din agent bruger brugerdefinerede connectors, så følg trinene i Create custom connectors in solutions og lær om kendte begrænsninger.

Tilføj Power Automate flows

Når du bruger flow og miljøvariabler, skal du tilføje de påkrævede objekter for flow og miljøvariabler.

1. Åbn løsningsoversigten i Copilot Studio.

2. Vælg den løsning, der indeholder din agent.

3. I Objekt-panelet finder du dine arbejdsgange.

4. Vælg de tre prikker (⋮), vælg Avanceret, og vælg derefter Tilføj nødvendige objekter.

Tilføj miljøvariabler

For at tilføje miljøvariable, følg disse trin:

1. Åbn løsningsoversigten i Copilot Studio.

2. Vælg den løsning, der indeholder din agent.

3. Hvis løsningen ikke har miljøvariabler, skal du vælge Tilføj eksisterende, vælge Mere og derefter vælge Miljøvariabel.

   1. Vælg de nødvendige miljøvariabler.

   2. Vælg Næste og vælg derefter Tilføje.

4. Hvis løsningen allerede har alle miljøvariabler, skal du vælge de tre prikker (⋮), vælge Avanceret og derefter vælge Tilføj påkrævede objekter for at sikre, at løsningen har alle afhængighederne.

Tilpas komponenter til administrerede løsninger

Hvis du vil tilpasse komponenter i en administreret løsning, skal du se Få vist og rediger tabeladministrerede egenskaber.

Sørg for, at dit miljø tillader tilpasning, før du importerer administrerede løsninger. Verdsig, at dit miljø ikke blokerer tilpasninger eller uadministrerede løsninger. Lær mere i Blokerede uadministrerede tilpasninger i Dataverse.

Eksportere løsningen med din agent

Du eksporterer og importerer agenter ved at eksportere og importere løsningerne, der indeholder dem fra ét miljø til et andet.

Hvis du vil eksportere løsningen med din agent, skal du følge disse trin:

1. Åbn løsningsoversigten i Copilot Studio.

2. Vælg den løsning, der indeholder din agent, på listen over ikke-administrerede løsninger.

3. Vælg Eksporter løsning. Som i Power Apps eksportér løsninger vises Før du eksporterer højre rude.

4. Resten af trinnene er de samme som ved eksport af løsninger i Power Apps. Hvis du vil afslutte eksport af løsningen, skal du følge vejledningen og kravene i dokumentationen til Power Apps.

Importere løsningen med din agent

Hvis du vil importere løsningen med din agent i et andet miljø, skal du følge disse trin:

1. I destinationsmiljøet åbn løsningsoversigten i Copilot Studio.

2. Vælg Importér løsning. Som i Power Apps importløsninger vises Importér en løsning højre rude.

3. Resten af trinnene er de samme som ved import af løsninger i Power Apps. Hvis du vil afslutte import af løsningen skal du følge vejledningen og kravene i dokumentationen til Power Apps.

Hvis importen ikke lykkes, skal du vælge Hent logfil for at hente en XML-fil, der indeholder oplysninger om, hvad der medførte, at importen ikke lykkedes. Den mest almindelige årsag til, at en import ikke lykkes er, at løsningen ikke indeholdt de krævede komponenter.

1. Vælg den nye importerede løsning på listen i Løsningsoversigt.

2. I ruden Objekter skal du vælge Agenter. Vælg derefter agentens navn for at åbne agenten i Copilot Studio på en ny fane.

3. Konfigurer brugergodkendelse for agenten igen.

Eksportere og importere agenter i Teams

I Microsoft Teams kan du eksportere og importere agenter mellem individuelle teams ved hjælp af appen Power Apps Teams.

Hvis du f.eks. eksporterer en arbejdsagent fra et Teams-team (team A) og derefter importerer den til team B, behøver du ikke at bygge den fra bunden til team B.

Følg instruktionerne i Eksportér tilpasninger fra Dataverse for Teams.

Når du vælger de tilpasninger, der skal eksporteres, skal du vælge den agent, du vil eksportere. Brug filteret i sideruden til kun at vise agenter for et bestemt team.

Agenten gemmes i mappen Overførsler på din computer.

Hvis du vil importere i Teams, skal du følge vejledningen i Importér tilpasninger til Dataverse for Teams.

Din agent vises i Copilot Studio-appen i Teams under det team, du har importeret den til.