pac copilot

Nástroje a nástroje pro správu copilotu

Příkazy init, , pushclonepulla pack příkazy umožňují udržovat agenta Copilot Studio jako sadu souborů na disku, upravit ho místně a synchronizovat s prostředím Dataverse.

Typická smyčka vypadá takto:

1. Spusťte pracovní prostor. Vygenerování zcela nového agenta pomocí pac copilot initnebo stažení existujícího agenta s pac copilot clone. V obou směrech získáte místní pracovní prostor, který přenáší metadata synchronizace, na které ostatní příkazy závisejí.
2. Před úpravami stáhněte. pac copilot pull přenese vzdálené změny dolů a sloučí je do místních souborů, takže začnete od aktuálního stavu serveru.
3. Nasdílení změn, až skončíte. pac copilot push odešle zpět místní změny. Pokud se mezitím stejná položka na serveru změnila, nabízená oznámení se zastaví a požádá o přijetí změn jako první.
4. Balíček pro nasazení pac copilot pack změní pracovní prostor na řešení .zip , pomocí pac solution importkteré můžete nasadit .

Pokud chcete přejít od ničeho k živému agentu v jednom kroku, pac copilot init --environment generování uživatelského rozhraní, balíčků, importů a připojení pracovního prostoru za vás. Jednotlivé příkazy umožňují řídit jednotlivé části smyčky samostatně.

Commands

pac copilot clone

Naklonujte agenta Copilot Studio do místního adresáře pracovního prostoru.

pac copilot clonestáhne existujícího agenta Copilot Studio do místního adresáře pracovního prostoru společně s metadaty synchronizace, na které pac copilot pullpac copilot push se spoléhají. Soubory agenta se zapíšou do podsložky pojmenované za jeho zobrazovaný název.

Example

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

Požadované parametry pro copilot clone

--bot -id

ID nebo název schématu Copilot (jedinečný název nalezený v podrobnostech robota nebo názvu souboru v Průzkumníku řešení).

Volitelné parametry pro copilot clone

--component-collection -cc

ID kolekce komponent pro klonování. Opakujte pro více.

--display-name -dn

Zobrazovaný název agenta (používá se pro pojmenování složek).

--environment -env

Určuje cílovou službu Dataverse. Hodnota může být identifikátor GUID nebo absolutní adresa URL https. Pokud nezadáte, použije se aktivní organizace vybraná pro aktuální profil ověřování.

--output-dir -od

Kořenová složka pro výstup klonování Výchozí hodnota je aktuální adresář.

Remarks

• --botpřijímá Copilot ID nebo název schématu. Předejte ID Copilot (GUID) nebo název schématu agenta. Příkaz přeloží název schématu pro cílové prostředí.
• Cílová podsložka musí být prázdná. Klonuje zápis do složky pojmenované za zobrazovaný název agenta (sanitized) v části --output-dir. Pokud už tato složka obsahuje soubory, klonování se zastaví a nepřepíše je. Slouží --display-name k výběru jiného názvu složky.
• Klonování kolekcí komponent Pokud chcete přenést kolekce komponent vedle agenta, předejte jedno nebo více ID kolekcí s --component-collectionoddělovačí středníky.
• Klon vyžaduje ověřený profil (pac auth create) a přeloží prostředí z --environmentorganizace aktivního profilu, když ho vynecháte.

pac copilot create

Vytvoří nový kopírovaný objekt pomocí existujícího souboru šablony jako odkazu.

Požadované parametry pro copilot create

--displayName

Zobrazovaný název nového copilotu

--schemaName

Název schématu (jedinečný název) nového kopírovaného objektu.

--solution -s

Název řešení

--templateFileName

Zdrojový soubor yaml obsahující šablonu copilotu, která byla extrahovaná pomocí příkazu extract-template.

Volitelné parametry pro copilot create

--environment -env

Určuje cílovou službu Dataverse. Hodnota může být identifikátor GUID nebo absolutní adresa URL https. Pokud nezadáte, použije se aktivní organizace vybraná pro aktuální profil ověřování.

pac copilot delete

Odstraňte vlastní Copilot.

Požadované parametry pro copilot delete

--bot -id

ID nebo název schématu Copilot (jedinečný název nalezený v podrobnostech robota nebo názvu souboru v Průzkumníku řešení).

Volitelné parametry pro copilot delete

--confirm -y

Požadováno k potvrzení odstranění zkopírovaného pole.

Tento parametr nevyžaduje žádnou hodnotu. Je to přepínač.

--environment -env

Určuje cílovou službu Dataverse. Hodnota může být identifikátor GUID nebo absolutní adresa URL https. Pokud nezadáte, použije se aktivní organizace vybraná pro aktuální profil ověřování.

pac copilot extract-template

Extrahuje soubor šablony z existujícího kopírovaného objektu v prostředí.

Example

Tento příkaz extrahuje soubor šablony z existujícího kopírovaného objektu v prostředí.

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

Příkaz vrátí výstup podobný následujícímu příkazu pro copilot pomocí anglického a německého jazyka:

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

Požadované parametry pro copilot extract-template

--bot -id

ID nebo název schématu Copilot (jedinečný název nalezený v podrobnostech robota nebo názvu souboru v Průzkumníku řešení).

--templateFileName

Umístění souboru yaml pro zápis šablony copilotu do.

Volitelné parametry pro copilot extract-template

--environment -env

Určuje cílovou službu Dataverse. Hodnota může být identifikátor GUID nebo absolutní adresa URL https. Pokud nezadáte, použije se aktivní organizace vybraná pro aktuální profil ověřování.

--overwrite -o

Povolte přepsání výstupního datového souboru, pokud již existuje.

Tento parametr nevyžaduje žádnou hodnotu. Je to přepínač.

--templateName

Název šablony nebo kickStartTemplate, pokud není zadaný název.

--templateVersion

Verze šablony ve formátu X.X.X nebo 1.0.0, pokud není zadána verze.

pac copilot extract-translation

Extrahuje soubor obsahující lokalizovaný obsah pro jednoho nebo více robotů.

Example

Tento příkaz extrahuje soubor obsahující lokalizovaný obsah pro jeden nebo více zkopírovaných objektů.

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

Příkaz vrátí výstup podobný následujícímu:

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

Volitelné parametry pro copilot extract-translation

--all -a

Zapište lokalizační soubory pro všechny podporované jazyky. Ve výchozím nastavení se zapisuje jenom primární jazyk.

Tento parametr nevyžaduje žádnou hodnotu. Je to přepínač.

--bot -id

ID nebo název schématu Copilot (jedinečný název nalezený v podrobnostech robota nebo názvu souboru v Průzkumníku řešení).

--environment -env

Určuje cílovou službu Dataverse. Hodnota může být identifikátor GUID nebo absolutní adresa URL https. Pokud nezadáte, použije se aktivní organizace vybraná pro aktuální profil ověřování.

--format

Formát souboru, ve kterém se mají zapisovat lokalizované soubory, buď resx, nebo JSON. Výchozí hodnota je resx.

--outdir

Výstupní adresář, do který se má zapisovat.

--overwrite -o

Povolte přepsání výstupního datového souboru, pokud již existuje.

Tento parametr nevyžaduje žádnou hodnotu. Je to přepínač.

--sourcedir -src

Zdrojový adresář řešení Po zadání bude připojené prostředí při hledání robotů ignorovat a místo toho hledat obsah ve složce řešení.

pac copilot init

Vytvořte nový pracovní prostor agenta Copilot Studio ze šablony.

pac copilot initVygeneruje nový pracovní prostor agenta Copilot Studio ze šablony. Běží v jednom ze dvou režimů a přítomnost --environment rozhodnutí, který režim se má použít:

• Místní generování – ne --environment. Zapíše soubory šablony do adresáře projektu a zastaví. Příkaz nevytvoří nic v Dataverse a nevyžaduje přihlášení. Tento režim použijte, pokud chcete vytvořit místně a připojit se k prostředí později.
• Bootstrap – --environment dodáno. Vygeneruje soubory, zabalí je do řešení, naimportuje toto řešení do prostředí a připojí pracovní prostor k nově vytvořenému agentovi. Tento režim představuje jednu krokovou cestu od ničeho od živého agenta připraveného k synchronizaci a vyžaduje ověřený profil.

Příklady

Místní generování pracovního prostoru:

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

Generování uživatelského rozhraní a spuštění živého agenta v prostředí v jednom kroku:

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

Generování uživatelského rozhraní příkazového řádku (CliCopilot) agenta do konkrétní složky:

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

Požadované parametry pro copilot init

--name -n

Zobrazovaný název agenta

--publisher-prefix -pp

Publisher předpony vlastního nastavení pro řešení.

Volitelné parametry pro copilot init

--authoring-mode -am

Obrazec pro vytváření agentů, který se má vygenerovat (výchozí hodnota: Classic). K vygenerování agenta CliCopilot vytvořeného rozhraním příkazového řádku použijte cli-copilot.

--environment -env

Určuje cílovou službu Dataverse. Hodnota může být identifikátor GUID nebo absolutní adresa URL https. Pokud nezadáte, použije se aktivní organizace vybraná pro aktuální profil ověřování.

--instructions -ins

Pokyny k systému agenta.

--project-dir -pd

Cílový adresář pro pracovní prostor agenta. Výchozí hodnota je aktuální adresář.

--schema-name -sn

Úplný název schématu agenta Přepíše výchozí odvození ({publisher-prefix}_{sanitized-name}). Používá se as-is beze změny.

--template -t

Název profilu šablony (výchozí, minimální). Výchozí hodnota je výchozí.

Remarks

• Adresář projektu musí být prázdný. init nevygeneruje generování nad existujícími soubory, takže přejděte --project-dir na novou nebo prázdnou složku.
• Odvození názvu schématu Při vynechání --schema-namese název schématu agenta sestaví jako {publisher-prefix}_{sanitized-name}. Předat --schema-name ji explicitně; hodnota se používá as-is.
• Bootstrap funguje pro oba režimy vytváření. init --environment bootstraps živého agenta v jednom kroku pro výchozí klasický režim a pro --authoring-mode cli-copilot. Jako alternativu pro agenta CliCopilot můžete místně (ne--environment) vygenerovat generování uživatelského rozhraní a pak ho spustit pac solution importpac copilot pack a nasadit ho sami.
• Bootstrap vytvoří objekty na straně serveru. V režimu init bootstrap importuje řešení a vytvoří agenta v cílovém prostředí. Pokud už agent se stejným názvem schématu existuje, init zastaví vás a nasměří vás, pac copilot clone abyste se místo toho připojili k existujícímu agentu.
• Úplně nové prostředí může být pomalé přijmout první import. Čerstvě vytvořené prostředí může trvat minutu nebo dvě, než se zahřeje. Předčasné spuštění může selhat s chybou "Asynchronní operace jsou momentálně pro tuto organizaci zakázané". Chvíli počkejte a spusťte ho znovu.
• --template (default nebo minimal) se vztahuje pouze na klasický režim vytváření.

pac copilot list

Seznam zkopírovaných objektů v aktuálním nebo cílovém prostředí Dataverse

Example

Tento příkaz zobrazí seznam všech zkopírovaných objektů v aktuálním nebo cílovém prostředí Dataverse.

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

Příkaz vrátí výstup podobný následujícímu:

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

Volitelné parametry pro copilot list

--environment -env

Určuje cílovou službu Dataverse. Hodnota může být identifikátor GUID nebo absolutní adresa URL https. Pokud nezadáte, použije se aktivní organizace vybraná pro aktuální profil ověřování.

pac copilot mcp

Informace o místním serveru MCP (Model Context Protocol).

Example

pac copilot mcp --run

Volitelné parametry pro copilot mcp

--run -r

Spusťte místní server MCP (Model Context Protocol).

Tento parametr nevyžaduje žádnou hodnotu. Je to přepínač.

Remarks

Zjistěte, jak používat Rozhraní příkazového řádku Power Platform s integrovaným serverem MCP.

pac copilot merge-translation

Sloučit soubory obsahující lokalizovaný obsah pro jednoho nebo více robotů

Example

Tento příkaz sloučí soubory obsahující lokalizovaný obsah pro jeden nebo více zkopírovaných objektů.

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

Příkaz vrátí výstup podobný následujícímu příkazu při aktualizaci německého jazyka:

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.

Informace o správě chyb z příkazu merge-translation

Volitelné parametry pro copilot merge-translation

--environment -env

Určuje cílovou službu Dataverse. Hodnota může být identifikátor GUID nebo absolutní adresa URL https. Pokud nezadáte, použije se aktivní organizace vybraná pro aktuální profil ověřování.

--file -f

Seznam souborů, které obsahují překlady Podporují se vzory globů.

--solution -s

Název řešení

--sourcedir -src

Zdrojový adresář řešení Po zadání bude připojené prostředí při hledání robotů ignorovat a místo toho hledat obsah ve složce řešení.

--verbose

Výstup dalších diagnostických informací během importu a exportu dat

Tento parametr nevyžaduje žádnou hodnotu. Je to přepínač.

--whatif

Nespustí příkaz, ale vypíše podrobnosti o tom, co by se stalo.

Tento parametr nevyžaduje žádnou hodnotu. Je to přepínač.

Chyby při slučování překladu

Na základě výše uvedeného příkladu platí, že pokud v souboru použitém k aktualizaci copilotu existuje jedna chyba, výstup vypadá takto:

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.

Příznak --verbose přidá podrobnosti o chybě:

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

Modely AI Builderu v aktuálním prostředí

Example

Tento příkaz zobrazí seznam všech modelů AI Builderu.

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

Příkaz vrátí výstup podobný následujícímu:

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

Volitelné parametry pro copilot model list

--environment -env

Určuje cílovou službu Dataverse. Hodnota může být identifikátor GUID nebo absolutní adresa URL https. Pokud nezadáte, použije se aktivní organizace vybraná pro aktuální profil ověřování.

pac copilot model predict

Odešle text nebo výzvu k modelu AI.

Volitelné parametry pro copilot model predict

--environment -env

Určuje cílovou službu Dataverse. Hodnota může být identifikátor GUID nebo absolutní adresa URL https. Pokud nezadáte, použije se aktivní organizace vybraná pro aktuální profil ověřování.

--model-id -id

ID modelu AI Builderu

--model-name -n

Úplný nebo částečný název modelu AI

--prompt -p

Výzva k odeslání do modelu AI

--text -t

Text pro odeslání do modelu AI

pac copilot model prepare-fetch

Vezme soubor FetchXML z velkého jazykového modelu AI (LLM) a připraví ho na spuštění v aktuálním prostředí.

Požadované parametry pro copilot model prepare-fetch

--inputFile -i

Vstupní soubor FetchXML, který obvykle pochází z AI LLM.

--outputFile -o

Výstupní soubor FetchXML, který je připravený ke spuštění v aktuálním prostředí.

Volitelné parametry pro copilot model prepare-fetch

--environment -env

Určuje cílovou službu Dataverse. Hodnota může být identifikátor GUID nebo absolutní adresa URL https. Pokud nezadáte, použije se aktivní organizace vybraná pro aktuální profil ověřování.

pac copilot pack

Zabalte pracovní prostor agenta Copilot Studio do souboru ZIP řešení.

pac copilot pack zabalí pracovní prostor agenta do řešení .zip Dataverse, pomocí kterého můžete nasadit pac solution import. Jedná se o samostatnou formu kroku balení, který pac copilot init --environment běží za vás, takže můžete nasaditelné řešení vytvořit jako samostatný krok – například v kanálu buildu. Funguje pro pracovní prostory agenta klasického i cli-authored (CliCopilot).

Example

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

Požadované parametry pro copilot pack

--publisher-prefix -pp

Publisher předpony vlastního nastavení pro řešení.

Volitelné parametry pro copilot pack

--output-path -op

Výstupní cesta pro soubor ZIP řešení Výchozí hodnota je aktuální adresář.

--project-dir -pd

Adresář pracovního prostoru agenta, který se má zabalit. Výchozí hodnota je aktuální adresář.

--solution-name -sn

Jedinečný název řešení Pokud tento parametr vynecháte, odvozený z názvu schématu agenta.

Remarks

• Je to místní operace. Balíček načte pracovní prostor a zapíše řešení .zip. Nepotřebuje žádné ověřování a žádné prostředí, takže je bezpečné spustit v kanálu buildu.
• Předpona vydavatele musí být platná. --publisher-prefix před zápisem čehokoli musí být předpona vlastního nastavení ve správném formátu nebo sada se zastaví.
• Název a výstup řešení Pokud vynecháte --solution-name, jedinečný název řešení se odvozuje od názvu schématu agenta. Je .zip zapsán do aktuálního adresáře, pokud nenastavíte --output-path.
• Balíček se nenasadí. Vytvoří řešení, ale neimportuje ho. pac solution import Pokud chcete pro něj nasadit pracovní prostor připojený k synchronizaci, pac copilot clone postupujte podle něj.

pac copilot publish

Publikování vlastního copilotu

Požadované parametry pro copilot publish

--bot -id

ID nebo název schématu Copilot (jedinečný název nalezený v podrobnostech robota nebo názvu souboru v Průzkumníku řešení).

Volitelné parametry pro copilot publish

--environment -env

Určuje cílovou službu Dataverse. Hodnota může být identifikátor GUID nebo absolutní adresa URL https. Pokud nezadáte, použije se aktivní organizace vybraná pro aktuální profil ověřování.

pac copilot pull

Vyžádat vzdálené změny z Copilot Studio a sloučit s místním pracovním prostorem

Příkaz pac copilot pull načte aktuální stav serveru agenta a sloučí ho do místního pracovního prostoru pomocí trojcestného sloučení. Tento proces zajistí, že úpravy na straně serveru a nedotčené místní soubory zůstanou nedotčené. Před zahájením úprav ho spusťte a spusťte ho znovu, než změny nasdílíte.

Example

Spusťte příkaz ze složky pracovního prostoru:

pac copilot pull

Nebo ho nasměrujte na jiný pracovní prostor na disku:

pac copilot pull --project-dir contoso-support

Volitelné parametry pro copilot pull

--project-dir -pd

Cesta k adresáři projektu Výchozím nastavením je aktuální pracovní adresář.

Remarks

• Spusťte ho v pracovním prostoru synchronizace. Příkaz pull funguje pouze ve složce vytvořené pomocí pac copilot clone nebo pac copilot init. Načte cílové prostředí a agenta z metadat synchronizace pracovního prostoru, a proto neexistuje žádný --environment argument. Pokud ji spustíte kdekoli jinde, selže s chybou "Pracovní prostor se nenašel".
• Zapisuje se do místních souborů. Pull sloučí vzdálené změny do pracovního prostoru a stáhne znalostní soubory. Před stažením potvrďte nebo zálohujte místní práci, o kterou vám záleží.
• Nejprve se přihlaste pomocí pac auth create.

pac copilot push

Nasdílení změn místního pracovního prostoru do Copilot Studio

pac copilot push odešle změny v místním pracovním prostoru zpět do agenta v Dataverse. Porovná vaše soubory se stavem posledního známého serveru, nahraje jenom to, co se změnilo – včetně souborů znalostí, cloudových toků a odkazů na připojení – a hlásí, co se odeslalo.

Example

Spusťte ho ze složky pracovního prostoru:

pac copilot push

Nebo ho nasměrujte na jiný pracovní prostor na disku:

pac copilot push --project-dir contoso-support

Volitelné parametry pro copilot push

--project-dir -pd

Cesta k adresáři projektu Výchozím nastavením je aktuální pracovní adresář.

Remarks

• Spusťte ho v pracovním prostoru synchronizace. Podobně jako pull, push funguje pouze ve složce vytvořené pomocí pac copilot clone nebo pac copilot init. Načte cílové prostředí z metadat synchronizace pracovního prostoru. Neexistuje žádný --environment argument.
• Nejprve stáhněte, pokud dojde ke konfliktu. Pokud se stejná položka místně i na serveru změnila, nabízená oznámení se zastaví a před dalším pokusem vás požádá o spuštění pac copilot pull . Díky tomuto procesu se bezobslužně přepíše změna na straně serveru, kterou jste neviděli.
• Žádné místní změny nejsou no-op. Pokud nasdílení změn nenajde nic k odeslání, oznámí to a ukončí se bez zásahu do prostředí.
• Úspěšné nasdílení změn ztlumí živého agenta v cílovém prostředí.
• Nejprve se přihlaste pomocí pac auth create.

pac copilot quarantine

Karanténní status kopilota.

Požadované parametry pro copilot quarantine

--bot-id -id

ID kopilota pro karanténu/odkaranténu.

Volitelné parametry pro copilot quarantine

--environment -env

Prostředí (ID, ID organizace, adresa URL, jedinečný název nebo částečný název).

--status -s

Hodnota karanténního stavu. true = karanténa, false = nekaranténa. Výchozí hodnota je true.

Tento parametr nevyžaduje žádnou hodnotu. Je to přepínač.

pac copilot status

Dotazování stavu nasazení zadaného kopírovaného objektu v aktuálním nebo cílovém prostředí Dataverse

Example

Tento příkaz se dotazuje stavu nasazení zadaného kopírovaného objektu v aktuálním nebo cílovém prostředí Dataverse.

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

Příkaz vrátí výstup podobný následujícímu:

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

Požadované parametry pro copilot status

--bot-id -id

ID copilotu (Chatbot).

Volitelné parametry pro copilot status

--environment -env

Určuje cílovou službu Dataverse. Hodnota může být identifikátor GUID nebo absolutní adresa URL https. Pokud nezadáte, použije se aktivní organizace vybraná pro aktuální profil ověřování.

Ověřování a prostředí pro příkazy synchronizace

Všechny clonepříkazy , pulla init --environmentpushpříkazy komunikují s prostředím Dataverse, takže potřebují ověřovací profil. Nejprve se přihlaste pomocí pac auth create.

• clonea pullpush vyžaduje aktivní profil. pac copilot initPotřebuje jenom jeden, init když projdete --environment– bez něj místně vygeneruje soubory a nepotřebuje žádné přihlášení.
• pull a push přečtěte si cílové prostředí z metadat synchronizace pracovního prostoru, takže nepřebírají --environment argument. clone a init udělej.
• pac copilot pack je čistě místní. Čte a zapisuje jenom soubory, takže nepotřebuje žádné ověřování a žádné prostředí.

pull a push pracovat pouze v pracovním prostoru vytvořeném uživatelem clone nebo init. Metadata synchronizace zapsaná při vytvoření pracovního prostoru vám sdělí, se kterým agentem a prostředím se mají komunikovat, takže jejich spuštění kdekoli jinde selže rychle s chybou Pracovní prostor nebyl nalezen.

Viz také

Microsoft Power Platform skupiny příkazů rozhraní příkazového řádku
přehled rozhraní příkazového řádku Microsoft Power Platform