pac copilot

Eszközök és segédprogramok a copilot-kezeléshez.

A init, clone, , pushpullés pack parancsokkal egy Copilot Studio ügynököt tárolhat fájlkészletként a lemezen, szerkesztheti helyileg, és szinkronizálhatja egy Dataverse-környezettel.

Egy tipikus hurok a következőképpen néz ki:

1. Munkaterület indítása. Új ügynököt pac copilot inithozhat létre, vagy letölthet egy meglévőt a következővel pac copilot clone: . Bármelyik módon is kap egy helyi munkaterületet, amely a szinkronizálási metaadatokat hordozza, a többi parancs függ.
2. Lekérés a szerkesztés előtt. pac copilot pull távoli módosításokat hoz létre, és egyesíti őket a helyi fájlokban, így az aktuális kiszolgálóállapotból indul ki.
3. Nyomja le, ha elkészült. pac copilot push visszaküldi a helyi módosításokat. Ha időközben ugyanez az elem módosult a kiszolgálón, a leküldés leáll, és arra kéri, hogy először húzza le a elemet.
4. Csomag üzembe helyezéshez. pac copilot pack a munkaterületet egy olyan megoldássá .zip alakítja, amellyel pac solution importüzembe helyezhető.

Ha egyetlen lépésben szeretne a semmiből élő ügynököt létrehozni, pac copilot init --environment állványzatokat, csomagokat, importálni és összekapcsolni a munkaterületet. Az egyes parancsok lehetővé teszik a hurok egyes részeinek önálló vezetését.

Commands

pac copilot clone

Klónozhat egy Copilot Studio ügynököt egy helyi munkaterület könyvtárába.

pac copilot cloneletölt egy meglévő Copilot Studio-ügynököt egy helyi munkaterület könyvtárába, valamint a szinkronizálási metaadatokat, amelyekre pac copilot pullpac copilot push támaszkodik. Az ügynök fájljai a megjelenítendő névről elnevezett almappába lesznek írva.

Example

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

Kötelező paraméterek a következőhöz: copilot clone

--bot -id

A Copilot azonosítója vagy sémaneve (a Robot részletei vagy a megoldáskezelőben található fájlnév).

Választható paraméterek a következőhöz: copilot clone

--component-collection -cc

Klónozni kívánt összetevőgyűjtemény-azonosító. Ismételje meg többször is.

--display-name -dn

Az ügynök megjelenítendő neve (a mappaelnevezéshez használatos).

--environment -env

A céladat-adatverset adja meg. Az érték lehet guid vagy abszolút https URL-cím. Ha nincs megadva, a rendszer az aktuális hitelesítési profilhoz kiválasztott aktív szervezetet használja.

--output-dir -od

Gyökérmappa a klónkimenethez. Az aktuális könyvtár alapértelmezett értéke.

Remarks

• --botelfogad egy Copilot azonosítót vagy sémanevet. Adja meg a Copilot azonosítót (GUID) vagy az ügynök sémanevét. A parancs felold egy sémanevet a célkörnyezettel szemben.
• A cél almappának üresnek kell lennie. A klónozás az ügynök (megtisztított) megjelenítendő neve --output-dirután elnevezett mappába ír. Ha ez a mappa már tartalmaz fájlokat, a klónozás leáll ahelyett, hogy felülírja őket. Másik mappanév kiválasztására használható --display-name .
• Összetevők gyűjteményeinek klónozása. Ha le szeretné állítani az összetevőgyűjteményeket az ügynök mellett, adjon át egy vagy több gyűjteményazonosítót pontosvesszővel --component-collectionelválasztva.
• A klónozáshoz hitelesített profil (pac auth create) szükséges, és az aktív profil szervezetéből vagy szervezetéből --environmentoldja fel a környezetet, amikor kihagyja.

pac copilot create

Létrehoz egy új copilotot egy meglévő sablonfájllal hivatkozásként.

Kötelező paraméterek a következőhöz: copilot create

--displayName

Az új copilot megjelenítendő neve

--schemaName

Az új copilot sémaneve (egyedi neve).

--solution -s

A megoldás neve.

--templateFileName

Forrás yaml-fájl, amely az extract-template paranccsal kinyert copilot-sablont tartalmazza.

Választható paraméterek a következőhöz: copilot create

--environment -env

A céladat-adatverset adja meg. Az érték lehet guid vagy abszolút https URL-cím. Ha nincs megadva, a rendszer az aktuális hitelesítési profilhoz kiválasztott aktív szervezetet használja.

pac copilot delete

Egyéni Copilot törlése.

Kötelező paraméterek a következőhöz: copilot delete

--bot -id

A Copilot azonosítója vagy sémaneve (a Robot részletei vagy a megoldáskezelőben található fájlnév).

Választható paraméterek a következőhöz: copilot delete

--confirm -y

A másodpilóta törlésének megerősítéséhez szükséges.

Ehhez a paraméterhez nincs szükség értékre. Ez egy kapcsoló.

--environment -env

A céladat-adatverset adja meg. Az érték lehet guid vagy abszolút https URL-cím. Ha nincs megadva, a rendszer az aktuális hitelesítési profilhoz kiválasztott aktív szervezetet használja.

pac copilot extract-template

Egy sablonfájlt nyer ki egy környezet meglévő copilotjából.

Example

Ez a parancs egy sablonfájlt nyer ki egy környezet meglévő copilotjából.

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

A parancs az alábbihoz hasonló kimenetet ad vissza egy angol és német nyelveket használó copilot esetében:

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

Kötelező paraméterek a következőhöz: copilot extract-template

--bot -id

A Copilot azonosítója vagy sémaneve (a Robot részletei vagy a megoldáskezelőben található fájlnév).

--templateFileName

A yaml-fájl helye a copilot-sablon írásához.

Választható paraméterek a következőhöz: copilot extract-template

--environment -env

A céladat-adatverset adja meg. Az érték lehet guid vagy abszolút https URL-cím. Ha nincs megadva, a rendszer az aktuális hitelesítési profilhoz kiválasztott aktív szervezetet használja.

--overwrite -o

Ha már létezik, engedélyezze a kimeneti adatfájl felülírását.

Ehhez a paraméterhez nincs szükség értékre. Ez egy kapcsoló.

--templateName

Sablonnév vagy "kickStartTemplate", ha nincs megadva név.

--templateVersion

A sablon verziója X.X.X formátumban vagy 1.0.0, ha nincs megadva verzió.

pac copilot extract-translation

Egy vagy több robot honosított tartalmát tartalmazó fájlt nyer ki.

Example

Ez a parancs kinyer egy fájlt, amely egy vagy több társpilóta honosított tartalmát tartalmazza.

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

A parancs az alábbihoz hasonló kimenetet ad vissza:

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

Választható paraméterek a következőhöz: copilot extract-translation

--all -a

Honosítási fájlok írása az összes támogatott nyelvhez. Alapértelmezés szerint csak az elsődleges nyelv van megírva.

Ehhez a paraméterhez nincs szükség értékre. Ez egy kapcsoló.

--bot -id

A Copilot azonosítója vagy sémaneve (a Robot részletei vagy a megoldáskezelőben található fájlnév).

--environment -env

A céladat-adatverset adja meg. Az érték lehet guid vagy abszolút https URL-cím. Ha nincs megadva, a rendszer az aktuális hitelesítési profilhoz kiválasztott aktív szervezetet használja.

--format

Az a fájlformátum, amelyben honosított fájlokat kell írni, "resx" vagy "json". Az alapértelmezett érték a "resx".

--outdir

A kimeneti könyvtár, amelybe írni szeretne.

--overwrite -o

Ha már létezik, engedélyezze a kimeneti adatfájl felülírását.

Ehhez a paraméterhez nincs szükség értékre. Ez egy kapcsoló.

--sourcedir -src

Forrásmegoldás könyvtára. Ha meg van adva, figyelmen kívül hagyja a csatlakoztatott környezetet, amikor robotokat keres, és ehelyett tartalmat keres a megoldásmappában.

pac copilot init

Hozzon létre egy új Copilot Studio ügynök-munkaterületet egy sablonból.

pac copilot initegy új Copilot Studio-ügynök-munkaterületet hoz létre egy sablonból. Két mód egyikében fut, és a jelenlét határozza --environment meg, hogy melyik módot használja:

• Helyi állványzat – nem --environment. A sablonfájlokat beírja a projektkönyvtárba, és leáll. A parancs nem hoz létre semmit a Dataverse-ben, és nem igényel bejelentkezést. Ezt a módot akkor használja, ha helyileg szeretne létrehozni, és később csatlakozni szeretne egy környezethez.
• Bootstrap – --environment megadva. Létrehozza a fájlokat, egy megoldásba csomagolja őket, importálja a megoldást a környezetbe, és csatlakoztatja a munkaterületet az újonnan létrehozott ügynökhöz. Ez a mód a semmiből egy élő, szinkronizálásra kész ügynökhöz vezető egylépéses útvonal, amelyhez hitelesített profil szükséges.

Examples

Munkaterület helyi létrehozása:

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

Hozzon létre és bootstrapáljon egy élő ügynököt egy környezetben egyetlen lépésben:

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

Egy CLI-szerkesztett (CliCopilot) ügynököt egy adott mappába állíthat be:

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

Kötelező paraméterek a következőhöz: copilot init

--name -n

Ügynök megjelenítendő neve.

--publisher-prefix -pp

Publisher megoldás testreszabási előtagja.

Választható paraméterek a következőhöz: copilot init

--authoring-mode -am

Az ügynök szerkesztőalakzata állványzatra (alapértelmezett: klasszikus). A cli-copilot használatával egy CLI-szerkesztett CliCopilot-ügynököt hozhat létre.

--environment -env

A céladat-adatverset adja meg. Az érték lehet guid vagy abszolút https URL-cím. Ha nincs megadva, a rendszer az aktuális hitelesítési profilhoz kiválasztott aktív szervezetet használja.

--instructions -ins

Ügynökrendszer-utasítások.

--project-dir -pd

Az ügynök-munkaterület célkönyvtára. Az aktuális könyvtár alapértelmezett értéke.

--schema-name -sn

Teljes ügynökséma neve. Felülírja az alapértelmezett származtatást ({publisher-prefix}_{sanitized-name}). Módosítás nélkül as-is használva.

--template -t

Sablonprofil neve (alapértelmezett, minimális). Alapértelmezett érték: "default".

Remarks

• A projektkönyvtárnak üresnek kell lennie. init nem a meglévő fájlokra mutat, ezért mutasson --project-dir egy új vagy üres mappára.
• Sémanév származtatása. Ha kihagyja --schema-name, az ügynökséma neve a következőképpen lesz létrehozva {publisher-prefix}_{sanitized-name}. Adja meg --schema-name explicit módon a beállítását; az érték as-islesz használva.
• A Bootstrap mindkét szerzői módhoz használható. init --environment bootstraps egy élő ügynök egy lépésben az alapértelmezett klasszikus módban és a --authoring-mode cli-copilot. A CliCopilot-ügynök alternatívaként helyileg is létrehozható (nem --environment), majd futtathatja pac copilot pack , majd pac solution import saját üzembe helyezheti.
• A Bootstrap kiszolgálóoldali objektumokat hoz létre. Bootstrap módban importáljon egy megoldást, init és hozza létre az ügynököt a célkörnyezetben. Ha már létezik ugyanazzal a sémanévvel rendelkező ügynök, leállítja és arra kéri, init hogy pac copilot clone csatlakozzon a meglévő ügynökhöz.
• Az új környezetek lassan fogadják el az első importálást. A frissen létrehozott környezetek bemelegedéséhez egy-két perc is eltelhet. A korai rendszerindítási művelet meghiúsulhat "Az aszinkron műveletek jelenleg le vannak tiltva ehhez a szervezethez". Várjon egy kicsit, és futtassa újra.
• --template (default vagy minimal) csak a klasszikus szerzői módra vonatkozik.

pac copilot list

Az aktuális vagy a cél Dataverse-környezetben lévő copilotok listája.

Example

Ez a parancs felsorolja az aktuális vagy a cél Dataverse-környezetben lévő összes másodpilótát.

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

A parancs az alábbihoz hasonló kimenetet ad vissza:

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

Választható paraméterek a következőhöz: copilot list

--environment -env

A céladat-adatverset adja meg. Az érték lehet guid vagy abszolút https URL-cím. Ha nincs megadva, a rendszer az aktuális hitelesítési profilhoz kiválasztott aktív szervezetet használja.

pac copilot mcp

Információk a helyi MCP (Model Context Protocol) kiszolgálóról.

Example

pac copilot mcp --run

Választható paraméterek a következőhöz: copilot mcp

--run -r

Futtassa a helyi MCP (Model Context Protocol) kiszolgálót.

Ehhez a paraméterhez nincs szükség értékre. Ez egy kapcsoló.

Remarks

Megtudhatja, hogyan használhatja a Power Platform parancssori felületét beépített MCP-kiszolgálóval

pac copilot merge-translation

Egy vagy több robot honosított tartalmát tartalmazó fájlok egyesítése.

Example

Ez a parancs egy vagy több társpilóta honosított tartalmát tartalmazó fájlokat egyesít.

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

A parancs a következő kimenetet adja vissza a német nyelv frissítésekor:

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.

Ismerje meg, hogyan kezelheti a egyesítési fordítás parancs hibáit

Választható paraméterek a következőhöz: copilot merge-translation

--environment -env

A céladat-adatverset adja meg. Az érték lehet guid vagy abszolút https URL-cím. Ha nincs megadva, a rendszer az aktuális hitelesítési profilhoz kiválasztott aktív szervezetet használja.

--file -f

A fordításokat tartalmazó fájlok listája. A Glob-minták támogatottak.

--solution -s

A megoldás neve.

--sourcedir -src

Forrásmegoldás könyvtára. Ha meg van adva, figyelmen kívül hagyja a csatlakoztatott környezetet, amikor robotokat keres, és ehelyett tartalmat keres a megoldásmappában.

--verbose

További diagnosztikai információk kimenete az adatok importálása/exportálása során

Ehhez a paraméterhez nincs szükség értékre. Ez egy kapcsoló.

--whatif

Nem hajtja végre a parancsot, de a kimenetben a történtek részletei lesznek.

Ehhez a paraméterhez nincs szükség értékre. Ez egy kapcsoló.

egyesítési fordítási hibák

A fenti példa alapján, ha a copilot frissítéséhez használt fájlban van egy hiba, a kimenet a következőképpen néz ki:

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.

A --verbose jelző a hiba részleteit adja hozzá:

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-modellek az aktuális környezetben.

Example

Ez a parancs felsorolja az összes AI Builder-modellt.

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

A parancs az alábbihoz hasonló kimenetet ad vissza:

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

Választható paraméterek a következőhöz: copilot model list

--environment -env

A céladat-adatverset adja meg. Az érték lehet guid vagy abszolút https URL-cím. Ha nincs megadva, a rendszer az aktuális hitelesítési profilhoz kiválasztott aktív szervezetet használja.

pac copilot model predict

Szöveg vagy kérés küldése az AI-modellnek

Választható paraméterek a következőhöz: copilot model predict

--environment -env

A céladat-adatverset adja meg. Az érték lehet guid vagy abszolút https URL-cím. Ha nincs megadva, a rendszer az aktuális hitelesítési profilhoz kiválasztott aktív szervezetet használja.

--model-id -id

AI Builder-modell azonosítója

--model-name -n

Az AI-modell teljes vagy részleges neve

--prompt -p

Az AI-modellnek való küldés kérése

--text -t

Az AI-modellbe küldendő szöveg

pac copilot model prepare-fetch

Lekéri a FetchXML-fájlt az AI Nagy nyelvi modellből (LLM), és előkészíti a végrehajtásra az aktuális környezetben.

Kötelező paraméterek a következőhöz: copilot model prepare-fetch

--inputFile -i

Bemeneti FetchXML-fájl, amely általában az AI LLM-ből származik.

--outputFile -o

Kimeneti FetchXML-fájl, amely készen áll a végrehajtásra az aktuális környezetben.

Választható paraméterek a következőhöz: copilot model prepare-fetch

--environment -env

A céladat-adatverset adja meg. Az érték lehet guid vagy abszolút https URL-cím. Ha nincs megadva, a rendszer az aktuális hitelesítési profilhoz kiválasztott aktív szervezetet használja.

pac copilot pack

Csomagoljon be egy Copilot Studio ügynök-munkaterületet egy megoldás zip-fájljába.

pac copilot pack az ügynök-munkaterületet egy Dataverse-megoldásba .zip csomagolja, amellyel pac solution importüzembe helyezhető. Ez a csomagolási lépés önálló formája, amely pac copilot init --environment az Ön számára fut, így az üzembe helyezhető megoldást külön lépésként hozhatja létre – például egy buildelési folyamatban. A klasszikus és a CLI-szerkesztett (CliCopilot) ügynök-munkaterületeken is működik.

Example

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

Kötelező paraméterek a következőhöz: copilot pack

--publisher-prefix -pp

Publisher megoldás testreszabási előtagja.

Választható paraméterek a következőhöz: copilot pack

--output-path -op

A megoldás zip-fájljának kimeneti elérési útja. Az aktuális könyvtár alapértelmezett értéke.

--project-dir -pd

Ügynök-munkaterület könyvtára a csomaghoz. Az aktuális könyvtár alapértelmezett értéke.

--solution-name -sn

A megoldás egyedi neve. Ha nincs megadva, az ügynökséma nevéből származik.

Remarks

• Ez egy helyi művelet. A Pack beolvassa a munkaterületet, és egy megoldást .zipír. Nincs szüksége hitelesítésre és környezetre, így biztonságosan futtatható egy buildelési folyamatban.
• A közzétevő előtagjának érvényesnek kell lennie. --publisher-prefix megfelelően formázott testreszabási előtagnak kell lennie, vagy a csomag leáll, mielőtt bármit írna.
• Megoldás neve és kimenete. Ha kihagyja --solution-name, a megoldás egyedi neve az ügynökséma nevéből származik. A .zip rendszer csak akkor írja az aktuális könyvtárba, ha be nem állítja --output-path.
• A csomag nem lesz üzembe helyezve. Létrehozza a megoldást, de nem importálja. Kövesse az pac solution import ügynök üzembe helyezéséhez, majd pac copilot clone ha szinkronizált munkaterületet szeretne hozzá.

pac copilot publish

Egyéni Copilot közzététele

Kötelező paraméterek a következőhöz: copilot publish

--bot -id

A Copilot azonosítója vagy sémaneve (a Robot részletei vagy a megoldáskezelőben található fájlnév).

Választható paraméterek a következőhöz: copilot publish

--environment -env

A céladat-adatverset adja meg. Az érték lehet guid vagy abszolút https URL-cím. Ha nincs megadva, a rendszer az aktuális hitelesítési profilhoz kiválasztott aktív szervezetet használja.

pac copilot pull

Távoli módosítások lekérése Copilot Studio és egyesítés a helyi munkaterülettel.

A pac copilot pull parancs lekéri az ügynök aktuális kiszolgálói állapotát, és egy háromirányú egyesítéssel egyesíti azt a helyi munkaterületen. Ez a folyamat biztosítja, hogy a kiszolgálóoldali módosítások és az érintetlen helyi fájlok is érintetlenek maradjanak. A szerkesztés megkezdése előtt futtassa, majd futtassa újra, mielőtt leküldené a módosításokat.

Example

Futtassa a parancsot a munkaterület mappájából:

pac copilot pull

Vagy mutasson egy munkaterületre máshol a lemezen:

pac copilot pull --project-dir contoso-support

Választható paraméterek a következőhöz: copilot pull

--project-dir -pd

A projektkönyvtár elérési útja. Alapértelmezés szerint az aktuális munkakönyvtárat használja.

Remarks

• Futtassa egy szinkronizálási munkaterületen. A pull parancs csak az általa pac copilot initvagy által pac copilot clone létrehozott mappában működik. Beolvassa a célkörnyezetet és az ügynököt a munkaterület szinkronizálási metaadataiból, ezért nincs --environment argumentum. Ha máshol futtatja, a "munkaterület nem található" hibaüzenettel meghiúsul.
• A helyi fájlokba ír. A pull a távoli módosításokat egyesíti a munkaterületen, és letölti a tudásfájlokat. A lekérés előtt véglegesítse vagy biztonsági másolatot készítsön a fontos helyi munkáról.
• Jelentkezzen be először a következővel pac auth create: .

pac copilot push

A helyi munkaterület módosításainak leküldése Copilot Studio.

pac copilot push visszaküldi a helyi munkaterület módosításait a Dataverse ügynökének. Összehasonlítja a fájlokat a legutóbbi ismert kiszolgálóállapottal, csak azt tölti fel, ami megváltozott – beleértve a tudásfájlokat, a felhőfolyamatokat és a kapcsolati hivatkozásokat –, és jelentést készít a leküldésről.

Example

Futtassa a munkaterület mappájában:

pac copilot push

Vagy mutasson egy munkaterületre máshol a lemezen:

pac copilot push --project-dir contoso-support

Választható paraméterek a következőhöz: copilot push

--project-dir -pd

A projektkönyvtár elérési útja. Alapértelmezés szerint az aktuális munkakönyvtárat használja.

Remarks

• Futtassa egy szinkronizálási munkaterületen. Például pullcsak push az általa pac copilot initvagy által létrehozott pac copilot clone mappában működik. Beolvassa a célkörnyezetet a munkaterület szinkronizálási metaadataiból. Nincs --environment argumentum.
• Ütközés esetén először húzza le a elemet. Ha ugyanaz az elem helyileg és a kiszolgálón is módosult, a leküldés leáll, és megkéri, hogy futtassa pac copilot pull , mielőtt újra próbálkozna. Ez a folyamat megakadályozza a nem látott kiszolgálóoldali módosítások csendes felülírását.
• A helyi módosítások nem no-op. Ha a leküldés nem talál elküldendő műveletet, a rendszer ezt jelenti, és a környezet érintése nélkül kilép.
• A sikeres leküldés az élő ügynököt mutálja a célkörnyezetben.
• Jelentkezzen be először a következővel pac auth create: .

pac copilot quarantine

A segédpilóta ügynök karanténállapota.

Kötelező paraméterek a következőhöz: copilot quarantine

--bot-id -id

A kooperatív pilóta azonosítója a karantén/karantén megszüntetéséhez.

Választható paraméterek a következőhöz: copilot quarantine

--environment -env

Környezet (azonosító, szervezeti azonosító, URL-cím, egyedi név vagy részleges név).

--status -s

Karantén státusz értéke. igaz = karantén, hamis = karantén nélküli állapot. Alapértelmezés szerint igaz.

Ehhez a paraméterhez nincs szükség értékre. Ez egy kapcsoló.

pac copilot status

Egy adott copilot üzembehelyezési állapotának lekérdezése az aktuális vagy a cél Dataverse-környezetben.

Example

Ez a parancs egy adott copilot üzembehelyezési állapotát kérdezi le az aktuális vagy a cél Dataverse-környezetben.

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

A parancs az alábbihoz hasonló kimenetet ad vissza:

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

Kötelező paraméterek a következőhöz: copilot status

--bot-id -id

Egy copilot (Chatbot) azonosítója.

Választható paraméterek a következőhöz: copilot status

--environment -env

A céladat-adatverset adja meg. Az érték lehet guid vagy abszolút https URL-cím. Ha nincs megadva, a rendszer az aktuális hitelesítési profilhoz kiválasztott aktív szervezetet használja.

A szinkronizálási parancsok hitelesítése és környezete

A clone, pull, pushés init --environment parancsok mind egy Dataverse-környezethez beszélnek, ezért szükségük van egy hitelesítési profilra. Jelentkezzen be először a következővel pac auth create: .

• clone, pullés push aktív profilt igényel. pac copilot init csak egyre van szüksége, amikor átadja --environment; nélküle az állványok helyileg rögzítik a fájlokat, init és nincs szükség bejelentkezésre.
• pull és push olvassa be a célkörnyezetet a munkaterület szinkronizálási metaadataiból, így nem vesznek fel argumentumot --environment . clone és init igen.
• pac copilot pack kizárólag helyi. Csak fájlokat olvas és ír, ezért nincs szüksége hitelesítésre és környezetre.

pullés push csak az általa initvagy által clone létrehozott munkaterületen belül kell dolgoznia. A munkaterület létrehozásakor írt szinkronizálási metaadatok jelzik, hogy melyik ügynökkel és környezettel kell beszélniük, ezért a máshol való futtatás "a munkaterület nem található" hibával gyorsan meghiúsul.

Lásd még

Microsoft Power Platform parancssori felület parancscsoportjai
Microsoft Power Platform parancssori felület áttekintése