pac copilot

Eines i utilitats per a la gestió de copilots.

Les initordres , clone, pull, push, i pack et permeten mantenir un agent de Copilot Studio com un conjunt d'arxius al disc, editar-lo localment i sincronitzar-lo amb un entorn Dataverse.

Un bucle típic és així:

  1. Comença un espai de treball. Acompanya un agent nou amb pac copilot init, o descarrega'n un de ja existent amb pac copilot clone. En qualsevol cas, obtens un espai de treball local que transporta les metadades de sincronització de les quals depenen les altres ordres.
  2. Extreu abans d'editar. pac copilot pull Redueix els canvis remots i els fusiona amb els teus fitxers locals, així comences des de l'estat actual del servidor.
  3. Empeny quan acabis. pac copilot push Envia els canvis locals de tornada. Si el mateix element ha canviat al servidor mentrestant, el push s'atura i et demana que facis pull primer.
  4. Paquet per al desplegament. pac copilot pack Converteix un espai de treball en una solució .zip que pots desplegar amb pac solution import.

Per passar de no ser res a un agent viu en un sol pas, pac copilot init --environment estructura, empaqueta, importa i connecta l'espai de treball per a tu. Les ordres individuals et permeten controlar cada part del bucle per si sola.

Ordres

Ordre Descripció
pac copilot clone Clona un agent de Copilot Studio a un directori local d'espai de treball.
pac copilot create Crea un copilot nou utilitzant un fitxer de plantilla existent com a referència.
pac copilot delete Elimina un Copilot personalitzat.
pac copilot extract-template Extreu un fitxer de plantilla d'un copilot existent en un entorn.
pac copilot extract-translation Extreu el fitxer que conté contingut localitzat per a un o més bots.
pac copilot init Crea un nou espai de treball d'agent de Copilot Studio a partir d'una plantilla.
pac copilot list Llista de copilots de l'entorn actual o de destinació del Dataverse.
pac copilot mcp Informació sobre el servidor local MCP (Model Context Protocol).
pac copilot merge-translation Combina fitxers que contenen contingut localitzat per a un o més bots.
pac copilot model list Models d'AI Builder en l'entorn actual.
pac copilot model predict Envia text o sol·licitud al model d'IA
pac copilot model prepare-fetch Pren el fitxer FetchXML del model de llenguatge gran (LLM) de l'IA i el prepara per a l'execució en l'entorn actual.
pac copilot pack Empaqueta un espai de treball d'agent de Copilot Studio en un fitxer zip de la solució.
pac copilot publish Publicar un Copilot personalitzat
pac copilot pull Extreu els canvis remots de Copilot Studio i fusioneu-los amb l'espai de treball local.
pac copilot push Envia els canvis de l'espai de treball local a Copilot Studio.
pac copilot quarantine Estat de quarantena de l'agent copilot.
pac copilot status Sondeu l'estat d'implementació d'un copilot especificat a l'entorn actual o de destinació del Dataverse.

pac copilot clone

Clona un agent de Copilot Studio a un directori local d'espai de treball.

pac copilot clonedescarrega un agent existent de Copilot Studio en un directori local de l'espai de treball, juntament amb les metadades de sincronització en què pac copilot pull es depèn i pac copilot push es basen. Els fitxers de l'agent s'escriuen en una subcarpeta anomenada pel seu nom de visualització.

Exemple

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

Paràmetres requerits per a copilot clone

--bot -id

L'identificador del Copilot o el nom de l'esquema (nom únic que es troba als detalls del bot o nom del fitxer a l'explorador de solucions).

Paràmetres opcionals per a copilot clone

--component-collection -cc

ID de la col·lecció de components per clonar. Repeteix per a diversos.

--display-name -dn

Nom de visualització de l'agent (utilitzat per a la nomenclatura de carpetes).

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

--output-dir -od

Carpeta arrel per a la sortida del clon. Per defecte el directori actual.

Observacions

  • --botaccepta un ID de Copilot o nom d'esquema. Passa o bé l'ID del Copilot (un GUID) o el nom de l'esquema de l'agent. La comanda resol un nom d'esquema contra l'entorn objectiu.
  • La subcarpeta de destinació ha d'estar buida. Clone escriu en una carpeta anomenada segons el nom de pantalla (sanititzat) de l'agent sota --output-dir. Si aquesta carpeta ja conté fitxers, clonar s'atura en comptes d'escriure'ls. Utilitza --display-name per triar un nom de carpeta diferent.
  • Clonació de col·leccions de components. Per fer baixar les col·leccions de components juntament amb l'agent, passa un o més IDs de col·lecció amb --component-collection, separats per punts i coma.
  • El clon requereix un perfil autenticat (pac auth create) i resol l'entorn des de --environment, o des de l'organització del perfil actiu quan l'omets.

pac copilot create

Crea un copilot nou utilitzant un fitxer de plantilla existent com a referència.

Paràmetres requerits per a copilot create

--displayName

El nom de visualització del nou copilot

--schemaName

El nom de l'esquema (nom únic) del nou copilot.

--solution -s

Nom de la solució.

--templateFileName

Fitxer yaml d'origen que conté la plantilla copilot que s'ha extret mitjançant l'ordre extract-template.

Paràmetres opcionals per a copilot create

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

pac copilot delete

Elimina un Copilot personalitzat.

Paràmetres requerits per a copilot delete

--bot -id

L'identificador del Copilot o el nom de l'esquema (nom únic que es troba als detalls del bot o nom del fitxer a l'explorador de solucions).

Paràmetres opcionals per a copilot delete

--confirm -y

Cal confirmar l'eliminació del copilot.

Aquest paràmetre no requereix cap valor. És un canvi.

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

pac copilot extract-template

Extreu un fitxer de plantilla d'un copilot existent en un entorn.

Exemple

Aquesta ordre extreu un fitxer de plantilla d'un copilot existent en un entorn.

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

L'ordre retorna una sortida com la següent per a un copilot que utilitza els idiomes anglès i alemany:

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

Paràmetres requerits per a copilot extract-template

--bot -id

L'identificador del Copilot o el nom de l'esquema (nom únic que es troba als detalls del bot o nom del fitxer a l'explorador de solucions).

--templateFileName

Ubicació del fitxer yaml on escriure la plantilla del copilot.

Paràmetres opcionals per a copilot extract-template

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

--overwrite -o

Permet la sobreescriptura del fitxer de dades de sortida si ja existeix.

Aquest paràmetre no requereix cap valor. És un canvi.

--templateName

Nom de la plantilla o 'kickStartTemplate' si no s'especifica el nom.

--templateVersion

Versió de la plantilla en format X.X.X o 1.0.0 si no s'especifica la versió.

pac copilot extract-translation

Extreu el fitxer que conté contingut localitzat per a un o més bots.

Exemple

Aquesta ordre extreu un fitxer que conté contingut localitzat per a un o més copilots.

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

L'ordre retorna una sortida com la següent:

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

Paràmetres opcionals per a copilot extract-translation

--all -a

Escriviu fitxers de localització per a tots els idiomes compatibles. Per defecte, només s'escriu l'idioma principal.

Aquest paràmetre no requereix cap valor. És un canvi.

--bot -id

L'identificador del Copilot o el nom de l'esquema (nom únic que es troba als detalls del bot o nom del fitxer a l'explorador de solucions).

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

--format

El format de fitxer en el qual s'han d'escriure fitxers localitzats, ja sigui 'resx' o 'json'. El valor predeterminat és 'resx'.

--outdir

El directori de sortida on escriure.

--overwrite -o

Permet la sobreescriptura del fitxer de dades de sortida si ja existeix.

Aquest paràmetre no requereix cap valor. És un canvi.

--sourcedir -src

Directori de la solució d'origen. Quan s'especifiqui, ignorarà l'entorn connectat quan cerqui bots i, en canvi, buscarà contingut a la carpeta de la solució.

pac copilot init

Crea un nou espai de treball d'agent de Copilot Studio a partir d'una plantilla.

pac copilot initEstructura un nou espai de treball d'agent de Copilot Studio a partir d'una plantilla. Funciona en un de dos modes, i la presència de --environment decideix quin mode utilitzar:

  • Bastida local — no --environment. Escriu els fitxers de plantilla al directori del projecte i s'atura. L'ordre no crea res a Dataverse i no requereix iniciar sessió. Utilitza aquest mode quan vulguis crear localment i connectar-te a un entorn més endavant.
  • Bootstrap — --environment subministrat. Estructura els fitxers, els empaqueta en una solució, importa aquesta solució a l'entorn i connecta l'espai de treball amb l'agent recentment creat. Aquest mode és el camí d'un sol pas des del no-res fins a un agent en viu i preparat per sincronitzar, i requereix un perfil autenticat.

Exemples

Estructura un espai de treball localment:

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

Abastiu i feu un bootstrap a un agent viu en un entorn en un sol pas:

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

Estructura un agent creat per CLI (CliCopilot) en una carpeta específica:

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

Paràmetres requerits per a copilot init

--name -n

Nom mostrat de l'agent.

--publisher-prefix -pp

Prefix de personalització del Publisher per a la solució.

Paràmetres opcionals per a copilot init

--authoring-mode -am

L'agent que crea la forma per a l'andamiatge (per defecte: 'clàssic'). Fes servir 'cli-copilot' per fer un bastidor d'un agent CliCopilot creat per la CLI.

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

--instructions -ins

Instruccions del sistema de l'agent.

--project-dir -pd

Directori objectiu per a l'espai de treball de l'agent. Per defecte el directori actual.

--schema-name -sn

Nom complet de l'esquema de l'agent. Anul·la la derivació per defecte ({publisher-prefix}_{sanitized-name}). Utilitzat as-is sense modificacions.

--template -t

Nom del perfil de la plantilla (per defecte, mínim). Per defecte és 'per defecte'.

Observacions

  • El directori del projecte ha d'estar buit. init No fa estructures sobre fitxers existents, així que apunta --project-dir a una carpeta nova o buida.
  • Derivació del nom de l'esquema. Quan omets --schema-name, el nom de l'esquema de l'agent es construeix com {publisher-prefix}_{sanitized-name}. Pass --schema-name per establir-lo explícitament; el valor s'utilitza as-is.
  • Bootstrap funciona per a ambdós modes d'autor. init --environment Arrenca un agent viu en un sol pas per al mode clàssic per defecte i per --authoring-mode cli-copilota . Com a alternativa a un agent CliCopilot, pots fer un bastidor localment (no --environment), després executar pac copilot pack i pac solution import després desplegar-lo tu mateix.
  • Bootstrap crea objectes al costat del servidor. En mode d'arrencada, init importa una solució i crea l'agent a l'entorn objectiu. Si ja existeix un agent amb el mateix nom d'esquema, init s'atura i t'indica pac copilot clone que et connectis amb l'agent existent.
  • Un entorn nou pot trigar a acceptar la primera importació. Un entorn acabat de crear pot trigar un minut o dos a escalfar-se. Un bootstrap inicial pot fallar amb "Les operacions asíncrones estan actualment desactivades per a aquesta organització." Espera un moment i torna-ho a executar.
  • --template (default o minimal) s'aplica només al mode clàssic d'autoria.

pac copilot list

Llista de copilots de l'entorn actual o de destinació del Dataverse.

Exemple

Aquesta ordre llista tots els copilots de l'entorn actual o de destinació del Dataverse.

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

L'ordre retorna una sortida com la següent:

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

Paràmetres opcionals per a copilot list

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

pac copilot mcp

Informació sobre el servidor local MCP (Model Context Protocol).

Exemple

pac copilot mcp --run

Paràmetres opcionals per a copilot mcp

--run -r

Executa el servidor local MCP (Model Context Protocol).

Aquest paràmetre no requereix cap valor. És un canvi.

Observacions

Aprèn a utilitzar la CLI de Power Platform amb servidor MCP integrat

pac copilot merge-translation

Combina fitxers que contenen contingut localitzat per a un o més bots.

Exemple

Aquesta ordre combina fitxers que contenen contingut localitzat per a un o més copilots.

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

L'ordre retorna una sortida com la següent quan s'actualitza l'idioma alemany:

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.

Més informació sobre com gestionar els errors des de l'ordre merge-translation

Paràmetres opcionals per a copilot merge-translation

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

--file -f

Llista de fitxers que contenen traduccions. S'admeten patrons globals.

--solution -s

Nom de la solució.

--sourcedir -src

Directori de la solució d'origen. Quan s'especifiqui, ignorarà l'entorn connectat quan cerqui bots i, en canvi, buscarà contingut a la carpeta de la solució.

--verbose

Genera més informació de diagnòstic durant la importació/exportació de dades

Aquest paràmetre no requereix cap valor. És un canvi.

--whatif

No executa l'ordre, sinó que mostra els detalls del que passaria.

Aquest paràmetre no requereix cap valor. És un canvi.

errors de fusió-traducció

Basant-se en l'exemple anterior, si hi ha un error al fitxer utilitzat per actualitzar el copilot, la sortida és així:

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.

L'indicador --verbose afegeix detalls sobre l'error:

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

Models d'AI Builder en l'entorn actual.

Exemple

Aquesta ordre enumera tots els models d'AI Builder.

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

L'ordre retorna una sortida com la següent:

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

Paràmetres opcionals per a copilot model list

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

pac copilot model predict

Envia text o sol·licitud al model d'IA

Paràmetres opcionals per a copilot model predict

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

--model-id -id

Identificador del model AI Builder

--model-name -n

Nom del model d'IA complet o parcial

--prompt -p

Sol·licitud d'enviament al model d'IA

--text -t

Text per enviar al model d'IA

pac copilot model prepare-fetch

Pren el fitxer FetchXML del model de llenguatge gran (LLM) de l'IA i el prepara per a l'execució en l'entorn actual.

Paràmetres requerits per a copilot model prepare-fetch

--inputFile -i

Introduïu el fitxer FetchXML que normalment prové d'AI LLM.

--outputFile -o

Sortida del fitxer FetchXML que està llest per executar-se en l'entorn actual.

Paràmetres opcionals per a copilot model prepare-fetch

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

pac copilot pack

Empaqueta un espai de treball d'agent de Copilot Studio en un fitxer zip de la solució.

pac copilot pack empaqueta un espai de treball d'agent en una solució .zip Dataverse que pots desplegar amb pac solution import. És la forma independent del pas d'empaquetament que pac copilot init --environment s'executa per a tu, de manera que pots produir la solució desplegable com un pas separat — per exemple, en una pipeline de compilació. Funciona tant per a espais de treball clàssics com per a agents creats per LI (CliCopilot).

Exemple

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

Paràmetres requerits per a copilot pack

--publisher-prefix -pp

Prefix de personalització del Publisher per a la solució.

Paràmetres opcionals per a copilot pack

--output-path -op

Ruta de sortida per al fitxer zip de la solució. Per defecte el directori actual.

--project-dir -pd

Directori de l'espai de treball de l'agent per empaquetar. Per defecte el directori actual.

--solution-name -sn

Solució nom únic. Si s'omet, es deriva del nom de l'esquema de l'agent.

Observacions

  • És una operació local. Pack llegeix l'espai de treball i escriu una solució .zip. No necessita autenticació ni entorn, així que és segur executar-lo en una pipeline de compilació.
  • El prefix d'editor ha de ser vàlid. --publisher-prefix Ha de tenir un prefix de personalització ben format, o fer aturades de paquet abans d'escriure res.
  • Nom de la solució i sortida. Si omets --solution-name, el nom únic de la solució es deriva del nom de l'esquema de l'agent. El .zip s'escriu al directori actual tret que configuris --output-path.
  • La manada no es desplega. Produeix la solució però no l'importa. Segueix-lo per pac solution import desplegar l'agent, i si pac copilot clone vols un espai de treball sincronitzat per a ell.

pac copilot publish

Publicar un Copilot personalitzat

Paràmetres requerits per a copilot publish

--bot -id

L'identificador del Copilot o el nom de l'esquema (nom únic que es troba als detalls del bot o nom del fitxer a l'explorador de solucions).

Paràmetres opcionals per a copilot publish

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

pac copilot pull

Extreu els canvis remots de Copilot Studio i fusioneu-los amb l'espai de treball local.

L'ordre pac copilot pull obté l'estat actual del servidor de l'agent i el fusiona amb el teu espai de treball local mitjançant una fusió a tres bandes. Aquest procés garanteix que les edicions del servidor i els fitxers locals intactes es mantinguin intactes. Executa'l abans de començar a editar, i torna'l a executar abans d'enviar els canvis.

Exemple

Executa la comanda des de dins de la carpeta de l'espai de treball:

pac copilot pull

O apunta'l a un espai de treball en un altre lloc del disc:

pac copilot pull --project-dir contoso-support

Paràmetres opcionals per a copilot pull

--project-dir -pd

Camí cap al directori del projecte. Per defecte és el directori de treball actual.

Observacions

  • Executa'l dins d'un espai de treball de sincronització. La pull comanda només funciona en una carpeta creada per pac copilot clone o pac copilot init. Llegeix l'entorn objectiu i l'agent a partir de les metadades de sincronització de l'espai de treball, per això no --environment hi ha discussió. Si l'executes en un altre lloc, falla amb un error de "workspace no trobat".
  • Escriu als teus fitxers locals. Pull fusiona els canvis remots a l'espai de treball i descarrega fitxers de coneixement. Compromet-te o dóna suport a treballs locals que t'importin abans de retirar-los.
  • Inicia sessió primer amb pac auth create.

pac copilot push

Envia els canvis de l'espai de treball local a Copilot Studio.

pac copilot push envia els canvis al teu espai de treball local de tornada a l'agent de Dataverse. Compara els teus fitxers amb l'últim estat conegut del servidor, puja només el que ha canviat —incloent-hi fitxers de coneixement, fluxos al núvol i referències de connexió— i informa del que ha enviat.

Exemple

Executa'l des de dins de la carpeta de l'espai de treball:

pac copilot push

O apunta'l a un espai de treball en un altre lloc del disc:

pac copilot push --project-dir contoso-support

Paràmetres opcionals per a copilot push

--project-dir -pd

Camí cap al directori del projecte. Per defecte és el directori de treball actual.

Observacions

  • Executa'l dins d'un espai de treball de sincronització. Com pull, push només funciona en una carpeta creada per pac copilot clone o pac copilot init. Llegeix l'entorn objectiu a partir de les metadades de sincronització de l'espai de treball. No hi ha --environment discussió.
  • Tira primer si hi ha un conflicte. Si el mateix element ha canviat tant localment com al servidor, el push s'atura i et demana que executis pac copilot pull abans de tornar-ho a intentar. Aquest procés evita que un push sobreescrigui silenciosament un canvi al costat del servidor que no havies vist.
  • Cap canvi local és un no-op. Si Push no troba res per enviar, ho informa i surt sense tocar l'entorn.
  • Un impuls reeixit muta l'agent viu en l'entorn objectiu.
  • Inicia sessió primer amb pac auth create.

pac copilot quarantine

Estat de quarantena de l'agent copilot.

Paràmetres requerits per a copilot quarantine

--bot-id -id

La identificació del copilot per posar en quarantena/desquarantena.

Paràmetres opcionals per a copilot quarantine

--environment -env

Entorn (ID, ID d'organització, URL, nom únic o nom parcial).

--status -s

Valor d'estat de quarantena. Cert = quarantena, fals = desquarantena. Per defecte és veritat.

Aquest paràmetre no requereix cap valor. És un canvi.

pac copilot status

Sondeu l'estat d'implementació d'un copilot especificat a l'entorn actual o de destinació del Dataverse.

Exemple

Aquesta ordre sondeja l'estat de desplegament d'un copilot especificat a l'entorn actual o de destinació del Dataverse.

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

L'ordre retorna una sortida com la següent:

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

Paràmetres requerits per a copilot status

--bot-id -id

L'identificador d'un copilot (Chatbot).

Paràmetres opcionals per a copilot status

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

Autenticació i entorn per a les ordres de sincronització

Les cloneordres , pull, push, i init --environment es comuniquen totes amb un entorn Dataverse, així que necessiten un perfil d'autenticació. Inicia sessió primer amb pac auth create.

  • clone, pull, i push requereixen un perfil actiu. pac copilot init Només en necessita un quan aproves --environment; sense ell, init el bastidor fa fitxers localment i no necessita iniciar sessió.
  • pull i push llegir l'entorn objectiu a partir de les metadades de sincronització de l'espai de treball, perquè no s'hi posin en compte --environment . clone I init fer-ho.
  • pac copilot pack és purament local. Només llegeix i escriu fitxers, així que no necessita autenticació ni entorn.

pull i push només treballar dins d'un espai de treball creat per clone o init. Les metadades de sincronització escrites quan es crea l'espai de treball són les que els indiquen amb quin agent i entorn han de parlar, així que executar-los a qualsevol altre lloc falla ràpidament amb un error de "espai de treball no trobat".

Consulteu també

Microsoft Power Platform Grups de Comandament CLI
Microsoft Power Platform Visió general de la CLI

  • Last updated on