pac copilot

Narzędzia i narzędzia do zarządzania copilot

Commands

pac copilot create

Tworzy nowy copilot przy użyciu istniejącego pliku szablonu jako odwołania.

Wymagane parametry do utworzenia narzędzia copilot

--displayName

Nazwa wyświetlana nowego copilot

--schemaName

Nazwa schematu (unikatowa nazwa) nowego copilotu.

--solution -s

Nazwa rozwiązania.

--templateFileName

Źródłowy plik yaml zawierający szablon copilot wyodrębniony przy użyciu polecenia extract-template.

Parametry opcjonalne dla polecenia copilot create

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

pac copilot extract-template

Wyodrębnia plik szablonu z istniejącego narzędzia copilot w środowisku.

Example

To polecenie wyodrębnia plik szablonu z istniejącego narzędzia copilot w środowisku.

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

Polecenie zwraca dane wyjściowe podobne do następujących w przypadku narzędzia copilot przy użyciu języków angielskich i niemieckich:

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

Wymagane parametry dla wyodrębniania szablonu copilot

--bot -id

Identyfikator copilot lub nazwa schematu (unikatowa nazwa znaleziona w obszarze Szczegóły bota lub nazwa pliku w Eksploratorze rozwiązań).

--templateFileName

Lokalizacja pliku yaml do zapisania szablonu copilot.

Opcjonalne parametry dla wyodrębniania szablonu copilot

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

--overwrite -o

Zezwalaj na zastępowanie wyjściowego pliku danych, jeśli już istnieje.

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

--templateName

Nazwa szablonu lub "kickStartTemplate", jeśli nie określono nazwy.

--templateVersion

Wersja szablonu w formacie X.X.X lub 1.0.0, jeśli nie określono wersji.

pac copilot extract-translation

Wyodrębnia plik zawierający zlokalizowaną zawartość dla co najmniej jednego bota.

Example

To polecenie wyodrębnia plik zawierający zlokalizowaną zawartość dla co najmniej jednego copilots.

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

Polecenie zwraca dane wyjściowe podobne do następujących:

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

Opcjonalne parametry dla funkcji wyodrębniania z interfejsu copilot

--all -a

Zapisz pliki lokalizacji dla wszystkich obsługiwanych języków. Domyślnie tylko język podstawowy jest pisany.

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

--bot -id

Identyfikator copilot lub nazwa schematu (unikatowa nazwa znaleziona w obszarze Szczegóły bota lub nazwa pliku w Eksploratorze rozwiązań).

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

--format

Format pliku, w którym mają być zapisywane zlokalizowane pliki, "resx" lub "json". Wartość domyślna to "resx".

--outdir

Katalog wyjściowy do zapisu.

--overwrite -o

Zezwalaj na zastępowanie wyjściowego pliku danych, jeśli już istnieje.

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

--sourcedir -src

Katalog rozwiązania źródłowego. Po określeniu zignoruj połączone środowisko podczas wyszukiwania botów, a zamiast tego wyszuka zawartość w folderze rozwiązania.

pac copilot list

Lista copilots w bieżącym lub docelowym środowisku Dataverse.

Example

To polecenie wyświetla listę wszystkich copilots w bieżącym lub docelowym środowisku Dataverse.

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

Polecenie zwraca dane wyjściowe podobne do następujących:

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

Opcjonalne parametry listy copilot

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

pac copilot mcp

Informacje o lokalnym serwerze MCP (Model Context Protocol).

Example

pac copilot mcp --run

Parametry opcjonalne dla mcp copilot

--run -r

Uruchom lokalny serwer MCP (Model Context Protocol).

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

Uwagi

Dowiedz się, jak używać interfejsu wiersza polecenia platformy Power Platform z wbudowanym serwerem MCP

pac copilot merge-translation

Scal pliki zawierające zlokalizowaną zawartość dla co najmniej jednego bota.

Example

To polecenie scala pliki zawierające zlokalizowaną zawartość dla co najmniej jednego copilots.

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

Polecenie zwraca dane wyjściowe podobne do następujących podczas aktualizowania języka niemieckiego:

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.

Dowiedz się, jak zarządzać błędami za pomocą polecenia merge-translation

Opcjonalne parametry dla funkcji scalania-tłumaczenia copilot

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

--file -f

Lista plików zawierających tłumaczenia. Wzorce glob są obsługiwane.

--solution -s

Nazwa rozwiązania.

--sourcedir -src

Katalog rozwiązania źródłowego. Po określeniu zignoruj połączone środowisko podczas wyszukiwania botów, a zamiast tego wyszuka zawartość w folderze rozwiązania.

--verbose

Wyprowadź więcej informacji diagnostycznych podczas importowania/eksportowania danych

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

--whatif

Nie wykonuje polecenia, ale generuje szczegółowe informacje o tym, co się stanie.

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

błędy scalania tłumaczenia

Na podstawie powyższego przykładu, jeśli w pliku istnieje jeden błąd używany do aktualizacji copilot, dane wyjściowe wyglądają następująco:

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.

Flaga --verbose dodaje szczegółowe informacje o błędzie:

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

Modele narzędzia AI Builder w bieżącym środowisku.

Example

To polecenie wyświetla listę wszystkich modeli narzędzia AI Builder.

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

Polecenie zwraca dane wyjściowe podobne do następujących:

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

Opcjonalne parametry listy modeli copilot

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

pac copilot model predict

Wysyła tekst lub monit do modelu sztucznej inteligencji

Parametry opcjonalne dla przewidywania modelu copilot

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

--model-id -id

Identyfikator modelu narzędzia AI Builder

--model-name -n

Pełna lub częściowa nazwa modelu sztucznej inteligencji

--prompt -p

Monit o wysłanie do modelu AI

--text -t

Tekst do wysłania do modelu AI

pac copilot model prepare-fetch

Pobiera plik FetchXML z modelu AI Large Language Model (LLM) i przygotowuje go do wykonania w bieżącym środowisku.

Wymagane parametry dla modelu copilot prepare-fetch

--inputFile -i

Wejściowy plik FetchXML, który zwykle pochodzi z usługi AI LLM.

--outputFile -o

Wyjściowy plik FetchXML, który jest gotowy do wykonania w bieżącym środowisku.

Opcjonalne parametry dla modelu copilot prepare-fetch

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

pac copilot publish

Publikowanie niestandardowego copilot

Wymagane parametry dla publikowania narzędzia copilot

--bot -id

Identyfikator copilot lub nazwa schematu (unikatowa nazwa znaleziona w obszarze Szczegóły bota lub nazwa pliku w Eksploratorze rozwiązań).

Opcjonalne parametry publikowania narzędzia copilot

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

pac copilot status

Sonduj stan wdrożenia określonego copilotu w bieżącym lub docelowym środowisku usługi Dataverse.

Example

To polecenie sonduje stan wdrożenia określonego copilot w bieżącym lub docelowym środowisku Dataverse.

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

Polecenie zwraca dane wyjściowe podobne do następujących:

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

Wymagane parametry stanu copilot

--bot-id -id

Identyfikator copilot (Chatbot).

Opcjonalne parametry stanu copilot

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

Zobacz także

Grupy poleceń interfejsu wiersza polecenia platformy Microsoft Power Platform
Omówienie interfejsu wiersza polecenia platformy Microsoft Power Platform