Pac-Copilot

  • Artikel

Tools und Dienstprogramme für die Copilot-Verwaltung

Befehle

Command Beschreibung
pac copilot create Erstellt einen neuen Bot mithilfe einer vorhandenen Vorlagendatei als Referenz.
pac copilot extract-template Extrahiert eine Vorlagendatei aus einem vorhandenen Bot in einer Umgebung.
pac copilot extract-translation Extrahiert eine Datei mit lokalisierten Inhalten für mindestens einen Bot.
Pac-Copilot-Liste Liste virtueller Agents in der aktuellen oder Zielumgebung von Dataverse.
pac copilot merge-translation Führen Sie Dateien mit lokalisierten Inhalten für mindestens einen Bot zusammen.
pac copilot model list AI Builder-Modelle in der aktuellen Umgebung
pac copilot model predict Sendet Text oder Eingabeaufforderung an KI-Modell
pac copilot model prepare-fetch Nimmt die FetchXML-Datei vom KI Large Language Model (LLM) und bereitet sie für die Ausführung in der aktuellen Umgebung vor
pac copilot status Abruf des Bereitstellungsstatus eines angegebenen virtuellen Agents in der aktuellen oder Zielumgebung von Dataverse.

pac copilot create

Erstellt einen neuen Bot mithilfe einer vorhandenen Vorlagendatei als Referenz.

Erforderliche Parameter für das Erstellen von Copiloten

--displayName

Der Anzeigename des neuen Bots

--schemaName

Der Schemaname (eindeutiger Name) des neuen Bots.

--solution -s

Name der Lösung.

--templateFileName

YAML-Quelldatei mit der Bot-Vorlage, die mit dem extract-template-Befehl extrahiert wurde.

Optionale Parameter für das Erstellen von Copiloten

--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 Bot in einer Umgebung.

Beispiel

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 die Vorlage zum Extrahieren von Copiloten

--bot -id

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

--templateFileName

Speicherort der Yaml-Datei, in die die Bot-Vorlage geschrieben werden soll.

Optionale Parameter für die Vorlage zum Extrahieren von Copiloten

--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.

pac copilot extract-translation

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

Beispiel

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 das Extrahieren von übersetzten Copiloten

--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 Chatbot-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-Liste

Liste virtueller Agents in der aktuellen oder Zielumgebung von Dataverse.

Beispiel

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 Anytyhing 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-Listen

--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 merge-translation

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

Beispiel

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 das Zusammenführen von Copilot-Übersetzungen

--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

Beispiel

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-Modelllisten

--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 die Copilot-Modellvorhersage

--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 vom KI Large Language Model (LLM) und bereitet sie für die Ausführung in der aktuellen Umgebung vor

Erforderliche Parameter für die Vorbereitung des Copilot-Modellabrufs

--inputFile -i

Die FetchXML-Eingabedatei stammt in der Regel von KI-LLM.

--outputFile -o

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

Optionale Parameter für die Vorbereitung des Copilot-Modellabrufs

--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 status

Abruf des Bereitstellungsstatus eines angegebenen virtuellen Agents in der aktuellen oder Zielumgebung von Dataverse.

Beispiel

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 den Copilotstatus

--bot-id -id

Die ID eines virtuellen Agents (Chatbot)

Optionale Parameter für den Copilotstatus

--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.

Siehe auch

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