pac copilot

Hulpprogramma's en hulpprogramma's voor copilot-beheer.

Met de initopdrachten , , pushclonepullen pack opdrachten kunt u een Copilot Studio-agent behouden als een set bestanden op schijf, lokaal bewerken en synchroniseren met een Dataverse-omgeving.

Een typische lus ziet er als volgt uit:

1. Een werkruimte starten. Scaffold een gloednieuwe agent met pac copilot init, of download een bestaande met pac copilot clone. In beide gevallen krijgt u een lokale werkruimte die de metagegevens van de synchronisatie bevat, afhankelijk van de andere opdrachten.
2. Pull voordat u het bewerkt. pac copilot pull brengt externe wijzigingen omlaag en voegt deze samen in uw lokale bestanden, zodat u begint met de huidige serverstatus.
3. Duwen als je klaar bent. pac copilot push stuurt uw lokale wijzigingen terug. Als hetzelfde item in de tussentijd op de server is gewijzigd, stopt u pushen en wordt u gevraagd om eerst op te halen.
4. Pakket voor implementatie. pac copilot pack maakt van een werkruimte een oplossing .zip waarmee u kunt implementeren pac solution import.

Als u in één stap van niets naar een liveagent wilt gaan, pac copilot init --environment kunt u scaffolds, packs, importeren en de werkruimte voor u verbinden. Met de afzonderlijke opdrachten kunt u elk deel van de lus zelf besturen.

Commands

pac copilot clone

Kloon een Copilot Studio-agent naar een lokale werkruimtemap.

pac copilot clonedownloadt een bestaande Copilot Studio-agent in een lokale werkruimtemap, samen met de synchronisatiemetagegevens die pac copilot pull erop pac copilot push vertrouwen. De bestanden van de agent worden naar een submap geschreven met de naam van de weergave.

Voorbeeld

pac copilot clone `
   --bot 11111111-1111-1111-1111-111111111111 `
   --environment 22222222-2222-2222-2222-222222222222 `
   --output-dir contoso-support

Vereiste parameters voor copilot clone

--bot -id

De Copilot-id of schemanaam (unieke naam gevonden in Bot Details of bestandsnaam in Solution Explorer).

Optionele parameters voor copilot clone

--component-collection -cc

Id van onderdeelverzameling die moet worden gekloond. Herhaal dit voor meerdere.

--display-name -dn

Weergavenaam van de agent (gebruikt voor mapnaamgeving).

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

--output-dir -od

Hoofdmap voor kloonuitvoer. Standaard ingesteld op huidige map.

Remarks

• --botaccepteert een Copilot-id of schemanaam. Geef de Copilot-id (een GUID) of de schemanaam van de agent door. Met de opdracht wordt een schemanaam omgezet in de doelomgeving.
• De doelsubmap moet leeg zijn. Kloon schrijft naar een map die is vernoemd naar de weergavenaam van de agent (opgeschoond) onder --output-dir. Als die map al bestanden bevat, stopt de kloon in plaats van ze te overschrijven. Gebruik --display-name deze optie om een andere mapnaam te kiezen.
• Verzamelingen van onderdelen klonen. Als u onderdeelverzamelingen naast de agent wilt weergeven, geeft u een of meer verzamelings-id's door, --component-collectiongescheiden door puntkomma's.
• Klonen vereist een geverifieerd profiel (pac auth create) en lost de omgeving op uit --environment, of vanuit de organisatie van het actieve profiel wanneer u het weglaat.

pac copilot create

Hiermee maakt u een nieuwe copilot met behulp van een bestaand sjabloonbestand als referentie.

Vereiste parameters voor copilot create

--displayName

De weergavenaam van de nieuwe copilot

--schemaName

De schemanaam (unieke naam) van de nieuwe copilot.

--solution -s

Naam van de oplossing.

--templateFileName

Bron-YAML-bestand met de copilot-sjabloon die is geëxtraheerd met behulp van de opdracht extract-template.

Optionele parameters voor copilot create

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

pac copilot delete

Een aangepaste Copilot verwijderen.

Vereiste parameters voor copilot delete

--bot -id

De Copilot-id of schemanaam (unieke naam gevonden in Bot Details of bestandsnaam in Solution Explorer).

Optionele parameters voor copilot delete

--confirm -y

Vereist om het verwijderen van de copilot te bevestigen.

Voor deze parameter is geen waarde vereist. Het is een switch.

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

pac copilot extract-template

Extraheert een sjabloonbestand uit een bestaande copilot in een omgeving.

Voorbeeld

Met deze opdracht wordt een sjabloonbestand uit een bestaande copilot in een omgeving geëxtraheerd.

pac copilot extract-template `
   --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
   --bot 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e `
   --templateFileName NewTestCopilot.yaml

De opdracht retourneert uitvoer zoals de volgende voor een copilot met behulp van de Engelse en Duitse talen:

Connected as user@contoso.org

Loaded 34 components for bot 'New Test Copilot ' with id 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e. Primary language: English, supported languages: German

New Test Copilot -> C:\Users\user\NewTestCopilot.yaml

Vereiste parameters voor copilot extract-template

--bot -id

De Copilot-id of schemanaam (unieke naam gevonden in Bot Details of bestandsnaam in Solution Explorer).

--templateFileName

Locatie van het yaml-bestand om de copilot-sjabloon naar te schrijven.

Optionele parameters voor copilot extract-template

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

--overwrite -o

Overschrijven van het uitvoergegevensbestand toestaan als dit al bestaat.

Voor deze parameter is geen waarde vereist. Het is een switch.

--templateName

Sjabloonnaam of kickStartTemplate als de naam niet is opgegeven.

--templateVersion

Sjabloonversie in X.X.X-indeling of 1.0.0 als versie niet is opgegeven.

pac copilot extract-translation

Extraheert het bestand met gelokaliseerde inhoud voor een of meer bots.

Voorbeeld

Met deze opdracht wordt een bestand met gelokaliseerde inhoud geëxtraheerd voor een of meer copilots.

pac copilot extract-translation `
   --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
   --bot 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e `
   --all `
   --outdir . `
   --format json

De opdracht retourneert uitvoer zoals hieronder:

Connected as user@contoso.org

Loaded 32 components for bot 'New Test Copilot' with id 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e. Primary language: English, supported languages: German

Optionele parameters voor copilot extract-translation

--all -a

Lokalisatiebestanden schrijven voor alle ondersteunde talen. Standaard wordt alleen de primaire taal geschreven.

Voor deze parameter is geen waarde vereist. Het is een switch.

--bot -id

De Copilot-id of schemanaam (unieke naam gevonden in Bot Details of bestandsnaam in Solution Explorer).

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

--format

De bestandsindeling waarin gelokaliseerde bestanden moeten worden geschreven, 'resx' of 'json'. De standaardwaarde is 'resx'.

--outdir

De uitvoermap waar naar moet worden geschreven.

--overwrite -o

Overschrijven van het uitvoergegevensbestand toestaan als dit al bestaat.

Voor deze parameter is geen waarde vereist. Het is een switch.

--sourcedir -src

Bronoplossingsmap. Wanneer deze is opgegeven, negeert u de verbonden omgeving wanneer u op zoek bent naar bots en zoekt u in plaats daarvan naar inhoud in de oplossingsmap.

pac copilot init

Maak een nieuwe Copilot Studio agentwerkruimte op basis van een sjabloon.

pac copilot initscaffoldt een nieuwe Copilot Studio agentwerkruimte op basis van een sjabloon. Het wordt uitgevoerd in een van de twee modi en de aanwezigheid van --environment bepaalt welke modus moet worden gebruikt:

• Lokale steiger , nee --environment. Hiermee worden de sjabloonbestanden naar de projectmap geschreven en gestopt. De opdracht maakt niets in Dataverse en vereist geen aanmelding. Gebruik deze modus als u lokaal wilt ontwerpen en later verbinding wilt maken met een omgeving.
• Bootstrap — --environment geleverd. Scaffoldt de bestanden, verpakt ze in een oplossing, importeert die oplossing in de omgeving en verbindt de werkruimte met de zojuist gemaakte agent. Deze modus is het pad van één stap van niets naar een live, sync-ready agent en vereist een geverifieerd profiel.

Examples

Een werkruimte lokaal opzetten:

pac copilot init `
   --name "Contoso Support Agent" `
   --publisher-prefix contoso

Scaffold en bootstrap een live agent in een omgeving in één stap:

pac copilot init `
   --name "Contoso Support Agent" `
   --publisher-prefix contoso `
   --environment 22222222-2222-2222-2222-222222222222

Scaffold a CLI-authored (CliCopilot) agent in een specifieke map:

pac copilot init `
   --name "Contoso Support Agent" `
   --publisher-prefix contoso `
   --authoring-mode cli-copilot `
   --project-dir contoso-support

Vereiste parameters voor copilot init

--name -n

Weergavenaam van agent.

--publisher-prefix -pp

Publisher aanpassingsvoorvoegsel voor de oplossing.

Optionele parameters voor copilot init

--authoring-mode -am

De ontwerpshape van de agent naar de scaffold (standaard: 'klassiek'). Gebruik 'cli-copilot' om een CLI-authored CliCopilot-agent te maken.

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

--instructions -ins

Systeeminstructies voor agent.

--project-dir -pd

Doelmap voor de werkruimte van de agent. Standaard ingesteld op huidige map.

--schema-name -sn

Volledige agentschemanaam. Overschrijft de standaard derivatie ({publisher-prefix}_{sanitized-name}). Gebruikt as-is zonder wijziging.

--template -t

Sjabloonprofielnaam (standaard, minimaal). Standaard ingesteld op 'standaard'.

Remarks

• De projectmap moet leeg zijn. init verwijst niet naar bestaande bestanden, dus wijs --project-dir een nieuwe of lege map aan.
• Schemanaam derivatie. Wanneer u weglaat --schema-name, wordt de naam van het agentschema gebouwd als {publisher-prefix}_{sanitized-name}. Geef --schema-name door om deze expliciet in te stellen; de waarde wordt gebruikt as-is.
• Bootstrap werkt voor beide ontwerpmodi. init --environment bootstrapt een live agent in één stap voor de standaard klassieke modus en voor --authoring-mode cli-copilot. Als alternatief voor een CliCopilot-agent kunt u lokaal (nee --environment) scaffolden en vervolgens uitvoeren pac copilot packpac solution import om deze zelf te implementeren.
• Bootstrap maakt objecten aan de serverzijde. In bootstrapmodus init importeert u een oplossing en maakt u de agent in de doelomgeving. Als er al een agent met dezelfde schemanaam bestaat, init wordt u gestopt en verwijst u om in plaats daarvan verbinding te pac copilot clone maken met de bestaande agent.
• Een gloednieuwe omgeving kan traag zijn om de eerste import te accepteren. Het kan een paar minuten duren voordat een nieuw gemaakte omgeving is opgewarmd. Een vroege bootstrap kan mislukken met 'Async-bewerkingen zijn momenteel uitgeschakeld voor deze organisatie'. Wacht even en voer het opnieuw uit.
• --template (default of minimal) is alleen van toepassing op de klassieke ontwerpmodus.

pac copilot list

Lijst met copilots in de huidige of doel-Dataverse-omgeving.

Voorbeeld

Met deze opdracht worden alle copiloten in de huidige of doel-Dataverse-omgeving weergegeven.

pac copilot list --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118

De opdracht retourneert uitvoer zoals hieronder:

Name                           Bot ID                               Component State Is Managed Solution ID                          Status Code State Code
Ask Me Anything Copilot       584e012c-dc95-46d6-af5a-1263b6a44342 Published       Unmanaged  285af946-6383-49a0-8615-4e2afafeaf38 Active      Provisioned
New Test Copilot               9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e Published       Unmanaged  285af946-6383-49a0-8615-4e2afafeaf38 Active      Provisioned

Optionele parameters voor copilot list

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

pac copilot mcp

Informatie over de lokale MCP-server (Model Context Protocol).

Voorbeeld

pac copilot mcp --run

Optionele parameters voor copilot mcp

--run -r

Voer de lokale MCP-server (Model Context Protocol) uit.

Voor deze parameter is geen waarde vereist. Het is een switch.

Remarks

Meer informatie over het gebruik van de Power Platform CLI met ingebouwde MCP-server

pac copilot merge-translation

Bestanden met gelokaliseerde inhoud voor een of meer bots samenvoegen.

Voorbeeld

Met deze opdracht worden bestanden met gelokaliseerde inhoud samengevoegd voor een of meer copilots.

pac copilot merge-translation `
   --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
   --file ms_store_newTestCopilot.de-DE.json `
   --solution SolutionName

De opdracht retourneert uitvoer als de volgende bij het bijwerken van de Duitse taal:

Connected as user@contoso.org

Loading language German into bot 'ms_store_newTestCopilot' (New Test Copilot) from file 'C:\Users\user\ms_store_newTestCopilot'. 0 key(s) were missing, 0 value(s) were not used. Use the --verbose switch to get more details.

Updated 16 out of 16 components.

Meer informatie over het beheren van fouten met de opdracht merge-translation

Optionele parameters voor copilot merge-translation

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

--file -f

De lijst met bestanden die vertalingen bevatten. Glob-patronen worden ondersteund.

--solution -s

Naam van de oplossing.

--sourcedir -src

Bronoplossingsmap. Wanneer deze is opgegeven, negeert u de verbonden omgeving wanneer u op zoek bent naar bots en zoekt u in plaats daarvan naar inhoud in de oplossingsmap.

--verbose

Meer diagnostische informatie uitvoeren tijdens het importeren/exporteren van gegevens

Voor deze parameter is geen waarde vereist. Het is een switch.

--whatif

Voert de opdracht niet uit, maar voert de details uit van wat er zou gebeuren.

Voor deze parameter is geen waarde vereist. Het is een switch.

samenvoegingsfouten

Als in het bovenstaande voorbeeld één fout voorkomt in het bestand dat wordt gebruikt om de copilot bij te werken, ziet de uitvoer er als volgt uit:

Connected as user@contoso.org

Loading language German into bot 'ms_store_newTestCopilot' (New Test Copilot) from file 'C:\Users\user\ms_store_newTestCopilot'. 1 key(s) were missing, 1 value(s) were not used. Use the --verbose switch to get more details.

Updated 16 out of 16 components.

Met --verbose de vlag worden details over de fout toegevoegd:

Connected as user@contoso.org

Missing translation key: 'dialog(ms_store_newTestCopilot.topic.Lesson2)'.'trigger(main)'.'action(LbWwpD)'.Entity.Definition.'closedListItem(Redmond)'.DisplayName.

Unused translation: 'dialog(ms_store_newTestCopilot.topic.Lesson2)'.'trigger(main)'.'action(LbWwpD)'.Entity.Definition.'closedListItem(Redmont)'.DisplayName, value: Redmond

Loading language German into bot 'ms_store_newTestCopilot' (New Test Copilot) from file 'C:\Users\user\ms_store_newTestCopilot'. 1 key(s) were missing, 1 value(s) were not used. Use the --verbose switch to get more details.

Updated 16 out of 16 components.

pac copilot model list

AI Builder-modellen in de huidige omgeving.

Voorbeeld

Met deze opdracht worden alle AI Builder-modellen weergegeven.

pac copilot model list --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118

De opdracht retourneert uitvoer zoals hieronder:

Id                                   State    Name
32a9e265-1149-4155-af54-d2856d2b83f5 Active   Document Processing 2023/09/20, 12:21:40
2bcd7b94-50bc-4767-af4a-367c63fb5487 Inactive AI Classify
4e72b59a-17d6-451e-8657-89fbdec56d7a Inactive AI Extract
572f57a7-7a8f-49fc-adb4-331e02c509a6 Inactive AI Reply
b9b636cf-9748-47a7-b617-6df5f00f5151 Inactive AI Sentiment
c076eac8-f218-4feb-8ad1-7ee4fb039419 Inactive AI Summarize
a0440df3-2656-e911-8194-000d3a6cd5a5 Inactive BusinessCard model
62d1e848-5ca7-490a-94bf-79baabe85ef4 Inactive CategoryClassification model
4da7ec17-5c26-4fd2-9ddb-be4f7eda21a9 Inactive DataGenieEmailAddressValidation
51f4da11-5702-401d-b53a-9638744e8ac9 Inactive Document Layout Analysis Model
d1bb8d57-24ab-3b36-9592-bd792e153b79 Inactive DVCopilotQueryModel
3fbd4e5c-32bc-40fc-acce-59c2821cf113 Inactive Empty Dynamic Prompt
8c281981-c5d6-484f-bac7-4924ddd0b8ae Inactive EntityExtraction model
a1afa5d4-7a44-4c31-9cd2-e852a78431fa Inactive GptPromptEngineering model
2c444168-f8b1-4c6a-9313-2d9c03be6fea Inactive Id Scanning Model
77365cfa-7021-4cb7-a9b2-dc9823cde772 Inactive ImageDescription model
aef1bdd2-2a74-4f74-b4eb-9dfa22e35ded Inactive Invoice Model
5ed4d0fd-e9d4-4026-b09b-71f83ea90c60 Inactive Invoice Processing Model
c8425db7-c5a7-4226-b38e-c93a044c0fe1 Inactive KeyPhraseExtraction model
17a6f893-5b0b-4867-8fac-fb2eda9080b2 Inactive LanguageDetection model
046ab801-2756-e911-8194-000d3a6cd5a5 Inactive ObjectDetectionProposal model
892d3698-ba03-3d15-8e9e-843ca4ac5e7d Inactive PowerAppsAppCopilotModel
baa44529-bebe-49e6-837a-80bee63b0d2c Inactive Receipt Scanning Model
f1c549c2-a97e-47a5-b612-c5c2bab0f163 Inactive SentimentAnalysis model
7f8a7856-003a-3662-9871-0000d7674433 Inactive SimsModel
86419a67-205a-454f-b6fc-601394f2786d Inactive TextRecognition model
6225038a-8b5a-4913-bfd2-d8236f4102ba Inactive TextTranslation model
02e1fca3-232a-4f58-8c93-bdd8c9cd6de9 Inactive TextTranslationInternal model

Optionele parameters voor copilot model list

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

pac copilot model predict

Tekst of prompt verzenden naar AI-model

Optionele parameters voor copilot model predict

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

--model-id -id

Ai Builder-model-id

--model-name -n

Volledige of gedeeltelijke naam van AI-model

--prompt -p

Vragen om te verzenden naar AI-model

--text -t

Tekst die moet worden verzonden naar AI-model

pac copilot model prepare-fetch

Neemt het FetchXML-bestand uit het AI Large Language Model (LLM) en bereidt het voor op uitvoering op basis van de huidige omgeving.

Vereiste parameters voor copilot model prepare-fetch

--inputFile -i

Invoer fetchXML-bestand dat meestal afkomstig is van AI LLM.

--outputFile -o

Output FetchXML-bestand dat gereed is voor uitvoering op basis van de huidige omgeving.

Optionele parameters voor copilot model prepare-fetch

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

pac copilot pack

Verpakt een Copilot Studio agentwerkruimte in een zip-bestand van de oplossing.

pac copilot pack verpakt een agentwerkruimte in een Dataverse-oplossing .zip waarmee u kunt implementeren pac solution import. Het is de zelfstandige vorm van de verpakkingsstap die pac copilot init --environment voor u wordt uitgevoerd, zodat u de implementeerbare oplossing als een afzonderlijke stap kunt produceren, bijvoorbeeld in een build-pijplijn. Het werkt voor zowel klassieke als CLI-agentwerkruimten (CliCopilot).

Voorbeeld

pac copilot pack `
   --publisher-prefix contoso `
   --project-dir contoso-support `
   --output-path out

Vereiste parameters voor copilot pack

--publisher-prefix -pp

Publisher aanpassingsvoorvoegsel voor de oplossing.

Optionele parameters voor copilot pack

--output-path -op

Uitvoerpad voor het zip-bestand van de oplossing. Standaard ingesteld op huidige map.

--project-dir -pd

Map van agentwerkruimte die moet worden verpakt. Standaard ingesteld op huidige map.

--solution-name -sn

Unieke naam van oplossing. Als u dit weglaat, afgeleid van de schemanaam van de agent.

Remarks

• Het is een lokale bewerking. Pack leest de werkruimte en schrijft een oplossing .zip. Er is geen verificatie en geen omgeving nodig, dus het is veilig om te worden uitgevoerd in een build-pijplijn.
• Het voorvoegsel van de uitgever moet geldig zijn. --publisher-prefix moet een goed gevormd aanpassingsvoorvoegsel zijn of het pakket stopt voordat u iets schrijft.
• Naam en uitvoer van de oplossing. Als u weglaat --solution-name, wordt de unieke naam van de oplossing afgeleid van de agentschemanaam. De .zip map wordt naar de huidige map geschreven, tenzij u deze instelt --output-path.
• Pack wordt niet geïmplementeerd. Het produceert de oplossing, maar importeert deze niet. Volg deze pac solution import om de agent te implementeren en pac copilot clone als u er een met synchronisatie verbonden werkruimte voor wilt hebben.

pac copilot publish

Een aangepaste Copilot publiceren

Vereiste parameters voor copilot publish

--bot -id

De Copilot-id of schemanaam (unieke naam gevonden in Bot Details of bestandsnaam in Solution Explorer).

Optionele parameters voor copilot publish

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

pac copilot pull

Externe wijzigingen ophalen uit Copilot Studio en samenvoegen met lokale werkruimte.

De pac copilot pull opdracht haalt de huidige serverstatus van de agent op en voegt deze samen in uw lokale werkruimte met behulp van een samenvoegbewerking in drie richtingen. Dit proces zorgt ervoor dat bewerkingen aan de serverzijde en uw ongewijzigde lokale bestanden intact blijven. Voer het uit voordat u begint met bewerken en voer deze opnieuw uit voordat u uw wijzigingen pusht.

Voorbeeld

Voer de opdracht uit vanuit de werkruimtemap:

pac copilot pull

Of wijs deze aan in een werkruimte ergens anders op schijf:

pac copilot pull --project-dir contoso-support

Optionele parameters voor copilot pull

--project-dir -pd

Pad naar de projectmap. Standaard ingesteld op de huidige werkmap.

Remarks

• Voer deze uit in een synchronisatiewerkruimte. De pull opdracht werkt alleen in een map die is gemaakt door pac copilot clone of pac copilot init. De doelomgeving en agent worden gelezen uit de metagegevens van de synchronisatie van de werkruimte. Daarom is er geen --environment argument. Als u deze ergens anders uitvoert, mislukt deze met de fout 'werkruimte niet gevonden'.
• Het schrijft naar uw lokale bestanden. Pull voegt externe wijzigingen samen in de werkruimte en downloadt kennisbestanden. Lokale werkzaamheden doorvoeren of er een back-up van maken voordat u ze ophaalt.
• Meld u eerst aan met pac auth create.

pac copilot push

Push lokale werkruimtewijzigingen naar Copilot Studio.

pac copilot push verzendt de wijzigingen in uw lokale werkruimte terug naar de agent in Dataverse. Het vergelijkt uw bestanden met de laatst bekende serverstatus, uploadt alleen wat is gewijzigd, inclusief kennisbestanden, cloudstromen en verbindingsverwijzingen, en rapporteert wat er is gepusht.

Voorbeeld

Voer deze uit vanuit de werkruimtemap:

pac copilot push

Of wijs deze aan in een werkruimte ergens anders op schijf:

pac copilot push --project-dir contoso-support

Optionele parameters voor copilot push

--project-dir -pd

Pad naar de projectmap. Standaard ingesteld op de huidige werkmap.

Remarks

• Voer deze uit in een synchronisatiewerkruimte. push Werkt bijvoorbeeld pullalleen in een map die is gemaakt door pac copilot clone of pac copilot init. De doelomgeving wordt gelezen uit de synchronisatiemetagegevens van de werkruimte. Er is geen --environment argument.
• Pull eerst als er een conflict is. Als hetzelfde item zowel lokaal als op de server is gewijzigd, stopt u push en vraagt u om uit te voeren pac copilot pull voordat u het opnieuw probeert. Dit proces zorgt ervoor dat een push niet op de achtergrond een wijziging aan de serverzijde overschrijft die u niet hebt gezien.
• Geen lokale wijzigingen zijn een no-op. Als push niets vindt om te verzenden, wordt dat gerapporteerd en afgesloten zonder de omgeving aan te raken.
• Een geslaagde push muteert de live agent in de doelomgeving.
• Meld u eerst aan met pac auth create.

pac copilot quarantine

Quarantainestatus van copilootagent.

Vereiste parameters voor copilot quarantine

--bot-id -id

De ID van de copiloot om in quarantaine te gaan/niet in quarantaine.

Optionele parameters voor copilot quarantine

--environment -env

Omgeving (id, organisatie-id, URL, unieke naam of gedeeltelijke naam).

--status -s

Quarantainestatuswaarde. waar = quarantaine, false = onquarantaine. De standaardwaarde is true.

Voor deze parameter is geen waarde vereist. Het is een switch.

pac copilot status

Peil de implementatiestatus van een opgegeven copilot in de huidige of doel-Dataverse-omgeving.

Voorbeeld

Met deze opdracht wordt de implementatiestatus van een opgegeven copilot in de huidige of doel-Dataverse-omgeving gecontroleerd.

pac copilot status `
   --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
   --bot-id 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e

De opdracht retourneert uitvoer zoals hieronder:

Connected as user@contoso.org
Connected to... Contoso Organization
Virtual Agent New Bot German with ID 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e has been provisioned.

Vereiste parameters voor copilot status

--bot-id -id

De id van een copilot (chatbot).

Optionele parameters voor copilot status

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

Verificatie en omgeving voor de synchronisatieopdrachten

De clone, pullen pushinit --environment opdrachten communiceren allemaal met een Dataverse-omgeving, zodat ze een verificatieprofiel nodig hebben. Meld u eerst aan met pac auth create.

• clone, pullen push vereist een actief profiel. pac copilot init er is slechts één nodig wanneer u passeert --environment; zonder deze bestanden init lokaal te maken en hoeft u zich niet aan te melden.
• pull en push lees de doelomgeving uit de synchronisatiemetagegevens van de werkruimte, zodat ze geen argument gebruiken --environment . clone en init wel.
• pac copilot pack is puur lokaal. Het leest en schrijft alleen bestanden, dus het heeft geen verificatie en geen omgeving nodig.

pull en push werkt alleen binnen een werkruimte die is gemaakt door clone of init. De synchronisatiemetagegevens die zijn geschreven wanneer de werkruimte wordt gemaakt, is wat hen vertelt met welke agent en omgeving er moet worden gesproken, zodat het uitvoeren van de metagegevens op een andere locatie snel mislukt met de fout 'werkruimte niet gevonden'.

Zie ook

Microsoft Power Platform CLI-opdrachtgroepen
overzicht van Microsoft Power Platform CLI