pac copilot

Instrumente și utilitare pentru gestionarea copiilor.

Comenzile init, , clonepull, pushși pack vă permit să păstrați un agent Copilot Studio ca un set de fișiere pe disc, să-l editați local și să-l sincronizați cu un mediu Dataverse.

O buclă tipică arată astfel:

  1. Începeți un spațiu de lucru. Scaffold a brand-new agent with pac copilot init, or download an existing one with pac copilot clone. Oricum, obțineți un spațiu de lucru local care conține metadatele de sincronizare pe care depind celelalte comenzi.
  2. Trageți înainte de a edita. pac copilot pull aduce modificările la distanță în jos și le îmbină în fișierele locale, astfel încât să începeți de la starea curentă a serverului.
  3. Împingeți după ce ați terminat. pac copilot push trimite modificările locale înapoi. Dacă același element s-a modificat între timp pe server, împinge opririle și vă solicită să trageți mai întâi.
  4. Pachet pentru implementare. pac copilot pack transformă un spațiu de lucru într-o soluție .zip cu pac solution importcare puteți implementa .

Pentru a trece de la nimic la un agent live într-un singur pas, schele, pac copilot init --environment pachete, importuri și conectează spațiul de lucru pentru dvs. Comenzile individuale vă permit să conduceți fiecare parte a buclei pe cont propriu.

Comenzi

Command Descriere
pac copilot clone Clonați un agent Copilot Studio într-un director spațiu de lucru local.
pac copilot create Creează un copilot nou utilizând un fișier șablon existent ca referință.
pac copilot delete Ștergeți o Copilot particularizată.
pac copilot extract-template Extrage un fișier șablon dintr-un copilot existent într-un mediu.
pac copilot extract-translation Extrage fișierul care conține conținut localizat pentru unul sau mai mulți roboți.
pac copilot init Creați un spațiu de lucru nou Copilot Studio agent dintr-un șablon.
pac copilot list Lista de copilots din mediul Dataverse curent sau țintă.
pac copilot mcp Informații despre serverul MCP local (Model Context Protocol).
pac copilot merge-translation Îmbinați fișierele care conțin conținut localizat pentru unul sau mai mulți roboți.
pac copilot model list Modele AI Builder în mediul curent.
pac copilot model predict Trimite text sau solicitare către modelul AI
pac copilot model prepare-fetch Preia fișierul FetchXML din modelul de limbă mare ai (LLM) și îl pregătește pentru execuție în mediul curent.
pac copilot pack Împachetați un spațiu de lucru Copilot Studio agent într-un fișier zip soluție.
pac copilot publish Publicarea unui Copilot particularizat
pac copilot pull Extrageți modificările de la distanță din Copilot Studio și îmbinați cu spațiul de lucru local.
pac copilot push Împingeți modificările spațiului de lucru local în Copilot Studio.
pac copilot quarantine Starea de carantină a agentului copilot.
pac copilot status Sondaj starea de implementare a unui copilot specificat în mediul Dataverse curent sau țintă.

pac copilot clone

Clonați un agent Copilot Studio într-un director spațiu de lucru local.

pac copilot clonedescarcă un agent Copilot Studio existent într-un director local al spațiului de lucru, împreună cu metadatele de sincronizare pe care se bazează și pac copilot push pe care pac copilot pull se bazează. Fișierele agentului sunt scrise într-un subfolder numit după numele său afișat.

Exemplu

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

Parametri obligatorii pentru copilot clone

--bot -id

Numele de schemă sau ID Copilot (nume unic găsit în Detalii bot sau nume de fișier în Explorer).

Parametri opționali pentru copilot clone

--component-collection -cc

ID-ul colecției de componente de clonat. Repetați pentru mai multe.

--display-name -dn

Numele afișat al agentului (utilizat pentru denumirea folderelor).

--environment -env

Specifică dataverse țintă. Valoarea poate fi un URL GUID sau absolut https. Când nu este specificată, se va utiliza organizația activă selectată pentru profilul de autentificare curent.

--output-dir -od

Folder rădăcină pentru ieșire clonă. Implicit la directorul curent.

Observații

  • --botacceptă un ID Copilot sau un nume de schemă. Transmiteți numele schemei Copilot (un GUID) sau numele schemei agentului. Comanda rezolvă un nume de schemă în raport cu mediul țintă.
  • Subfolderul destinație trebuie să fie gol. Clona scrie într-un folder numit după numele afișat al agentului (sanitizat) sub --output-dir. Dacă acel folder conține deja fișiere, clona se oprește în loc să le suprascrie. Se utilizează --display-name pentru a alege un alt nume de folder.
  • Colecții de componente de clonare. Pentru a aduce colecțiile componente împreună cu agentul, treceți unul sau mai multe ID-uri de colecție cu --component-collection, separate prin punct și virgulă.
  • Clona necesită un profil autentificat (pac auth create) și rezolvă mediul din --environmentsau din organizația profilului activ atunci când îl omiteți.

pac copilot create

Creează un copilot nou utilizând un fișier șablon existent ca referință.

Parametri obligatorii pentru copilot create

--displayName

Numele afișat al noului copilot

--schemaName

Numele schemei (nume unic) al noului copilot.

--solution -s

Numele soluției.

--templateFileName

Fișierul yaml sursă care conține șablonul copilot care a fost extras utilizând comanda extragere-șablon.

Parametri opționali pentru copilot create

--environment -env

Specifică dataverse țintă. Valoarea poate fi un URL GUID sau absolut https. Când nu este specificată, se va utiliza organizația activă selectată pentru profilul de autentificare curent.

pac copilot delete

Ștergeți o Copilot particularizată.

Parametri obligatorii pentru copilot delete

--bot -id

Numele de schemă sau ID Copilot (nume unic găsit în Detalii bot sau nume de fișier în Explorer).

Parametri opționali pentru copilot delete

--confirm -y

Obligatoriu pentru a confirma ștergerea copilotului.

Acest parametru nu necesită nicio valoare. Este un comutator.

--environment -env

Specifică dataverse țintă. Valoarea poate fi un URL GUID sau absolut https. Când nu este specificată, se va utiliza organizația activă selectată pentru profilul de autentificare curent.

pac copilot extract-template

Extrage un fișier șablon dintr-un copilot existent într-un mediu.

Exemplu

Această comandă extrage un fișier șablon dintr-un copilot existent într-un mediu.

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

Comanda returnează ieșirea ca următoarea pentru un copilot utilizând limbile engleză și germană:

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

Parametri obligatorii pentru copilot extract-template

--bot -id

Numele de schemă sau ID Copilot (nume unic găsit în Detalii bot sau nume de fișier în Explorer).

--templateFileName

Locația fișierului yaml în care să scrie șablonul copilot.

Parametri opționali pentru copilot extract-template

--environment -env

Specifică dataverse țintă. Valoarea poate fi un URL GUID sau absolut https. Când nu este specificată, se va utiliza organizația activă selectată pentru profilul de autentificare curent.

--overwrite -o

Se permite suprascrierea fișierului de date de ieșire dacă există deja.

Acest parametru nu necesită nicio valoare. Este un comutator.

--templateName

Numele șablonului sau 'kickStartTemplate' dacă numele nu este specificat.

--templateVersion

Versiunea șablonului în format X.X.X sau 1.0.0 dacă nu este specificată versiunea.

pac copilot extract-translation

Extrage fișierul care conține conținut localizat pentru unul sau mai mulți roboți.

Exemplu

Această comandă extrage un fișier care conține conținut localizat pentru una sau mai multe copii.

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

Comanda returnează ieșire ca următoarea:

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

Parametri opționali pentru copilot extract-translation

--all -a

Scrieți fișiere de localizare pentru toate limbile acceptate. În mod implicit, doar limba principală este scrisă.

Acest parametru nu necesită nicio valoare. Este un comutator.

--bot -id

Numele de schemă sau ID Copilot (nume unic găsit în Detalii bot sau nume de fișier în Explorer).

--environment -env

Specifică dataverse țintă. Valoarea poate fi un URL GUID sau absolut https. Când nu este specificată, se va utiliza organizația activă selectată pentru profilul de autentificare curent.

--format

Formatul de fișier în care să scrieți fișiere localizate, fie "resx", fie "json". Valoarea implicită este "resx".

--outdir

Directorul de ieșire în care să scrieți.

--overwrite -o

Se permite suprascrierea fișierului de date de ieșire dacă există deja.

Acest parametru nu necesită nicio valoare. Este un comutator.

--sourcedir -src

Director de soluții sursă. Atunci când se specifică, va ignora mediul conectat atunci când căutați roboți și, în schimb, va căuta conținut în folderul soluție.

pac copilot init

Creați un spațiu de lucru nou Copilot Studio agent dintr-un șablon.

pac copilot initscaffolds a new Copilot Studio agent workspace from a template. Acesta rulează într-unul dintre cele două moduri, iar prezența --environment decide ce mod să utilizați:

  • Scaffold local — fără --environment. Scrie fișierele șablon în directorul de proiect și se oprește. Comanda nu creează nimic în Dataverse și nu necesită conectare. Utilizați acest mod atunci când doriți să creați local și să vă conectați la un mediu mai târziu.
  • Bootstrap — --environment furnizat. Scaffolds fișiere, pachete-le într-o soluție, importă acea soluție în mediu, și conectează spațiul de lucru la agentul nou creat. Acest mod este calea cu un singur pas de la nimic la un agent activ, gata de sincronizare și necesită un profil autentificat.

Exemple

Scaffold a workspace local:

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

Scaffold and bootstrap a live agent in a environment in a single step:

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

Scaffolded a CLI-authored (CliCopilot) agent într-un anumit folder:

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

Parametri obligatorii pentru copilot init

--name -n

Nume afișat agent.

--publisher-prefix -pp

Publisher prefix de particularizare pentru soluție.

Parametri opționali pentru copilot init

--authoring-mode -am

The agent authoring shape to scaffold (default: 'classic'). Utilizați "cli-copilot" pentru a scaffolda un agent CliCopilot creat de CLICopilot.

--environment -env

Specifică dataverse țintă. Valoarea poate fi un URL GUID sau absolut https. Când nu este specificată, se va utiliza organizația activă selectată pentru profilul de autentificare curent.

--instructions -ins

Instrucțiuni de sistem pentru agent.

--project-dir -pd

Directorul țintă pentru spațiul de lucru al agentului. Implicit la directorul curent.

--schema-name -sn

Numele schemei agentului complet. Înlocuiește derivarea implicită ({publisher-prefix}_{sanitized-name}). Utilizat as-is fără modificări.

--template -t

Nume profil șablon (implicit, minim). Implicit la "implicit".

Observații

  • Directorul de proiect trebuie să fie gol. init nu se suprapune peste fișierele existente, așa că indicați --project-dir spre un folder nou sau gol.
  • Derivarea numelui schemei. Atunci când omiteți --schema-name, numele schemei agentului este construit ca {publisher-prefix}_{sanitized-name}. Treceți --schema-name pentru a o seta explicit; valoarea este utilizată as-is.
  • Bootstrap funcționează pentru ambele moduri de creare. init --environment bootstraps un agent live într-un singur pas pentru modul clasic implicit și pentru --authoring-mode cli-copilot. Ca alternativă pentru un agent CliCopilot, puteți să scaffold local (nu --environment), apoi să rulați pac copilot pack urmat de pac solution import pentru a-l implementa singur.
  • Bootstrap creează obiecte pe partea server. În modul bootstrap, init importă o soluție și creează agentul în mediul țintă. Dacă există deja un agent cu același nume de schemă, init oprește și vă indică să pac copilot clone vă conectați în schimb la agentul existent.
  • Un mediu nou-nouț poate fi lent pentru a accepta primul import. Un mediu proaspăt creat poate dura un minut sau două pentru a se încălzi. O bootstrap timpuriu poate să nu reușească cu "Operațiunile asincron sunt dezactivate în prezent pentru această organizație". Așteptați un moment și rulați-l din nou.
  • --template (default sau minimal) se aplică doar la modul clasic de creare.

pac copilot list

Lista de copilots din mediul Dataverse curent sau țintă.

Exemplu

Această comandă listează toate copilots în mediul Dataverse curent sau țintă.

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

Comanda returnează ieșire ca următoarea:

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

Parametri opționali pentru copilot list

--environment -env

Specifică dataverse țintă. Valoarea poate fi un URL GUID sau absolut https. Când nu este specificată, se va utiliza organizația activă selectată pentru profilul de autentificare curent.

pac copilot mcp

Informații despre serverul MCP local (Model Context Protocol).

Exemplu

pac copilot mcp --run

Parametri opționali pentru copilot mcp

--run -r

Rulați serverul LOCAL MCP (Model Context Protocol).

Acest parametru nu necesită nicio valoare. Este un comutator.

Observații

Aflați cum să utilizați Power Platform CLI cu serverul MCP încorporat

pac copilot merge-translation

Îmbinați fișierele care conțin conținut localizat pentru unul sau mai mulți roboți.

Exemplu

Această comandă îmbină fișierele care conțin conținut localizat pentru una sau mai multe copii.

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

Comanda returnează rezultate ca următoarele atunci când actualizați limba germană:

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.

Aflați cum să gestionați erorile din comanda îmbinare-traducere

Parametri opționali pentru copilot merge-translation

--environment -env

Specifică dataverse țintă. Valoarea poate fi un URL GUID sau absolut https. Când nu este specificată, se va utiliza organizația activă selectată pentru profilul de autentificare curent.

--file -f

Lista de fișiere care conțin traduceri. Modelele glob sunt acceptate.

--solution -s

Numele soluției.

--sourcedir -src

Director de soluții sursă. Atunci când se specifică, va ignora mediul conectat atunci când căutați roboți și, în schimb, va căuta conținut în folderul soluție.

--verbose

Afișați mai multe informații de diagnosticare în timpul importului/exportului de date

Acest parametru nu necesită nicio valoare. Este un comutator.

--whatif

Nu execută comanda, dar iesi detalii despre ceea ce s-ar întâmpla.

Acest parametru nu necesită nicio valoare. Este un comutator.

erori de îmbinare traducere

Pe baza exemplului de mai sus, dacă există o eroare în fișierul utilizat pentru a actualiza copilotul, rezultatul arată astfel:

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.

Semnalizarea --verbose adaugă detalii despre eroare:

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 AI Builder în mediul curent.

Exemplu

Această comandă listează toate modelele AI Builder.

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

Comanda returnează ieșire ca următoarea:

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

Parametri opționali pentru copilot model list

--environment -env

Specifică dataverse țintă. Valoarea poate fi un URL GUID sau absolut https. Când nu este specificată, se va utiliza organizația activă selectată pentru profilul de autentificare curent.

pac copilot model predict

Trimite text sau solicitare către modelul AI

Parametri opționali pentru copilot model predict

--environment -env

Specifică dataverse țintă. Valoarea poate fi un URL GUID sau absolut https. Când nu este specificată, se va utiliza organizația activă selectată pentru profilul de autentificare curent.

--model-id -id

ID model AI Builder

--model-name -n

Nume model AI complet sau parțial

--prompt -p

Solicitare de a trimite la modelul AI

--text -t

Text de trimis la modelul AI

pac copilot model prepare-fetch

Preia fișierul FetchXML din modelul de limbă mare ai (LLM) și îl pregătește pentru execuție în mediul curent.

Parametri obligatorii pentru copilot model prepare-fetch

--inputFile -i

Fișier FetchXML de intrare care provine de obicei de la AI LLM.

--outputFile -o

Fișier FetchXML de ieșire gata de execuție în mediul curent.

Parametri opționali pentru copilot model prepare-fetch

--environment -env

Specifică dataverse țintă. Valoarea poate fi un URL GUID sau absolut https. Când nu este specificată, se va utiliza organizația activă selectată pentru profilul de autentificare curent.

pac copilot pack

Împachetați un spațiu de lucru Copilot Studio agent într-un fișier zip soluție.

pac copilot pack pachete un spațiu de lucru agent într-o soluție .zip Dataverse pe care o puteți implementa cu pac solution import. Este forma independentă a pasului de ambalare care pac copilot init --environment rulează pentru dvs., astfel încât să puteți produce soluția implementabilă ca pas separat, de exemplu, într-o conductă de construire. Funcționează atât pentru spațiile de lucru pentru agenții clasici, cât și pentru spațiile de lucru ale agentului CLICopilot( CliCopilot).

Exemplu

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

Parametri obligatorii pentru copilot pack

--publisher-prefix -pp

Publisher prefix de particularizare pentru soluție.

Parametri opționali pentru copilot pack

--output-path -op

Calea de ieșire pentru fișierul zip soluție. Implicit la directorul curent.

--project-dir -pd

Director spațiu de lucru agent de împachetare. Implicit la directorul curent.

--solution-name -sn

Nume unic soluție. Dacă este omis, derivat din numele schemei agentului.

Observații

  • Este o operație locală. Pachetul citește spațiul de lucru și scrie o soluție .zip. Nu are nevoie de autentificare și de niciun mediu, deci este sigur să rulați într-o conductă de compilare.
  • Prefixul editorului trebuie să fie valid. --publisher-prefix trebuie să fie un prefix de particularizare bine format sau un pachet se oprește înainte de a scrie ceva.
  • Numele soluției și ieșirea. Dacă omiteți --solution-name, numele unic al soluției este derivat din numele schemei agentului. The .zip is written to the current directory unless you set --output-path.
  • Pachetul nu se implementează. Produce soluția, dar nu o importă. Urmați-l cu pac solution import pentru a implementa agentul, apoi pac copilot clone , dacă doriți un spațiu de lucru conectat la sincronizare pentru acesta.

pac copilot publish

Publicarea unui Copilot particularizat

Parametri obligatorii pentru copilot publish

--bot -id

Numele de schemă sau ID Copilot (nume unic găsit în Detalii bot sau nume de fișier în Explorer).

Parametri opționali pentru copilot publish

--environment -env

Specifică dataverse țintă. Valoarea poate fi un URL GUID sau absolut https. Când nu este specificată, se va utiliza organizația activă selectată pentru profilul de autentificare curent.

pac copilot pull

Extrageți modificările de la distanță din Copilot Studio și îmbinați cu spațiul de lucru local.

Comanda pac copilot pull preia starea curentă a serverului agentului și o îmbină în spațiul de lucru local, utilizând o îmbinare în trei sensuri. Acest proces asigură că editările pe partea server și fișierele locale neatinse rămân intacte. Rulați-l înainte de a începe editarea și rulați-l din nou înainte de a împinge modificările.

Exemplu

Rulați comanda din interiorul folderului spațiului de lucru:

pac copilot pull

Sau îndreptați-l către un spațiu de lucru în altă parte de pe disc:

pac copilot pull --project-dir contoso-support

Parametri opționali pentru copilot pull

--project-dir -pd

Calea către directorul de proiect. Implicit la directorul de lucru curent.

Observații

  • Rulați-l într-un spațiu de lucru de sincronizare. Comanda pull funcționează doar într-un folder creat de pac copilot clone sau pac copilot init. Acesta citește mediul țintă și agentul din metadatele de sincronizare ale spațiului de lucru, de aceea nu există niciun --environment argument. Dacă îl rulați în alt loc, nu reușește cu o eroare "spațiu de lucru negăsit".
  • Scrie în fișierele locale. Trageți îmbină modificările de la distanță în spațiul de lucru și descarcă fișiere de cunoștințe. Comiteți sau faceți backup muncii locale care vă interesează înainte de a trage.
  • Conectați-vă mai întâi cu pac auth create.

pac copilot push

Împingeți modificările spațiului de lucru local în Copilot Studio.

pac copilot push trimite înapoi modificările din spațiul de lucru local agentului din Dataverse. Acesta compară fișierele cu ultima stare de server cunoscută, încarcă doar ceea ce s-a modificat , inclusiv fișierele de cunoștințe, fluxurile în cloud și referințele de conexiune - și raportează ceea ce a împins.

Exemplu

Rulați-l din interiorul folderului spațiului de lucru:

pac copilot push

Sau îndreptați-l către un spațiu de lucru în altă parte de pe disc:

pac copilot push --project-dir contoso-support

Parametri opționali pentru copilot push

--project-dir -pd

Calea către directorul de proiect. Implicit la directorul de lucru curent.

Observații

  • Rulați-l într-un spațiu de lucru de sincronizare. La fel ca pull, push funcționează doar într-un folder creat de pac copilot clone sau pac copilot init. Acesta citește mediul țintă din metadatele de sincronizare ale spațiului de lucru. Nu există niciun --environment argument.
  • Trageți mai întâi dacă există un conflict. Dacă același element s-a modificat atât local, cât și pe server, împingerea se oprește și vă solicită să rulați pac copilot pull înainte de a încerca din nou. Acest proces împiedică suprascrierea silențioasă a unei modificări pe partea server pe care nu ați văzut-o.
  • Nicio modificare locală nu este un no-op. Dacă împingerea nu găsește nimic de trimis, raportează că și iese fără a atinge mediul.
  • O mutare reușită a agentului live în mediul țintă.
  • Conectați-vă mai întâi cu pac auth create.

pac copilot quarantine

Starea de carantină a agentului copilot.

Parametri obligatorii pentru copilot quarantine

--bot-id -id

ID-ul copilotului pentru carantină/deizolare.

Parametri opționali pentru copilot quarantine

--environment -env

Mediu (ID, ID organizație, URL, nume unic sau nume parțial).

--status -s

Valoarea statutului de carantină. True = carantină, fals = decarantină. Implicit este adevărat.

Acest parametru nu necesită nicio valoare. Este un comutator.

pac copilot status

Sondaj starea de implementare a unui copilot specificat în mediul Dataverse curent sau țintă.

Exemplu

Această comandă sondajează starea de implementare a unui copilot specificat în mediul Dataverse curent sau țintă.

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

Comanda returnează ieșire ca următoarea:

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

Parametri obligatorii pentru copilot status

--bot-id -id

ID-ul unui copilot (Chatbot).

Parametri opționali pentru copilot status

--environment -env

Specifică dataverse țintă. Valoarea poate fi un URL GUID sau absolut https. Când nu este specificată, se va utiliza organizația activă selectată pentru profilul de autentificare curent.

Autentificare și mediu pentru comenzile de sincronizare

Comenzile clone, pull, pushși init --environment toate vorbesc cu un mediu Dataverse, deci au nevoie de un profil de autentificare. Conectați-vă mai întâi cu pac auth create.

  • clone, pullși push solicitați un profil activ. pac copilot init are nevoie doar de unul atunci când treceți --environment; fără el, init schele de fișiere local și nu are nevoie de conectare.
  • pull și push citiți mediul țintă din metadatele de sincronizare ale spațiului de lucru, astfel încât să nu ia un --environment argument. clone și init fă-o.
  • pac copilot pack este pur local. Acesta citește și scrie doar fișiere, deci nu are nevoie de autentificare și de niciun mediu.

pull și push lucrați doar într-un spațiu de lucru creat de clone sau init. Metadatele de sincronizare scrise atunci când spațiul de lucru este creat este ceea ce le spune agentului și mediului cu care să discutați, prin urmare, rularea acestora nu reușește rapid, cu o eroare "spațiu de lucru negăsit".

Consultați și

Microsoft Power Platform grupuri de comenzi CLI
Microsoft Power Platform prezentare generală CLI

  • Last updated on