pac copilot

Tools und Dienstprogramme für die Copilot-Verwaltung.

Mit den initBefehlen , clone, pull, pushund pack Befehlen können Sie einen Copilot Studio-Agent als Gruppe von Dateien auf dem Datenträger speichern, lokal bearbeiten und mit einer Dataverse-Umgebung synchronisieren.

Eine typische Schleife sieht wie folgt aus:

1. Starten Sie einen Arbeitsbereich. Erstellen Sie ein Gerüst für einen brandneuen Agent mit pac copilot init, oder laden Sie eine vorhandene mit pac copilot clone. Auf beide Weise erhalten Sie einen lokalen Arbeitsbereich, der die Synchronisierungsmetadaten enthält, von denen die anderen Befehle abhängig sind.
2. Ziehen Sie vor der Bearbeitung nach. pac copilot pull Führt Remoteänderungen herunter und führt sie in Ihre lokalen Dateien zusammen, sodass Sie mit dem aktuellen Serverstatus beginnen.
3. Push, wenn Sie fertig sind. pac copilot push sendet Ihre lokalen Änderungen zurück. Wenn sich dasselbe Element in der Zwischenzeit auf dem Server geändert hat, werden Pushstopps beendet und Sie aufgefordert, zuerst zu ziehen.
4. Paket für die Bereitstellung. pac copilot pack Wandelt einen Arbeitsbereich in eine Lösung .zip um, mit pac solution importder Sie bereitstellen können.

Um von nichts zu einem Live-Agent in einem einzigen Schritt zu wechseln, pac copilot init --environment erstellen Sie Gerüste, Pakete, Importe und verbindet den Arbeitsbereich für Sie. Mit den einzelnen Befehlen können Sie jeden Teil der Schleife eigenständig steuern.

Commands

pac copilot clone

Klonen Sie einen Copilot Studio Agent in ein lokales Arbeitsbereichsverzeichnis.

pac copilot clonelädt einen vorhandenen Copilot Studio-Agent in ein lokales Arbeitsbereichsverzeichnis zusammen mit den Synchronisierungsmetadaten herunter, die pac copilot pull und pac copilot push von denen sie abhängig sind. Die Dateien des Agents werden in einen Unterordner geschrieben, der nach seinem Anzeigenamen benannt ist.

Example

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

Erforderliche Parameter für copilot clone

--bot -id

Die Copilot-ID oder der Schemaname (eindeutiger Name in „Bot-Details“ oder der Dateiname im Lösungs-Explorer).

Optionale Parameter für copilot clone

--component-collection -cc

Zu klonende Komponentensammlungs-ID. Wiederholen Sie den Vorgang für mehrere.

--display-name -dn

Anzeigename des Agents (wird für die Ordnerbenennung verwendet).

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

--output-dir -od

Stammordner für die Klonausgabe. Standardmäßig wird das aktuelle Verzeichnis verwendet.

Remarks

• --botakzeptiert eine Copilot ID oder einen Schemanamen. Übergeben Sie entweder die Copilot-ID (eine GUID) oder den Schemanamen des Agents. Der Befehl löst einen Schemanamen für die Zielumgebung auf.
• Der Zielunterordner muss leer sein. Klont schreibt in einen Ordner, der nach dem (sanitisierten) Anzeigenamen des Agents unter --output-dirbenannt ist. Wenn dieser Ordner bereits Dateien enthält, stoppt der Klon, anstatt sie zu überschreiben. Verwenden Sie --display-name diese Option, um einen anderen Ordnernamen auszuwählen.
• Klonen von Komponentenauflistungen Um Komponentenauflistungen zusammen mit dem Agent nach unten zu bringen, übergeben Sie eine oder mehrere Sammlungs-IDs durch --component-collectionSemikolons getrennt.
• Klon erfordert ein authentifiziertes Profil (pac auth create) und löst die Umgebung aus --environmentoder aus der Organisation des aktiven Profils, wenn Sie es weglassen.

pac copilot create

Erstellt einen neuen Copilot mithilfe einer vorhandenen Vorlagendatei als Referenz.

Erforderliche Parameter für copilot create

--displayName

Der Anzeigename des neuen Copiloten

--schemaName

Der Schemaname (eindeutiger Name) des neuen Copiloten.

--solution -s

Name der Lösung.

--templateFileName

Die Quell-yaml-Datei mit der Copilot-Vorlage, die mit dem extract-template-Befehl extrahiert wurde.

Optionale Parameter für copilot create

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

pac copilot delete

Löschen eines benutzerdefinierten Copilot.

Erforderliche Parameter für copilot delete

--bot -id

Die Copilot-ID oder der Schemaname (eindeutiger Name in „Bot-Details“ oder der Dateiname im Lösungs-Explorer).

Optionale Parameter für copilot delete

--confirm -y

Erforderlich, um die Löschung des Kopiloten zu bestätigen.

Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

pac copilot extract-template

Extrahiert eine Vorlagendatei aus einem vorhandenen Copilot in einer Umgebung.

Example

Dieser Befehl extrahiert eine Vorlagendatei aus einem vorhandenen Copiloten in einer Umgebung.

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

Der Befehl gibt für einen Copiloten, der die Sprachen Englisch und Deutsch verwendet, eine Ausgabe wie die folgende zurück:

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

Erforderliche Parameter für copilot extract-template

--bot -id

Die Copilot-ID oder der Schemaname (eindeutiger Name in „Bot-Details“ oder der Dateiname im Lösungs-Explorer).

--templateFileName

Der Speicherort der YAML-Datei, in die die Copilot-Vorlage geschrieben werden soll.

Optionale Parameter für copilot extract-template

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

--overwrite -o

Überschreiben der Ausgabedatendatei zulassen, wenn sie bereits vorhanden ist

Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.

--templateName

Vorlagenname oder „kickStartTemplate“, wenn der Name nicht angegeben ist.

--templateVersion

Vorlagenversion im X.X.X-Format oder 1.0.0, wenn die Version nicht angegeben ist.

pac copilot extract-translation

Extrahiert eine Datei mit lokalisierten Inhalten für mindestens einen Bot.

Example

Dieser Befehl extrahiert eine Datei mit lokalisierten Inhalten für einen oder mehrere Copiloten.

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

Der Befehl gibt eine Ausgabe wie die folgende zurück:

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

Optionale Parameter für copilot extract-translation

--all -a

Schreiben Sie Lokalisierungsdateien für alle unterstützten Sprachen. Standardmäßig wird nur die Primärsprache geschrieben.

Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.

--bot -id

Die Copilot-ID oder der Schemaname (eindeutiger Name in „Bot-Details“ oder der Dateiname im Lösungs-Explorer).

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

--format

Das Dateiformat, in dem lokalisierte Dateien geschrieben werden sollen, entweder „resx“ oder „json“. Der Standardwert ist „resx“.

--outdir

Das Ausgabeverzeichnis, in das geschrieben werden soll.

--overwrite -o

Überschreiben der Ausgabedatendatei zulassen, wenn sie bereits vorhanden ist

Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.

--sourcedir -src

Quelllösungsverzeichnis. Wenn angegeben, wird die verbundene Umgebung bei der Suche nach Bots ignoriert und stattdessen nach Inhalten im Lösungsordner gesucht.

pac copilot init

Erstellen Sie einen neuen Copilot Studio Agent-Arbeitsbereich aus einer Vorlage.

pac copilot initErstellt ein Gerüst für einen neuen Copilot Studio Agent-Arbeitsbereich aus einer Vorlage. Es wird in einem von zwei Modi ausgeführt, und das Vorhandensein von --environment entscheidet, welcher Modus verwendet werden soll:

• Lokales Gerüst - Nein --environment. Schreibt die Vorlagendateien in das Projektverzeichnis und stoppt. Der Befehl erstellt nichts in Dataverse und erfordert keine Anmeldung. Verwenden Sie diesen Modus, wenn Sie lokal erstellen und später eine Verbindung mit einer Umgebung herstellen möchten.
• Bootstrap – --environment bereitgestellt. Erstellt ein Gerüst für die Dateien, packt sie in eine Lösung, importiert diese Lösung in die Umgebung und verbindet den Arbeitsbereich mit dem neu erstellten Agent. Dieser Modus ist der einstufige Pfad von nichts zu einem Live-, Synchronisierungs-fähigen Agent und erfordert ein authentifiziertes Profil.

Beispiele

Erstellen Sie ein Gerüst für einen Arbeitsbereich lokal:

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

Gerüst und Bootstrap eines Live-Agents in einer Umgebung in einem einzigen Schritt:

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

Erstellen Sie ein Gerüst für einen CLI-autorierten (CliCopilot)-Agent in einem bestimmten Ordner:

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

Erforderliche Parameter für copilot init

--name -n

Anzeigename des Agents.

--publisher-prefix -pp

Publisher Anpassungspräfix für die Lösung.

Optionale Parameter für copilot init

--authoring-mode -am

Das Agent-Erstellungs-Shape zum Gerüst (Standard: 'klassisch'). Verwenden Sie "cli-copilot", um ein CLI-autoriertes CliCopilot-Agentgerüst zu erstellen.

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

--instructions -ins

Anweisungen für das Agentsystem.

--project-dir -pd

Zielverzeichnis für den Agentarbeitsbereich. Standardmäßig wird das aktuelle Verzeichnis verwendet.

--schema-name -sn

Vollständiger Agent-Schemaname. Überschreibt die Standardableitung ({publisher-prefix}_{sanitized-name}). Wird as-is ohne Änderung verwendet.

--template -t

Vorlagenprofilname (Standard, minimal). Der Standardwert ist "Default".

Remarks

• Das Projektverzeichnis muss leer sein. init erstellt kein Gerüst für vorhandene Dateien. Zeigen Sie --project-dir daher auf einen neuen oder leeren Ordner.
• Schemanameableitung. Wenn Sie weglassen --schema-name, wird der Name des Agentschemas als {publisher-prefix}_{sanitized-name}. Übergeben Sie --schema-name den Wert, um ihn explizit festzulegen. Der Wert wird as-isverwendet.
• Bootstrap funktioniert für beide Erstellungsmodi. init --environment Bootstraps eines Live-Agents in einem Schritt für den klassischen Standardmodus und für --authoring-mode cli-copilot. Als Alternative für einen CliCopilot-Agent können Sie ein Gerüst lokal (nein --environment) erstellen pac copilot packpac solution import und dann ausführen, um es selbst bereitzustellen.
• Bootstrap erstellt serverseitige Objekte. Importiert im Bootstrap-Modus init eine Lösung und erstellt den Agent in der Zielumgebung. Wenn bereits ein Agent mit demselben Schemanamen vorhanden ist, stoppt und verweist Sie darauf, initpac copilot clone stattdessen eine Verbindung mit dem vorhandenen Agent herzustellen.
• Eine völlig neue Umgebung kann langsam sein, um den ersten Import zu akzeptieren. Eine frisch erstellte Umgebung kann eine oder zwei Minuten dauern, um sich aufzuwärmen. Ein früher Bootstrap kann mit "Async-Vorgänge sind derzeit für diese Organisation deaktiviert" fehlschlagen. Warten Sie einen Moment, und führen Sie sie erneut aus.
• --template (default oder minimal) gilt nur für den klassischen Dokumenterstellungsmodus.

pac copilot list

Liste der Copiloten in der aktuellen oder Zielumgebung von Dataverse.

Example

Dieser Befehl listet alle Copiloten in der aktuellen oder Ziel-Dataverse-Umgebung auf.

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

Der Befehl gibt eine Ausgabe wie die folgende zurück:

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

Optionale Parameter für copilot list

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

pac copilot mcp

Informationen zum lokalen MCP-Server (Model Context Protocol).

Example

pac copilot mcp --run

Optionale Parameter für copilot mcp

--run -r

Führen Sie den lokalen MCP-Server (Model Context Protocol) aus.

Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.

Remarks

Erfahren Sie, wie Sie die Power Platform CLI mit integriertem MCP-Server verwenden.

pac copilot merge-translation

Führen Sie Dateien mit lokalisierten Inhalten für mindestens einen Bot zusammen.

Example

Dieser Befehl führt Dateien mit lokalisierten Inhalten für einen oder mehrere Copiloten zusammen.

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

Der Befehl gibt beim Aktualisieren der deutschen Sprache eine Ausgabe wie die folgende zurück:

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.

Erfahren Sie, wie Sie Fehler des Befehls „merge-translation“ verwalten

Optionale Parameter für copilot merge-translation

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

--file -f

Die Liste der Dateien, die Übersetzungen enthalten. Globale Muster werden unterstützt.

--solution -s

Name der Lösung.

--sourcedir -src

Quelllösungsverzeichnis. Wenn angegeben, wird die verbundene Umgebung bei der Suche nach Bots ignoriert und stattdessen nach Inhalten im Lösungsordner gesucht.

--verbose

Beim Datenimport/-Export weitere Diagnoseinformationen angeben

Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.

--whatif

Führt den Befehl nicht aus, sondern gibt die Details des Geschehens aus.

Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.

Fehler bei „merge-translation“

Basierend auf dem obigen Beispiel sieht die Ausgabe folgendermaßen aus, wenn in der Datei, die zum Aktualisieren des Copiloten verwendet wird, ein Fehler vorliegt:

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.

Das Kennzeichen --verbose fügt Details zum Fehler hinzu:

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-Modelle in der aktuellen Umgebung

Example

Dieser Befehl listet alle AI Builder-Modelle auf.

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

Der Befehl gibt eine Ausgabe wie die folgende zurück:

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

Optionale Parameter für copilot model list

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

pac copilot model predict

Sendet Text oder Eingabeaufforderung an KI-Modell

Optionale Parameter für copilot model predict

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

--model-id -id

AI Builder-Modell-ID

--model-name -n

Vollständiger oder teilweiser Name des KI-Modells

--prompt -p

An KI-Modell zu sendende Aufforderung

--text -t

An KI-Modell zu sendenden Text

pac copilot model prepare-fetch

Nimmt die FetchXML-Datei aus dem großen KI-Sprachmodell (LLM) und bereitet sie für die Ausführung in der aktuellen Umgebung vor.

Erforderliche Parameter für copilot model prepare-fetch

--inputFile -i

FetchXML-Eingabedatei, die normalerweise von KI LLM stammt.

--outputFile -o

FetchXML-Ausgabedatei, die zur Ausführung in der aktuellen Umgebung bereit ist.

Optionale Parameter für copilot model prepare-fetch

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

pac copilot pack

Packen Sie einen Copilot Studio Agent-Arbeitsbereich in eine Lösungs-ZIP-Datei.

pac copilot pack packt einen Agent-Arbeitsbereich in eine Dataverse-Lösung .zip , mit pac solution importder Sie bereitstellen können. Es ist die eigenständige Form des Paketschritts, pac copilot init --environment der für Sie ausgeführt wird, sodass Sie die bereitstellungsfähige Lösung als separaten Schritt erstellen können, z. B. in einer Buildpipeline. Es funktioniert sowohl für klassische als auch für CLI-authored (CliCopilot)-Agent-Arbeitsbereiche.

Example

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

Erforderliche Parameter für copilot pack

--publisher-prefix -pp

Publisher Anpassungspräfix für die Lösung.

Optionale Parameter für copilot pack

--output-path -op

Ausgabepfad für die Lösungs-ZIP-Datei. Standardmäßig wird das aktuelle Verzeichnis verwendet.

--project-dir -pd

Agent-Arbeitsbereichsverzeichnis zum Packen. Standardmäßig wird das aktuelle Verzeichnis verwendet.

--solution-name -sn

Eindeutiger Name der Lösung. Wenn nicht angegeben, abgeleitet vom Namen des Agentschemas.

Remarks

• Es ist ein lokaler Vorgang. Pack liest den Arbeitsbereich und schreibt eine Lösung .zip. Sie benötigt keine Authentifizierung und keine Umgebung, sodass sie sicher in einer Buildpipeline ausgeführt werden kann.
• Das Herausgeberpräfix muss gültig sein. --publisher-prefix muss ein wohlgeformtes Anpassungspräfix sein, oder das Pack wird beendet, bevor etwas geschrieben wird.
• Lösungsname und -ausgabe. Wenn Sie weglassen --solution-name, wird der eindeutige Name der Lösung vom Agentschemanamen abgeleitet. Die .zip Datei wird in das aktuelle Verzeichnis geschrieben, es sei denn, Sie legen fest --output-path.
• Pack wird nicht bereitgestellt. Sie erzeugt die Lösung, importiert sie aber nicht. Folgen Sie diesem pac solution import , um den Agent bereitzustellen, und pac copilot clone wenn Sie einen mit der Synchronisierung verbundenen Arbeitsbereich dafür benötigen.

pac copilot publish

Benutzerdefinierten Copilot veröffentlichen

Erforderliche Parameter für copilot publish

--bot -id

Die Copilot-ID oder der Schemaname (eindeutiger Name in „Bot-Details“ oder der Dateiname im Lösungs-Explorer).

Optionale Parameter für copilot publish

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

pac copilot pull

Ziehen Sie Remoteänderungen aus Copilot Studio, und führen Sie sie mit dem lokalen Arbeitsbereich zusammen.

Der pac copilot pull Befehl ruft den aktuellen Serverstatus des Agents ab und führt ihn mithilfe einer dreiseitigen Zusammenführung in Ihren lokalen Arbeitsbereich zusammen. Dieser Prozess stellt sicher, dass serverseitige Bearbeitungen und Ihre unberührten lokalen Dateien beide intakt bleiben. Führen Sie sie aus, bevor Sie mit der Bearbeitung beginnen, und führen Sie sie erneut aus, bevor Sie die Änderungen übertragen.

Example

Führen Sie den Befehl aus dem Arbeitsbereichsordner aus:

pac copilot pull

Oder zeigen Sie ihn an einem arbeitsbereich an anderer Stelle auf dem Datenträger:

pac copilot pull --project-dir contoso-support

Optionale Parameter für copilot pull

--project-dir -pd

Pfad zum Projektverzeichnis. Standardmäßig wird das aktuelle Arbeitsverzeichnis verwendet.

Remarks

• Führen Sie sie in einem Synchronisierungsarbeitsbereich aus. Der pull Befehl funktioniert nur in einem Ordner, der von pac copilot clone oder pac copilot init. Sie liest die Zielumgebung und den Agent aus den Synchronisierungsmetadaten des Arbeitsbereichs, weshalb kein --environment Argument vorhanden ist. Wenn Sie sie an einer anderen Stelle ausführen, tritt ein Fehler beim Fehler "Arbeitsbereich nicht gefunden" auf.
• Sie schreibt in Ihre lokalen Dateien. Ziehen Sie Remoteänderungen in den Arbeitsbereich zusammen und lädt Wissensdateien herunter. Übernehmen oder sichern Sie lokale Arbeit, die Sie sich vor dem Ziehen kümmern.
• Melden Sie sich zuerst mit pac auth create.

pac copilot push

Pushen Sie lokale Arbeitsbereichsänderungen an Copilot Studio.

pac copilot push sendet die Änderungen in Ihrem lokalen Arbeitsbereich zurück an den Agent in Dataverse. Sie vergleicht Ihre Dateien mit dem letzten bekannten Serverstatus, lädt nur das, was geändert wurde – einschließlich Wissensdateien, Cloudflüssen und Verbindungsverweise – und meldet, was er pushte.

Example

Führen Sie sie aus dem Arbeitsbereichsordner aus:

pac copilot push

Oder zeigen Sie ihn an einem arbeitsbereich an anderer Stelle auf dem Datenträger:

pac copilot push --project-dir contoso-support

Optionale Parameter für copilot push

--project-dir -pd

Pfad zum Projektverzeichnis. Standardmäßig wird das aktuelle Arbeitsverzeichnis verwendet.

Remarks

• Führen Sie sie in einem Synchronisierungsarbeitsbereich aus. Wie pull, push funktioniert nur in einem Ordner, der von pac copilot clone oder pac copilot init. Sie liest die Zielumgebung aus den Synchronisierungsmetadaten des Arbeitsbereichs. Es gibt kein --environment Argument.
• Ziehen Sie zuerst, wenn ein Konflikt vorliegt. Wenn dasselbe Element sowohl lokal als auch auf dem Server geändert wurde, werden Pushstopps beendet, und Sie werden aufgefordert, vor dem Erneuten Versuch auszuführen pac copilot pull . Dieser Vorgang verhindert, dass ein Push automatisch eine serverseitige Änderung überschreibt, die Sie nicht sehen konnten.
• Keine lokalen Änderungen sind eine no-op. Wenn push nichts zu senden findet, meldet es dies und beendet, ohne die Umgebung zu berühren.
• Ein erfolgreicher Push mutiert den Live-Agent in der Zielumgebung.
• Melden Sie sich zuerst mit pac auth create.

pac copilot quarantine

Quarantänestatus des Copilot-Agenten.

Erforderliche Parameter für copilot quarantine

--bot-id -id

Die ID des Copiloten zur Quarantäne/Entquarantäne.

Optionale Parameter für copilot quarantine

--environment -env

Umgebung (ID, Organisations-ID, URL, eindeutiger Name oder teilweiser Name)

--status -s

Quarantänestatuswert. wahr = Quarantäne, falsch = Nicht-Quarantäne. Die Standardeinstellung ist „true“.

Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.

pac copilot status

Rufen Sie den Bereitstellungsstatus eines angegebenen Copiloten in der aktuellen oder Zielumgebung von Dataverse ab.

Example

Dieser Befehl fragt den Bereitstellungsstatus eines angegebenen Copiloten in der aktuellen oder Ziel-Dataverse-Umgebung ab.

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

Der Befehl gibt eine Ausgabe wie die folgende zurück:

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

Erforderliche Parameter für copilot status

--bot-id -id

Die ID eines Copiloten (Chatbot).

Optionale Parameter für copilot status

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

Authentifizierung und Umgebung für die Synchronisierungsbefehle

Die cloneBefehle , pull, pushund init --environment Befehle sprechen alle mit einer Dataverse-Umgebung, sodass sie ein Authentifizierungsprofil benötigen. Melden Sie sich zuerst mit pac auth create.

• clone, pullund push erfordern ein aktives Profil. pac copilot init Benötigt nur eine, wenn Sie übergeben --environment; ohne sie, init erstellt Gerüste für Dateien lokal und benötigt keine Anmeldung.
• pull und push lesen Sie die Zielumgebung aus den Synchronisierungsmetadaten des Arbeitsbereichs, sodass sie kein Argument annehmen --environment . clone und init tun Sie es.
• pac copilot pack ist rein lokal. Es liest und schreibt nur Dateien, sodass sie keine Authentifizierung und keine Umgebung benötigt.

pull und push arbeiten nur innerhalb eines Arbeitsbereichs, der von clone oder init. Die beim Erstellen des Arbeitsbereichs geschriebenen Synchronisierungsmetadaten teilt ihnen mit, mit welchem Agent und welcher Umgebung zu sprechen ist, sodass die Ausführung an einer anderen Stelle schnell mit einem Fehler "Arbeitsbereich nicht gefunden" fehlschlägt.

Siehe auch

Microsoft Power Platform CLI-Befehlsgruppen
Microsoft Power Platform CLI – Übersicht