pac copilot

Kopilotuen kudeaketarako tresnak eta erabilgarritasunak.

init, clone, pull, push, eta pack komandoek Copilot Studio agente bat diskoan fitxategi multzo gisa gordetzeko, tokian tokiko editatzeko eta Dataverse ingurune batekin sinkronizatzeko aukera ematen dute.

Loop tipiko bat honela:

1. Lan-ingurune bat hasi. Eskailera egin agente pac copilot initberri bat , edo deskargatu dagoeneko dagoen bat .pac copilot clone Edozein kasutan, tokiko lan-eremu bat lortzen duzu, non beste aginduek oinarritzen diren sinkronizazio metadatuak eramaten diren.
2. Atera editatu aurretik. pac copilot pull urruneko aldaketak jaitsi eta zure fitxategi lokaletan bat egiten ditu, horrela egungo zerbitzariaren egoeratik hasten zara.
3. Amaitu duzunean bultzatu. pac copilot push Zure tokiko aldaketak itzultzen ditu. Bitartean zerbitzarian elementu bera aldatu bada, push gelditzen da eta lehenengo pull egiteko eskatzen dizu.
4. Paketea inplementatzeko. pac copilot pack lan-espazio bat soluzio .zip bihurtzen du, eta hori erabiliz inplementatu pac solution importdaiteke.

Ezer ez izatetik agente bizidun batera pauso bakarrean pasatzeko, pac copilot init --environment eskailerak prestatzen, paketatzen, inportatzen eta lan-eremua konektatzen du zuretzat. Komando bakoitzak zirkuluaren atal bakoitza bere kabuz gidatzea ahalbidetzen dizu.

Komandoak

pac copilot clone

Klonatu Copilot Studio agente bat tokiko lan-eremu direktorio batera.

pac copilot cloneCopilot Studio agente bat deskargatzen du tokiko lan-eremu direktorio batean, sinkronizazio metadatuekin pac copilot pullpac copilot push batera. Agentearen fitxategiak azpikarpeta batean idazten dira, bere bistaratze izenaren arabera izendatutako azpikarpeta batean.

Adibidea

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

Beharrezko parametroak honako copilot clone

--bot -id

Copilot IDa edo eskemaren izena (Bot-aren xehetasunetan edo fitxategi-izena irtenbideen esploratzailean aurkitzen den izen bakarra).

Aukerako parametroak copilot clone

--component-collection -cc

Osagaien bilduma IDa klonatzeko. Errepikatu hainbat kasutan.

--display-name -dn

Agentearen bistaratze izena (karpeta izendatzeko erabiltzen dena).

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

--output-dir -od

Erro karpeta klon irteerarako. Lehenespenez, uneko direktorioa da.

Oharrak

• --botCopilot ID edo eskema izena onartzen du. Pasatu Copilot ID-a (GUID) edo agentearen eskema izena. Komandoak eskema izen bat helburu ingurunearekin konpontzen du.
• Helmuga azpikarpeta hutsik egon behar da. Klonak agentearen (garbitutako) bistaratze-izenaren --output-dirizena daraman karpeta batean idazten du, . Karpeta horrek jada fitxategiak baditu, klonak gelditzen ditu, ez gainidatzi. Erabili --display-name karpeta izen desberdin bat aukeratzeko.
• Osagai bildumak klonatzea. Osagaien bildumak agentearekin batera jaisteko, bilduma-ID bat edo gehiago pasatu --component-collection, puntu eta komaz banatuta.
• Klonak profil autentifikatu bat behar du (pac auth create) eta ingurunea --environmentkonpontzen du , edo profil aktiboaren erakundetik, zuk baztertzen duzunean.

pac copilot create

Kopilotu berri bat sortzen du, lehendik dagoen txantiloi-fitxategi bat erreferentzia gisa erabiliz.

Beharrezko parametroak honako copilot create

--displayName

Kopilotu berriaren bistaratze-izena

--schemaName

Kopilotu berriaren eskemaren izena (izen bakarra).

--solution -s

Irtenbidearen izena.

--templateFileName

Iturburuko yaml fitxategia, extract-template komandoa erabiliz erauzitako kopilotuaren txantiloia duena.

Aukerako parametroak copilot create

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

pac copilot delete

Ezabatu Copilot pertsonalizatu bat.

Beharrezko parametroak honako copilot delete

--bot -id

Copilot IDa edo eskemaren izena (Bot-aren xehetasunetan edo fitxategi-izena irtenbideen esploratzailean aurkitzen den izen bakarra).

Aukerako parametroak copilot delete

--confirm -y

Kopilotuaren ezabapena baieztatzeko beharrezkoa da.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

pac copilot extract-template

Txantiloi-fitxategi bat ingurune batean lehendik dagoen kopilotu batetik erauzten du.

Adibidea

Komando honek txantiloi-fitxategi bat erauzten du ingurune batean lehendik dagoen kopilotu batetik.

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

Komandoak honako irteera itzultzen du ingelesa eta alemana erabiltzen dituen kopilotu batentzat:

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

Beharrezko parametroak honako copilot extract-template

--bot -id

Copilot IDa edo eskemaren izena (Bot-aren xehetasunetan edo fitxategi-izena irtenbideen esploratzailean aurkitzen den izen bakarra).

--templateFileName

Txantiloia kopilotua idazteko yaml fitxategiaren kokalekua.

Aukerako parametroak copilot extract-template

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

--overwrite -o

Baimendu irteerako datu-fitxategia gainidaztea, lehendik badago.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--templateName

Txantiloiaren izena edo 'kickStartTemplate' izena zehazten ez bada.

--templateVersion

Txantiloiaren bertsioa X.X.X formatuan edo 1.0.0 formatuan, bertsioa zehaztu ez bada.

pac copilot extract-translation

Bot baten edo gehiagoren eduki lokalizatua duen fitxategia erauzten du.

Adibidea

Komando honek kopilotu baten edo gehiagoren eduki lokalizatua duen fitxategia erauzten du.

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

Komandoak honako irteera honela itzultzen du:

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

Aukerako parametroak copilot extract-translation

--all -a

Idatzi lokalizazio-fitxategiak onartutako hizkuntza guztietarako. Lehenespenez, hizkuntza nagusia bakarrik idazten da.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--bot -id

Copilot IDa edo eskemaren izena (Bot-aren xehetasunetan edo fitxategi-izena irtenbideen esploratzailean aurkitzen den izen bakarra).

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

--format

Fitxategi lokalizatuak idazteko fitxategi-formatua, 'resx' edo 'json'. Lehenetsia 'resx' da.

--outdir

Idazteko irteerako direktorioa.

--overwrite -o

Baimendu irteerako datu-fitxategia gainidaztea, lehendik badago.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--sourcedir -src

Iturburuko soluzioaren direktorioa. Zehazten denean, konektatutako inguruneari ez jaramonik egingo dio bot-ak bilatzean, eta horren ordez edukia bilatuko du irtenbidearen karpetan.

pac copilot init

Sortu Copilot Studio agente lan-espazio berri bat txantiloi batetik.

pac copilot initCopilot Studio agente lan-espazio berri bat plantilla batetik antolatzen du. Bi moduetako batean exekutatzen da, eta - --environment ren presentziak erabakitzen du zein modu erabili:

• Tokiko eskailera — ez.--environment Txantiloi fitxategiak proiektuaren direktorioan idazten ditu eta gelditzen da. Komandoak ez du ezer sortzen Dataverse-n eta ez du saioa hasi behar. Erabili modu hau tokian tokiko idazle egin nahi duzunean eta gero ingurune batera konektatzeko.
• Bootstrap — --environment hornitua. Fitxategiak estaltzen ditu, soluzio batean paketatzen ditu, soluzio hori ingurunean inportatzen du, eta lan-espazioa agente berriarekin konektatzen du. Modu hau bide bakarreko bidea da, ezer ezetik sinkronizazio prest dagoen agente batera, eta profil autentifikatu bat behar du.

Adibideak

Lan-espazio bat tokian tokiko eskailera egin:

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

Ingurune batean agente bizidun bat sortu eta abiarazi pauso bakarrean:

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

Eskailera egin CLI-k sortutako (CliCopilot) agente bat karpeta zehatz batean:

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

Beharrezko parametroak honako copilot init

--name -n

Agentearen izen bistaratua.

--publisher-prefix -pp

Publisher pertsonalizazio aurrizkia soluziorako.

Aukerako parametroak copilot init

--authoring-mode -am

Agenteak forma sortzen du eskailera bihurtzeko (lehenetsia: 'klasikoa'). Erabili 'cli-copilot' CLI-k sortutako CliCopilot agente bat babesteko.

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

--instructions -ins

Agenteen sistemaren argibideak.

--project-dir -pd

Agentearen lan-espazioaren helburu direktorioa. Lehenespenez, uneko direktorioa da.

--schema-name -sn

Agentearen eskema osoaren izena. Lehenetsitako deribazioa gainditzen du ({publisher-prefix}_{sanitized-name}). Modifikaziorik gabe as-is erabili nuen.

--template -t

Plantilla profilaren izena (lehenetsia, minimala). Lehenetsita, 'lehenetsita'.

Oharrak

• Proiektuaren direktorioa hutsik egon behar da. init Ez du fitxategi zaharrak estaltzen, beraz, karpeta berri edo huts batera seinalatu --project-dir .
• Eskema izenaren deribazioa. Baztertzen --schema-nameduzunean , agentearen eskema izena honela {publisher-prefix}_{sanitized-name}eraikitzen da. Pass --schema-name to set argi eta garbi; balioa erabiltzen as-is.
• Bootstrap bi sorkuntza moduetarako funtzionatzen du. init --environment Live Agent bat Boot Steps batean Classic modu lehenetsiarentzat eta --authoring-mode cli-copilot. CliCopilot agente baten alternatiba gisa, bertan eskailera egin dezakezu (ez), --environmentgero exekutatu pac copilot pack eta pac solution import zuk zeuk deployatu.
• Bootstrap-ek zerbitzari aldeko objektuak sortzen ditu. Bootstrap moduan, init soluzio bat inportatzen du eta agentea sortzen du helburu ingurunean. Eskema izen bera duen agente bat dagoeneko badago, init gelditzen da eta dagoeneko dagoen agentearekin konektatzeko seinalatzen pac copilot clone dizu.
• Ingurune berri batek lehen inportazioa onartzeko motela izan daiteke. Sortutako ingurune berriak minutu edo bi behar izan ditzake berotzeko. Hasierako bootstrap batek huts egin dezake "Async operazioak une honetan desgaituta daude erakunde honetan." Itxaron une batez eta berriro exekutatu.
• --template (default edo minimal) klasiko idazle moduan bakarrik aplikatzen da.

pac copilot list

Uneko edo helburuko Dataverse inguruneko koploten zerrenda.

Adibidea

Komando honek uneko edo helburuko Dataverse inguruneko koplote guztiak zerrendatzen ditu.

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

Komandoak honako irteera honela itzultzen du:

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

Aukerako parametroak copilot list

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

pac copilot mcp

MCP (Model Context Protocol) zerbitzari lokalari buruzko informazioa.

Adibidea

pac copilot mcp --run

Aukerako parametroak copilot mcp

--run -r

Exekutatu MCP (Model Context Protocol) zerbitzari lokala.

Parametro honek ez du baliorik behar. Aldaketa bat da.

Oharrak

Ikasi Power Platform CLI nola erabili MCP zerbitzari integratuarekin

pac copilot merge-translation

Batu bot baten edo gehiagoren eduki lokalizatua duten fitxategiak.

Adibidea

Komando honek kopilotu baten edo gehiagoren eduki lokalizatua duten fitxategiak batzen ditu.

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

Komandoak honako irteera itzultzen du alemana eguneratzean:

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.

Ikasi erroreak nola kudeatu merge-translation komandotik

Aukerako parametroak copilot merge-translation

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

--file -f

Itzulpenak dituzten fitxategien zerrenda. Globo ereduak onartzen dira.

--solution -s

Irtenbidearen izena.

--sourcedir -src

Iturburuko soluzioaren direktorioa. Zehazten denean, konektatutako inguruneari ez jaramonik egingo dio bot-ak bilatzean, eta horren ordez edukia bilatuko du irtenbidearen karpetan.

--verbose

Diagnostiko-informazio gehiago ateratzen da datuak inportatzean/esportatzean

Parametro honek ez du baliorik behar. Aldaketa bat da.

--whatif

Ez du komandoa exekutatzen, baina gertatuko denaren xehetasunak erakusten ditu.

Parametro honek ez du baliorik behar. Aldaketa bat da.

bateratze-itzulpenaren erroreak

Goiko adibidean oinarrituta, kopilotua eguneratzeko erabilitako fitxategian errore bat badago, irteera honako hau da:

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.

Banderak --verbose erroreari buruzko xehetasunak gehitzen ditu:

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 ereduak egungo ingurunean.

Adibidea

Komando honek AI Builder eredu guztiak zerrendatzen ditu.

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

Komandoak honako irteera honela itzultzen du:

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

Aukerako parametroak copilot model list

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

pac copilot model predict

Testua edo gonbidapena AI ereduari bidaltzen dio

Aukerako parametroak copilot model predict

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

--model-id -id

AI Builder-en ereduaren IDa

--model-name -n

AI eredu osoa edo partziala

--prompt -p

Adimen artifizialeko ereduari bidaltzeko gonbidatu

--text -t

Adimen artifizialeko ereduari bidaltzeko testua

pac copilot model prepare-fetch

AI Large Language Model (LLM) fitxategia hartzen du eta uneko ingurunean exekutatzeko prestatzen du.

Beharrezko parametroak honako copilot model prepare-fetch

--inputFile -i

Sarrerako FetchXML fitxategia, normalean AI LLM-tik datorrena.

--outputFile -o

Irteerako FetchXML fitxategia, uneko ingurunean exekutatzeko prest dagoena.

Aukerako parametroak copilot model prepare-fetch

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

pac copilot pack

Copilot Studio agente lan-espazio bat paketatu soluzio-zip fitxategi batean.

pac copilot pack agente lan-espazio bat Dataverse soluzio .zip batean paketatzen du, eta hori inplementatu dezakezu pac solution import. Paketatze pausoaren forma autonomoa da, pac copilot init --environment zuretzat exekutatzen dena, beraz, deployable soluzioa pauso bereizi gisa sor dezakezu — adibidez, build pipeline batean. Bai klasiko bai CLI-k sortutako (CliCopilot) agenteen lan-lanetarako funtzionatzen du.

Adibidea

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

Beharrezko parametroak honako copilot pack

--publisher-prefix -pp

Publisher pertsonalizazio aurrizkia soluziorako.

Aukerako parametroak copilot pack

--output-path -op

Soluzioaren zip fitxategiaren irteerako bidea. Lehenespenez, uneko direktorioa da.

--project-dir -pd

Agentearen lan-espazioaren direktorioa paketean jartzeko. Lehenespenez, uneko direktorioa da.

--solution-name -sn

Soluzioaren izen bakarra da. Baztertzen bada, agentearen eskema izenetik eratorria da.

Oharrak

• Tokiko operazioa da. Pack-ek lan-espazioa irakurtzen du eta soluzio .zipbat idazten du. Ez du autentifikaziorik edo ingurunerik behar, beraz, eraikuntza-pipeline batean exekutatzea segurua da.
• Argitaletxearen aurrizkia baliozkoa izan behar da. --publisher-prefix Pertsonalizazio aurrizki ondo osatu bat egon behar da, edo pakete geldialdiak idatzi aurretik.
• Soluzioaren izena eta irteera. Baztertzen --solution-namebaduzu, soluzioaren izen bakarra agentearen eskema izenetik dator. Egungo .zip direktorioan idazten da, baldin eta ez baduzu --output-path.
• Pack-a ez da zabaltzen. Soluzioa sortzen du baina ez du inportatzen. Jarraitu pac solution import agentea martxan jartzeko, eta gero pac copilot clone sinkronizazio konektatutako lan-espazio bat nahi baduzu.

pac copilot publish

Argitaratu kopilotu pertsonalizatua

Beharrezko parametroak honako copilot publish

--bot -id

Copilot IDa edo eskemaren izena (Bot-aren xehetasunetan edo fitxategi-izena irtenbideen esploratzailean aurkitzen den izen bakarra).

Aukerako parametroak copilot publish

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

pac copilot pull

Atera urruneko aldaketak Copilot Studio-tik eta batu tokiko lan-eremuarekin.

Komandoak pac copilot pull agentearen zerbitzariaren egoera jasotzen du eta zure tokiko lan-espazioan batzen du hiru norabideko bateratze baten bidez. Prozesu honek ziurtatzen du zerbitzari aldeko aldaketak eta ukitu gabeko tokiko fitxategiak osorik mantentzen direla. Editatzen hasi aurretik exekutatu, eta berriro exekutatu aldaketak bultzatu aurretik.

Adibidea

Exekutatu komandoa lan-espazio karpeta barrutik:

pac copilot pull

Edo diskoan beste lan-espazio batera zuzendu:

pac copilot pull --project-dir contoso-support

Aukerako parametroak copilot pull

--project-dir -pd

Proiektuaren direktoriora bidea. Lehenetsitako egungo direktorio funtzionalean jartzen da.

Oharrak

• Sinkronizazio lan-espazio batean exekutatu. Komandoa pull soilik edo pac copilot initedo sortutako pac copilot clone karpeta batean funtzionatzen du. Lan-ingurunearen sinkronizazio metadatuetatik helburu ingurunea eta agentea irakurtzen ditu, horregatik ez --environment eztabaidarik. Beste leku batean exekutatzen baduzu, huts egiten du "lan-espazioa aurkitu gabe" errorearekin.
• Zure fitxategi lokaletan idazten du. Pull urruneko aldaketak lan-eremuan bateratzen ditu eta ezagutza fitxategiak deskargatzen ditu. Konprometitu edo babestu behar duzun tokiko lanak kendu aurretik.
• Lehenengo saioa hasi .pac auth create

pac copilot push

Bultzatu tokiko lan-inguruneko aldaketak Copilot Studio-ra.

pac copilot push zure tokiko lan-inguruneko aldaketak Dataverse-ko agenteari bidaltzen dizkio. Zure fitxategiak azken zerbitzari egoerarekin alderatzen ditu, aldatu dena bakarrik igotzen du - ezagutza fitxategiak, hodeiko fluxuak eta konexio erreferentziak barne - eta bidaltzen duena jakinarazten du.

Adibidea

Exekutatu lan-espazio karpeta barrutik:

pac copilot push

Edo diskoan beste lan-espazio batera zuzendu:

pac copilot push --project-dir contoso-support

Aukerako parametroak copilot push

--project-dir -pd

Proiektuaren direktoriora bidea. Lehenetsitako egungo direktorio funtzionalean jartzen da.

Oharrak

• Sinkronizazio lan-espazio batean exekutatu. Adibidezpull, , push edo pac copilot initedo sortutako pac copilot clone karpeta batean bakarrik funtzionatzen du. Lanerako sinkronizazio metadatuetatik helburu ingurunea irakurtzen du. Ez --environment eztabaidarik.
• Lehenengo tiratu gatazka badago. Elementu bera tokian tokian zein zerbitzarian aldatu bada, push gelditzen da eta berriro saiatu aurretik exekutatzeko pac copilot pull eskatzen dizu. Prozesu honek bultzada bat isilean zerbitzari aldean ikusi ez zenuen aldaketa bat gainidaztea saihesten du.
• Tokiko aldaketarik ez izatea no-opda. Push-ek ez badu ezer bidaltzeko, hori jakinarazten du eta ingurunea ukitu gabe irteten da.
• Bultzada arrakastatsu batek agente bizia mutatzen du helburu ingurunean.
• Lehenengo saioa hasi .pac auth create

pac copilot quarantine

Kopilotu-agentearen berrogeialdi-egoera.

Beharrezko parametroak honako copilot quarantine

--bot-id -id

Berrogeialdia egiteko / berrogeialdia kentzeko kopilotuaren IDa.

Aukerako parametroak copilot quarantine

--environment -env

Ingurunea (IDa, erakundearen IDa, URLa, izen esklusiboa edo izen partziala).

--status -s

Berrogeialdiko egoeraren balioa. true = berrogeialdia, false = unquarantine. Lehenespenez egia da.

Parametro honek ez du baliorik behar. Aldaketa bat da.

pac copilot status

Aztertu zehaztutako kopilotu baten hedapen-egoera uneko edo helburuko Dataverse ingurunean.

Adibidea

Komando honek zehaztutako kopilotu baten hedapen-egoera galdetzen du uneko edo helburuko Dataverse ingurunean.

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

Komandoak honako irteera honela itzultzen du:

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

Beharrezko parametroak honako copilot status

--bot-id -id

Kopilotu baten IDa (Chatbot).

Aukerako parametroak copilot status

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

Sinkronizazio komandoen autentifikazioa eta ingurunea

clone, pull, push, eta init --environment komandoek Dataverse ingurune batekin hitz egiten dute, beraz, autentifikazio profil bat behar dute. Lehenengo saioa hasi .pac auth create

• clone, pull, eta push profil aktibo bat behar dute. pac copilot init Bat bakarrik behar du gainditzen --environmentduzunean; gabe, init eskailera fitxategiak tokian bertan jartzen ditu eta ez du saioa hasi behar.
• pull eta push lan-ingurunearen sinkronizazio metadatuetatik helburu-ingurunea irakurri, eztabaidarik hartu ez --environment dezaten. clone Eta init egin.
• pac copilot pack Erabat tokikoa da. Fitxategiak soilik irakurtzen eta idazten ditu, beraz, ez du autentifikaziorik edo ingurunerik behar.

pulleta push soilik lan egiten dute edo initedo sortutako clone lan-eremu batean. Lan-espazioa sortzen denean idatzitako sinkronizazio metadatuek esaten diete zein agente eta ingurunearekin hitz egin behar duten, beraz, beste edozein lekutan exekutatzea azkar huts egiten du "lan-espazioa aurkitu gabe" errorearekin.

Ikusi ere

Microsoft Power Platform CLI komando-taldeak
Microsoft Power Platform CLI ikuspegi orokorra