pac copilot

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

Polecenia init, , pullclone, pushi pack pozwalają zachować agenta Copilot Studio jako zestaw plików na dysku, edytować go lokalnie i synchronizować ze środowiskiem Dataverse.

Typowa pętla wygląda następująco:

1. Uruchom obszar roboczy. Utwórz szkielet zupełnie nowego agenta z programem pac copilot initlub pobierz istniejący z programem pac copilot clone. Tak czy inaczej uzyskujesz lokalny obszar roboczy, który przenosi metadane synchronizacji, od których zależą inne polecenia.
2. Przeciągnij przed edycją. pac copilot pull przenosi zmiany zdalne w dół i scala je z plikami lokalnymi, więc zaczynasz od bieżącego stanu serwera.
3. Wypychanie po zakończeniu. pac copilot push wysyła zmiany lokalne. Jeśli ten sam element został zmieniony na serwerze w międzyczasie, wypychanie zatrzymuje się i prosi o jego ściągnięcie.
4. Pakiet do wdrożenia. pac copilot pack zamienia obszar roboczy w rozwiązanie .zip , które można wdrożyć za pomocą polecenia pac solution import.

Aby przejść od niczego do agenta na żywo w jednym kroku, pac copilot init --environment szkieletach, pakietach, importach i połączeniu obszaru roboczego. Poszczególne polecenia pozwalają samodzielnie prowadzić każdą część pętli.

Commands

pac copilot clone

Sklonuj agenta Copilot Studio do lokalnego katalogu obszarów roboczych.

pac copilot clonepobiera istniejącego agenta Copilot Studio do lokalnego katalogu obszarów roboczych wraz z metadanymi synchronizacji, które pac copilot pull i pac copilot push na których polegają. Pliki agenta są zapisywane w podfolderze o nazwie po nazwie wyświetlanej.

Example

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

Wymagane parametry dla copilot clone

--bot -id

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

Parametry opcjonalne dla copilot clone

--component-collection -cc

Identyfikator kolekcji składników do sklonowania. Powtórz dla wielu.

--display-name -dn

Nazwa wyświetlana agenta (używana do nazewnictwa folderów).

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

--output-dir -od

Folder główny dla danych wyjściowych klonowania. Domyślnie jest to bieżący katalog.

Remarks

• --botakceptuje identyfikator Copilot lub nazwę schematu. Przekaż identyfikator Copilot (identyfikator GUID) lub nazwę schematu agenta. Polecenie rozpoznaje nazwę schematu w środowisku docelowym.
• Podfolder docelowy musi być pusty. Klonowanie zapisuje w folderze o nazwie po nazwie wyświetlanej agenta (oczyszczonej) w obszarze --output-dir. Jeśli ten folder zawiera już pliki, klon zatrzymuje je zamiast zastępować. Użyj --display-name polecenia , aby wybrać inną nazwę folderu.
• Klonowanie kolekcji składników. Aby przenieść kolekcje składników w dół obok agenta, przekaż co najmniej jeden identyfikator kolekcji z elementem --component-collection, oddzielony średnikami.
• Klonowanie wymaga uwierzytelnionego profilu (pac auth create) i rozpoznaje środowisko z --environmentprogramu lub organizacji aktywnego profilu, gdy go pomijasz.

pac copilot create

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

Wymagane parametry dla copilot create

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

Usuń Copilot niestandardowe.

Wymagane parametry dla copilot delete

--bot -id

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

Parametry opcjonalne dla copilot delete

--confirm -y

Wymagane do potwierdzenia usunięcia copilot.

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

--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 copilot extract-template

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

Parametry opcjonalne dla copilot extract-template

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

Parametry opcjonalne dla copilot extract-translation

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

Utwórz nowy obszar roboczy agenta Copilot Studio na podstawie szablonu.

pac copilot initSzkielety nowego obszaru roboczego agenta Copilot Studio z szablonu. Jest uruchamiany w jednym z dwóch trybów, a obecność --environment decyduje, który tryb ma być używany:

• Lokalny szkielet — nie --environment. Zapisuje pliki szablonów w katalogu projektu i zatrzymuje się. Polecenie nie tworzy żadnych elementów w usłudze Dataverse i nie wymaga logowania. Użyj tego trybu, jeśli chcesz utworzyć lokalnie i połączyć się z środowiskiem później.
• Bootstrap — --environment dostarczone. Tworzy szkielet plików, pakuje je do rozwiązania, importuje to rozwiązanie do środowiska i łączy obszar roboczy z nowo utworzonym agentem. Ten tryb jest jednoetapową ścieżką od niczego do agenta gotowego do synchronizacji i wymaga uwierzytelnionego profilu.

Examples

Tworzenie szkieletu obszaru roboczego lokalnie:

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

Tworzenie szkieletu i uruchamianie agenta na żywo w środowisku w jednym kroku:

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

Tworzenie szkieletu agenta interfejsu wiersza polecenia (CliCopilot) w określonym folderze:

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

Wymagane parametry dla copilot init

--name -n

Nazwa wyświetlana agenta.

--publisher-prefix -pp

Publisher prefiks dostosowywania rozwiązania.

Parametry opcjonalne dla copilot init

--authoring-mode -am

Kształt tworzenia agenta do szkieletu (ustawienie domyślne: "klasyczny"). Użyj polecenia "cli-copilot", aby utworzyć szkielet utworzonego przez interfejs wiersza polecenia agenta CliCopilot.

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

--instructions -ins

Instrukcje dotyczące systemu agenta.

--project-dir -pd

Katalog docelowy dla obszaru roboczego agenta. Domyślnie jest to bieżący katalog.

--schema-name -sn

Pełna nazwa schematu agenta. Zastępuje domyślne wyprowadzenie ({publisher-prefix}_{sanitized-name}). Używane as-is bez modyfikacji.

--template -t

Nazwa profilu szablonu (wartość domyślna, minimalna). Wartość domyślna to "default".

Remarks

• Katalog projektu musi być pusty. init program nie utworzy szkieletu istniejących plików, dlatego wskaż --project-dir nowy lub pusty folder.
• Wyprowadzanie nazwy schematu. Po pominiętiu --schema-namenazwa schematu agenta jest kompilowana jako {publisher-prefix}_{sanitized-name}. Przekaż --schema-name go jawnie. Wartość jest używana as-is.
• Bootstrap działa w obu trybach tworzenia. init --environmenturuchamia agenta na żywo w jednym kroku dla domyślnego trybu klasycznego i dla .--authoring-mode cli-copilot Alternatywą dla agenta cliCopilot jest możliwość tworzenia szkieletu lokalnie (bez --environment), a następnie uruchamiania pac copilot pack , a następnie pac solution import wdrażania go samodzielnie.
• Bootstrap tworzy obiekty po stronie serwera. W trybie init uruchamiania importuje rozwiązanie i tworzy agenta w środowisku docelowym. Jeśli agent o tej samej nazwie schematu już istnieje, init zatrzymuje się i wskazuje, aby nawiązać pac copilot clone połączenie z istniejącym agentem.
• Całkiem nowe środowisko może być powolne, aby zaakceptować pierwszy import. Świeżo utworzone środowisko może potrwać minutę lub dwie, aby się rozgrzać. Wczesne uruchamianie może zakończyć się niepowodzeniem z powodu "Operacje asynchroniczne są obecnie wyłączone dla tej organizacji". Poczekaj chwilę i uruchom go ponownie.
• --template (default lub minimal) dotyczy tylko klasycznego trybu tworzenia.

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

Parametry opcjonalne dla copilot list

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

--run -r

Uruchom lokalny serwer MCP (Model Context Protocol).

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

Remarks

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

Parametry opcjonalne dla copilot merge-translation

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

Parametry opcjonalne dla copilot model list

--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 copilot model predict

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

Parametry opcjonalne dla copilot model 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 pack

Spakuj obszar roboczy agenta Copilot Studio do pliku zip rozwiązania.

pac copilot pack pakuje obszar roboczy agenta do rozwiązania .zip Dataverse, które można wdrożyć za pomocą pac solution importpolecenia . Jest to autonomiczna forma kroku pakowania, który pac copilot init --environment jest uruchamiany dla Ciebie, dzięki czemu można utworzyć możliwe do wdrożenia rozwiązanie jako oddzielny krok — na przykład w potoku kompilacji. Działa zarówno w przypadku obszarów roboczych agentów klasycznych, jak i interfejsu wiersza polecenia (CliCopilot).

Example

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

Wymagane parametry dla copilot pack

--publisher-prefix -pp

Publisher prefiks dostosowywania rozwiązania.

Parametry opcjonalne dla copilot pack

--output-path -op

Ścieżka wyjściowa pliku zip rozwiązania. Domyślnie jest to bieżący katalog.

--project-dir -pd

Katalog obszaru roboczego agenta do pakietu. Domyślnie jest to bieżący katalog.

--solution-name -sn

Unikatowa nazwa rozwiązania. Jeśli pominięto, pochodzi z nazwy schematu agenta.

Remarks

• Jest to operacja lokalna. Pakiet odczytuje obszar roboczy i zapisuje rozwiązanie .zip. Nie wymaga uwierzytelniania ani środowiska, więc można bezpiecznie uruchomić je w potoku kompilacji.
• Prefiks wydawcy musi być prawidłowy. --publisher-prefix musi być poprawnie sformułowanym prefiksem dostosowywania lub pakiet zatrzymuje się przed zapisaniem czegokolwiek.
• Nazwa i dane wyjściowe rozwiązania. Jeśli pominięto --solution-name, unikatowa nazwa rozwiązania pochodzi z nazwy schematu agenta. Parametr .zip jest zapisywany w bieżącym katalogu, chyba że ustawiono wartość --output-path.
• Pakiet nie jest wdrażany. Tworzy rozwiązanie, ale nie importuje go. Postępuj zgodnie z instrukcjami pac solution import , aby wdrożyć agenta, a następnie pac copilot clone , jeśli chcesz mieć dla niego połączony z synchronizacją obszar roboczy.

pac copilot publish

Publikowanie niestandardowego copilot

Wymagane parametry dla copilot publish

--bot -id

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

Parametry opcjonalne dla copilot publish

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

Ściąganie zmian zdalnych z Copilot Studio i scalanie z lokalnym obszarem roboczym.

Polecenie pac copilot pull pobiera bieżący stan serwera agenta i scala go z lokalnym obszarem roboczym przy użyciu scalania trzykierunkowego. Ten proces gwarantuje, że zmiany po stronie serwera i nietknięte pliki lokalne pozostaną nienaruszone. Uruchom go przed rozpoczęciem edycji i uruchom go ponownie przed wypchnięciem zmian.

Example

Uruchom polecenie z poziomu folderu obszaru roboczego:

pac copilot pull

Możesz też wskazać obszar roboczy w innym miejscu na dysku:

pac copilot pull --project-dir contoso-support

Parametry opcjonalne dla copilot pull

--project-dir -pd

Ścieżka do katalogu projektu. Domyślnie jest to bieżący katalog roboczy.

Remarks

• Uruchom go w obszarze roboczym synchronizacji. Polecenie pull działa tylko w folderze utworzonym przez pac copilot clone program lub pac copilot init. Odczytuje środowisko docelowe i agenta z metadanych synchronizacji obszaru roboczego, dlatego nie ma --environment argumentu. Jeśli uruchomisz go gdziekolwiek indziej, zakończy się niepowodzeniem z powodu błędu "Nie znaleziono obszaru roboczego".
• Zapisuje w plikach lokalnych. Ściąganie scala zmiany zdalne z obszarem roboczym i pobiera pliki wiedzy. Zatwierdź lub wykonaj kopię zapasową lokalnej pracy, którą chcesz wykonać przed ich pociągnięciem.
• Najpierw zaloguj się przy użyciu polecenia pac auth create.

pac copilot push

Wypychanie zmian obszaru roboczego lokalnego do Copilot Studio.

pac copilot push wysyła zmiany w lokalnym obszarze roboczym z powrotem do agenta w usłudze Dataverse. Porównuje pliki z ostatnim znanym stanem serwera, przekazuje tylko zmiany — w tym pliki wiedzy, przepływy w chmurze i odwołania do połączeń — i zgłasza, co wypchnęło.

Example

Uruchom go z poziomu folderu obszaru roboczego:

pac copilot push

Możesz też wskazać obszar roboczy w innym miejscu na dysku:

pac copilot push --project-dir contoso-support

Parametry opcjonalne dla copilot push

--project-dir -pd

Ścieżka do katalogu projektu. Domyślnie jest to bieżący katalog roboczy.

Remarks

• Uruchom go w obszarze roboczym synchronizacji. Podobnie jak pullpolecenie , push działa tylko w folderze utworzonym przez pac copilot clone program lub pac copilot init. Odczytuje środowisko docelowe z metadanych synchronizacji obszaru roboczego. Nie ma --environment argumentu.
• Najpierw ściągaj, jeśli występuje konflikt. Jeśli ten sam element zmienił się zarówno lokalnie, jak i na serwerze, wypchnij zatrzymuje działanie i prosi o uruchomienie pac copilot pull przed ponowną próbą. Ten proces utrzymuje wypychanie przed dyskretnym zastąpieniem zmiany po stronie serwera, której nie widać.
• Żadne zmiany lokalne nie są no-op. Jeśli wypychanie nie znajdzie niczego do wysłania, zgłasza to i kończy się bez dotykania środowiska.
• Pomyślne wypychanie wycisza agenta na żywo w środowisku docelowym.
• Najpierw zaloguj się przy użyciu polecenia pac auth create.

pac copilot quarantine

Status kwarantanny agenta drugiego pilota.

Wymagane parametry dla copilot quarantine

--bot-id -id

Identyfikacja drugiego pilota do kwarantanny/odkwarantanny.

Parametry opcjonalne dla copilot quarantine

--environment -env

Środowisko (identyfikator, identyfikator organizacji, adres URL, unikatowa nazwa lub nazwa częściowa).

--status -s

Wartość statusu kwarantanny. true = kwarantanna, false = odkwarantanna. Domyślnie ustawione na true.

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

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

--bot-id -id

Identyfikator copilot (Chatbot).

Parametry opcjonalne dla copilot status

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

Uwierzytelnianie i środowisko poleceń synchronizacji

Polecenia clone, pull, pushi init --environment komunikują się ze środowiskiem usługi Dataverse, więc potrzebują profilu uwierzytelniania. Najpierw zaloguj się przy użyciu polecenia pac auth create.

• clone, pulli push wymaga aktywnego profilu. pac copilot init Wymaga tylko jednego podczas przekazywania --environment; bez niego init pliki szkieletów lokalnie i nie wymagają logowania.
• pull i push odczytuje środowisko docelowe z metadanych synchronizacji obszaru roboczego, więc nie przyjmują argumentu --environment . clone i init zrobić.
• pac copilot pack jest czysto lokalny. Odczytuje i zapisuje tylko pliki, więc nie wymaga uwierzytelniania i środowiska.

pull i push działają tylko w obszarze roboczym utworzonym przez clone program lub init. Metadane synchronizacji zapisywane podczas tworzenia obszaru roboczego informują o tym, z którym agentem i środowiskiem rozmawiają, więc uruchomienie ich w dowolnym miejscu kończy się niepowodzeniem z powodu błędu "nie znaleziono obszaru roboczego".

Zobacz też

Microsoft Power Platform grupy poleceń interfejsu wiersza polecenia
omówienie interfejsu wiersza polecenia Microsoft Power Platform