pac copilot

Työkalut ja apuohjelmat copilot-hallintaan.

-init, clone-, pull-, push- ja pack -komentojen avulla voit pitää Copilot Studio agentin levyllä olevien tiedostojen joukkona, muokata sitä paikallisesti ja synkronoida sen Dataverse-ympäristöön.

Tyypillinen silmukka näyttää tältä:

1. Käynnistä työtila. Rakenne: upouusi agentti palvelulla pac copilot init, tai lataa olemassa oleva palvelu palvelulla pac copilot clone. Kummassakin tapauksessa saat paikallisen työtilan, joka sisältää synkronoinnin metatiedot, joista muut komennot ovat riippuvaisia.
2. Hae ennen muokkaamista. pac copilot pull tuo etämuutokset alaspäin ja yhdistää ne paikallisiin tiedostoihisi, joten aloitat nykyisestä palvelintilasta.
3. Työnnä, kun olet valmis. pac copilot push lähettää paikalliset muutokset takaisin. Jos samaa kohdetta tällä välin muutetaan palvelimessa, työnnä pysäytykset ja pyydä sinua vetämään ensin.
4. Paketti käyttöönottoa varten. pac copilot pack muuttaa työtilan ratkaisuksi .zip , jonka voit ottaa käyttöön :n avulla pac solution import.

Kun haluat siirtyä yksittäisessä vaiheessa tyhjästä reaaliaikaiseksi agentiksi, pac copilot init --environment voit luoda rakenneita, paketteja, tuoda työtilan ja yhdistää sen puolestasi. Yksittäisten komentojen avulla voit ajaa silmukan jokaista osaa yksinään.

Komennot

pac copilot clone

Kloonaa Copilot Studio agentti paikalliseen työtilahakemistoon.

pac copilot clonelataa olemassa olevan Copilot Studio -agentin paikalliseen työtilahakemistoon sekä synkronoi metatiedot, joista pac copilot pull ja luotatpac copilot push. Agentin tiedostot kirjoitetaan alikansioon, joka on nimetty sen näyttönimen mukaan.

Esimerkki

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

Pakolliset parametrit parametrille copilot clone

--bot -id

Copilot-tunnuksen tai rakenteen nimi (yksilöivä nimi botin tiedoista tai tiedostonimestä ratkaisunhallinnassa).

Valinnaiset parametrit parametrille copilot clone

--component-collection -cc

Kloonataksesi osakokoelman tunnuksen. Toista useille.

--display-name -dn

Agentin näyttönimi (käytetään kansion nimeämiseen).

--environment -env

Määrittää Dataverse-kohdetaulukon. Arvo voi olla GUID-tunnus tai absoluuttinen https-URL-osoite. Kun tätä ei määritetä, käytetään aktiiviseen organisaatioon, joka on valittu nykyiseen todennusprofiiliin.

--output-dir -od

Kloonaa tulosteen juurikansio. Oletusarvo on nykyinen hakemisto.

Huomautuksia

• --bothyväksyy Copilot tunnuksen tai rakenteen nimen. Anna joko Copilot tunnus (GUID) tai agentin rakenteen nimi. Komento ratkaisee rakenteen nimen suhteessa kohdeympäristöön.
• Kohde-alikansion on oltava tyhjä. Kloonaa kirjoittaa kansioon, joka on nimetty agentin (sanitized) näyttönimen mukaan kohdassa --output-dir. Jos tämä kansio sisältää jo tiedostoja, kloonaaminen ei korvaa niitä. Käytä tätä --display-name , jos haluat valita eri kansion nimen.
• Osakokoelmien kloonaus. Jos haluat tuoda komponenttikokoelmat alas agentin rinnalle, siirrä vähintään yksi kokoelmatunnus, jossa --component-collectionon , puolipisteillä eroteltuna.
• Kloonaaminen edellyttää todennettua profiilia (pac auth create) ja ympäristön ratkaisee kohteen tai aktiivisen profiilin organisaatiosta --environment, kun se jätetään pois.

pac copilot create

Luo uuden copilot-kohteen käyttämällä olemassa olevaa mallitiedostoa viitteenä.

Pakolliset parametrit parametrille copilot create

--displayName

Uuden copilotin näyttönimi

--schemaName

Uuden copilotin rakenteen nimi (yksilöivä nimi).

--solution -s

Ratkaisun nimi.

--templateFileName

Lähde yaml-tiedosto, joka sisältää copilot-mallin, joka on poimittu käyttämällä poimintamalli-komentoa.

Valinnaiset parametrit parametrille copilot create

--environment -env

Määrittää Dataverse-kohdetaulukon. Arvo voi olla GUID-tunnus tai absoluuttinen https-URL-osoite. Kun tätä ei määritetä, käytetään aktiiviseen organisaatioon, joka on valittu nykyiseen todennusprofiiliin.

pac copilot delete

Poista mukautettu Copilot.

Pakolliset parametrit parametrille copilot delete

--bot -id

Copilot-tunnuksen tai rakenteen nimi (yksilöivä nimi botin tiedoista tai tiedostonimestä ratkaisunhallinnassa).

Valinnaiset parametrit parametrille copilot delete

--confirm -y

Vaaditaan copilot-kohteen poistamisen vahvistamista varten.

Tämä parametri ei vaadi arvoa. Se on valitsin.

--environment -env

Määrittää Dataverse-kohdetaulukon. Arvo voi olla GUID-tunnus tai absoluuttinen https-URL-osoite. Kun tätä ei määritetä, käytetään aktiiviseen organisaatioon, joka on valittu nykyiseen todennusprofiiliin.

pac copilot extract-template

Poimii mallitiedoston ympäristössä aiemmin luodusta copilotista.

Esimerkki

Tämä komento poimii mallitiedoston aiemmin luodusta copilotista ympäristössä.

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

Komento palauttaa copilotille seuraavankaltaiset tulokset englannin ja saksan kielillä:

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

Pakolliset parametrit parametrille copilot extract-template

--bot -id

Copilot-tunnuksen tai rakenteen nimi (yksilöivä nimi botin tiedoista tai tiedostonimestä ratkaisunhallinnassa).

--templateFileName

Sen yaml-tiedoston sijainti, jonne copilot-malli kirjoitettava.

Valinnaiset parametrit parametrille copilot extract-template

--environment -env

Määrittää Dataverse-kohdetaulukon. Arvo voi olla GUID-tunnus tai absoluuttinen https-URL-osoite. Kun tätä ei määritetä, käytetään aktiiviseen organisaatioon, joka on valittu nykyiseen todennusprofiiliin.

--overwrite -o

Salli tulostetietotiedoston korvaaminen, jos se on jo olemassa.

Tämä parametri ei vaadi arvoa. Se on valitsin.

--templateName

Mallin nimi tai kickStartTemplate, jos nimeä ei ole määritetty.

--templateVersion

Malliversio X.X.X-muodossa tai 1.0.0, jos versiota ei ole määritetty.

pac copilot extract-translation

Poimii tiedoston, joka sisältää lokalisoitua sisältöä yhdelle tai useammalle botille.

Esimerkki

Tämä komento purkaa tiedoston, joka sisältää lokalisoitua sisältöä yhdelle tai useammalle copilotille.

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

Komento palauttaa seuraavankaltaiset tulokset:

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

Valinnaiset parametrit parametrille copilot extract-translation

--all -a

Kirjoita lokalisointitiedostot kaikille tuetuille kielille. Oletusarvoisesti vain ensisijainen kieli kirjoitetaan.

Tämä parametri ei vaadi arvoa. Se on valitsin.

--bot -id

Copilot-tunnuksen tai rakenteen nimi (yksilöivä nimi botin tiedoista tai tiedostonimestä ratkaisunhallinnassa).

--environment -env

Määrittää Dataverse-kohdetaulukon. Arvo voi olla GUID-tunnus tai absoluuttinen https-URL-osoite. Kun tätä ei määritetä, käytetään aktiiviseen organisaatioon, joka on valittu nykyiseen todennusprofiiliin.

--format

Tiedostomuoto, johon kirjoitettavat lokalisoidut tiedostot, joko 'resx' tai 'json'. Oletusarvo on resx.

--outdir

Tuloshakemisto, jota haluat kirjoittaa.

--overwrite -o

Salli tulostetietotiedoston korvaaminen, jos se on jo olemassa.

Tämä parametri ei vaadi arvoa. Se on valitsin.

--sourcedir -src

Lähderatkaisun hakemisto. Kun tämä on määritetty, se ohittaa yhdistetyn ympäristön etsiessään botteja ja etsii sen sijaan sisältöä ratkaisukansiosta.

pac copilot init

Luo mallista uusi Copilot Studio agenttityötila.

pac copilot initskaalaa uuden Copilot Studio agenttityötilan mallista. Se toimii kahdessa tilassa, ja sen mukanaolo --environment päättää, mitä tilaa käytetään:

• Paikallinen rakenne – ei --environment. Kirjoittaa mallitiedostot projektihakemistoon ja pysähtyy. Komento ei luo mitään Dataversessa eikä vaadi kirjautumista. Käytä tätä tilaa, kun haluat luoda paikallisesti ja muodostaa yhteyden ympäristöön myöhemmin.
• Bootstrap – --environment annettu. Skaalaa tiedostot, pakkaa ne ratkaisuksi, tuo kyseisen ratkaisun ympäristöön ja yhdistää työtilan uuteen luotuun agenttiin. Tämä tila on yksivaiheinen polku tyhjästä reaaliaikaiseen, synkronoituun agenttiin, ja se edellyttää todennettua profiilia.

Esimerkkejä

Työtilan paikallinen rakenne:

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

Rakenne ja reaaliaikaisen agentin käynnistys ympäristössä yhdessä vaiheessa:

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

Skaalaa CLI-tekijän (CliCopilot) agentti tiettyyn kansioon:

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

Pakolliset parametrit parametrille copilot init

--name -n

Agentin näyttönimi.

--publisher-prefix -pp

Publisher ratkaisun mukautusetuliitteen.

Valinnaiset parametrit parametrille copilot init

--authoring-mode -am

Agentti, joka luo muotoa rakennekansioon (oletus: perinteinen). Käytä cli-copilot-komentoa komentorivikäyttöliittymän luoman CliCopilot-agentin skaalaamiseen.

--environment -env

Määrittää Dataverse-kohdetaulukon. Arvo voi olla GUID-tunnus tai absoluuttinen https-URL-osoite. Kun tätä ei määritetä, käytetään aktiiviseen organisaatioon, joka on valittu nykyiseen todennusprofiiliin.

--instructions -ins

Agenttijärjestelmän ohjeet.

--project-dir -pd

Agentin työtilan kohdehakemisto. Oletusarvo on nykyinen hakemisto.

--schema-name -sn

Agentin koko rakenteen nimi. Ohittaa oletus johdetun kohteen ({publisher-prefix}_{sanitized-name}). Käytetty as-is muokkaamatta.

--template -t

Malliprofiilin nimi (oletus, minimaalinen). Oletusarvo on "default".

Huomautuksia

• Projektihakemiston on oltava tyhjä. init ei rakennetta olemassa olevien tiedostojen päälle, joten osoita --project-dir uuteen tai tyhjään kansioon.
• Rakenteen nimi johdetaan. Kun poistat --schema-namekohteen , agentin rakenteen nimeksi {publisher-prefix}_{sanitized-name}luodaan . Siirrä --schema-name määrittämään se eksplisiittisesti; arvoa käytetään as-is.
• Bootstrap toimii molemmissa luontitiloissa. init --environment käynnistää reaaliaikaisen agentin yhdessä vaiheessa oletusarvoista perinteistä tilaa varten ja lle --authoring-mode cli-copilot. Vaihtoehtona CliCopilot-agentille voit luoda rakennealueen paikallisesti (ei--environment), jonka jälkeen voit ottaa sen käyttöön itse suorittamalla pac solution importpac copilot pack sen.
• Bootstrap luo palvelinpuolen objekteja. Tuo käynnistystilassa init ratkaisun ja luo agentin kohdeympäristöön. Jos agentti, jolla on sama rakenteen nimi, on jo olemassa, init pysähtyy ja osoittaa sinua muodostamaan pac copilot clone yhteyden olemassa olevaan agenttiin.
• Uusi ympäristö voi hyväksyä ensimmäisen tuonnin hitaasti. Juuri luodun ympäristön lämmittely saattaa kestää minuutin tai pari. Varhainen käynnistys voi epäonnistua, kun Asynkroniset toiminnot ovat tällä hetkellä poissa käytöstä tälle organisaatiolle. Odota hetki ja suorita se uudelleen.
• --template (default tai minimal) koskee vain perinteistä luontitilaa.

pac copilot list

Luettelo copiloteista nykyisessä tai kohde-Dataverse-ympäristössä.

Esimerkki

Tässä komennossa luetellaan kaikki nykyisen tai kohteena olevan Dataverse-ympäristön copilotit.

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

Komento palauttaa seuraavankaltaiset tulokset:

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

Valinnaiset parametrit parametrille copilot list

--environment -env

Määrittää Dataverse-kohdetaulukon. Arvo voi olla GUID-tunnus tai absoluuttinen https-URL-osoite. Kun tätä ei määritetä, käytetään aktiiviseen organisaatioon, joka on valittu nykyiseen todennusprofiiliin.

pac copilot mcp

Paikallisen MCP-palvelimen (Model Context Protocol) tiedot.

Esimerkki

pac copilot mcp --run

Valinnaiset parametrit parametrille copilot mcp

--run -r

Suorita paikallinen MCP-palvelin (mallin kontekstiprotokolla).

Tämä parametri ei vaadi arvoa. Se on valitsin.

Huomautuksia

Opi käyttämään Power Platform CLI:tä sisäänrakennetun MCP-palvelimen kanssa

pac copilot merge-translation

Yhdistä tiedostoja, jotka sisältävät lokalisoitua sisältöä yhdelle tai useammalle botille.

Esimerkki

Tämä komento yhdistää tiedostot, jotka sisältävät lokalisoitua sisältöä yhdelle tai useammalle copilotille.

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

Komento palauttaa seuraavankaltaiset tulokset saksan kieltä päivitettäessä:

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.

Lue lisätietoja virheiden hallinnasta merge-translation-komennolla

Valinnaiset parametrit parametrille copilot merge-translation

--environment -env

Määrittää Dataverse-kohdetaulukon. Arvo voi olla GUID-tunnus tai absoluuttinen https-URL-osoite. Kun tätä ei määritetä, käytetään aktiiviseen organisaatioon, joka on valittu nykyiseen todennusprofiiliin.

--file -f

Luettelo tiedostoista, jotka sisältävät käännöksiä. Glob-kuvioita tuetaan.

--solution -s

Ratkaisun nimi.

--sourcedir -src

Lähderatkaisun hakemisto. Kun tämä on määritetty, se ohittaa yhdistetyn ympäristön etsiessään botteja ja etsii sen sijaan sisältöä ratkaisukansiosta.

--verbose

Tuottaa lisää diagnostiikkatietoja tietojen tuonnin ja viennin aikana

Tämä parametri ei vaadi arvoa. Se on valitsin.

--whatif

Ei suorita komentoa, mutta tulostaa tiedot siitä, mitä tapahtuu.

Tämä parametri ei vaadi arvoa. Se on valitsin.

merge-translation-virheet

Edellä olevan esimerkin perusteella tulos näyttää seuraavalta, jos tiedostossa, jota käytetään copilot-päivityksenä, on olemassa yksi virhe:

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.

- --verbose merkintä lisää virheen tiedot:

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 -mallit nykyisessä ympäristössä.

Esimerkki

Tässä komennossa luetellaan kaikki AI Builder -mallit.

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

Komento palauttaa seuraavankaltaiset tulokset:

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

Valinnaiset parametrit parametrille copilot model list

--environment -env

Määrittää Dataverse-kohdetaulukon. Arvo voi olla GUID-tunnus tai absoluuttinen https-URL-osoite. Kun tätä ei määritetä, käytetään aktiiviseen organisaatioon, joka on valittu nykyiseen todennusprofiiliin.

pac copilot model predict

Lähettää tekstin tai kehotteen tekoälymalliin

Valinnaiset parametrit parametrille copilot model predict

--environment -env

Määrittää Dataverse-kohdetaulukon. Arvo voi olla GUID-tunnus tai absoluuttinen https-URL-osoite. Kun tätä ei määritetä, käytetään aktiiviseen organisaatioon, joka on valittu nykyiseen todennusprofiiliin.

--model-id -id

AI Builder -mallin tunnus

--model-name -n

Tekoälymallin täydellinen tai osittainen nimi

--prompt -p

Kehote lähettää tekoälymalliin

--text -t

Tekoälymalliin lähetettävä teksti

pac copilot model prepare-fetch

Ottaa FetchXML-tiedoston AI Large Language Modelista (LLM) ja valmistelee sen suorittamista varten nykyisessä ympäristössä.

Pakolliset parametrit parametrille copilot model prepare-fetch

--inputFile -i

Syöte FetchXML-tiedosto, joka on yleensä peräisin AI LLM:stä.

--outputFile -o

Tuloste FetchXML-tiedostosta, joka on valmis suoritettavaksi nykyisessä ympäristössä.

Valinnaiset parametrit parametrille copilot model prepare-fetch

--environment -env

Määrittää Dataverse-kohdetaulukon. Arvo voi olla GUID-tunnus tai absoluuttinen https-URL-osoite. Kun tätä ei määritetä, käytetään aktiiviseen organisaatioon, joka on valittu nykyiseen todennusprofiiliin.

pac copilot pack

Pakkaa Copilot Studio agentin työtila ratkaisun zip-tiedostoon.

pac copilot pack pakkaa agentin työtilan Dataverse-ratkaisuun .zip , jonka voit ottaa käyttöön palvelussa pac solution import. Se on paketointivaiheen itsenäinen muoto, joka pac copilot init --environment suoritetaan puolestasi, joten voit tuottaa käyttöön otettavan ratkaisun erillisenä vaiheena – esimerkiksi koontiputkessa. Se toimii sekä perinteisissä että CLI-luoduissa (CliCopilot) agenttityötiloissa.

Esimerkki

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

Pakolliset parametrit parametrille copilot pack

--publisher-prefix -pp

Publisher ratkaisun mukautusetuliitteen.

Valinnaiset parametrit parametrille copilot pack

--output-path -op

Ratkaisun zip-tiedoston tulospolku. Oletusarvo on nykyinen hakemisto.

--project-dir -pd

Agenttityötilan hakemisto pakettiin. Oletusarvo on nykyinen hakemisto.

--solution-name -sn

Ratkaisun yksilöivä nimi. Jos tämä jätetään pois, se johdetaan agentin rakenteen nimestä.

Huomautuksia

• Se on paikallinen operaatio. Pack lukee työtilan ja kirjoittaa ratkaisun .zip. Se ei tarvitse todentamista eikä ympäristöä, joten sitä voi käyttää koontiputkessa turvallisesti.
• Julkaisijan etuliitteen täytyy olla kelvollinen. --publisher-prefix tulee olla hyvin muodostettu mukautusetuliite, tai paketti lakkaa kirjoittamasta mitään.
• Ratkaisun nimi ja tuloste. Jos poistat --solution-name-merkin, ratkaisun yksilöivä nimi johdetaan agentin rakenteen nimestä. .zip-arvo kirjoitetaan nykyiseen hakemistoon, ellet ole määrittänyt -hakemistoa--output-path.
• Packia ei käytetä. Se tuottaa ratkaisun, mutta ei tuo sitä. Ota agentti käyttöön noudattamalla pac solution import sitä ja jos haluat synkronoidusti yhdistetyn pac copilot clone työtilan sille.

pac copilot publish

Mukautetun copilotin julkaiseminen

Pakolliset parametrit parametrille copilot publish

--bot -id

Copilot-tunnuksen tai rakenteen nimi (yksilöivä nimi botin tiedoista tai tiedostonimestä ratkaisunhallinnassa).

Valinnaiset parametrit parametrille copilot publish

--environment -env

Määrittää Dataverse-kohdetaulukon. Arvo voi olla GUID-tunnus tai absoluuttinen https-URL-osoite. Kun tätä ei määritetä, käytetään aktiiviseen organisaatioon, joka on valittu nykyiseen todennusprofiiliin.

pac copilot pull

Nouda etämuutokset Copilot Studio ja yhdistä paikalliseen työtilaan.

Komento pac copilot pull noutaa agentin nykyisen palvelimen tilan ja yhdistää sen paikalliseen työtilaan käyttämällä kolmisuuntaista yhdistämistä. Tämä prosessi varmistaa, että sekä palvelinpuolen muokkaukset että koskemattomat paikalliset tiedostot säilyvät ennallaan. Suorita se ennen muokkaamisen aloittamista ja suorita se uudelleen, ennen kuin teet muutoksia.

Esimerkki

Suorita komento työtilakansiosta:

pac copilot pull

Voit myös ohjata sen työtilaan muualle levylle:

pac copilot pull --project-dir contoso-support

Valinnaiset parametrit parametrille copilot pull

--project-dir -pd

Projektihakemiston polku. Oletusarvo on nykyinen työhakemisto.

Huomautuksia

• Suorita se synkronointityötilassa. Komento pull toimii vain kansiossa, jonka pac copilot clone on luonut tai pac copilot init. Se lukee kohdeympäristön ja agentin työtilan synkronoinnin metatiedoista, minkä vuoksi argumentteja ei ole --environment . Jos suoritat sen missä tahansa muualla, se epäonnistuu ja sisältää "työtilaa ei löydy" -virheen.
• Se kirjoittaa paikallisiin tiedostoihisi. Pull yhdistää etämuutokset työtilaan ja lataa tietotiedostoja. Vahvista tai varmuuskopioi paikallinen työ, josta välität ennen vetämistä.
• Kirjaudu ensin sisään :lla pac auth create.

pac copilot push

Lähetä paikallisen työtilan muutokset Copilot Studio.

pac copilot push Lähettää paikallisen työtilasi muutokset takaisin Dataversen agentille. Se vertaa tiedostoja viimeksi tunnettuun palvelintilaan, lataa vain sen, mikä on muuttunut , mukaan lukien tietotiedostot, pilvipalvelutyönkulut ja yhteysviittaukset, ja lähettää raportteja siitä, mitä se on lähettänyt.

Esimerkki

Suorita se työtilakansiosta:

pac copilot push

Voit myös ohjata sen työtilaan muualle levylle:

pac copilot push --project-dir contoso-support

Valinnaiset parametrit parametrille copilot push

--project-dir -pd

Projektihakemiston polku. Oletusarvo on nykyinen työhakemisto.

Huomautuksia

• Suorita se synkronointityötilassa. Kuten pull, push toimii vain kansiossa, jonka pac copilot clone on luonut tai pac copilot init. Se lukee kohdeympäristön työtilan synkronoinnin metatiedoista. Ei ole mitään --environment argumenttia.
• Vedä ensin, jos on ristiriita. Jos samaa kohdetta muutetaan sekä paikallisesti että palvelimella, työnnä pysäytys ja pyytää suorittamaan pac copilot pull ennen kuin yrität uudelleen. Tämä prosessi siirtää työnnön siitä, että palvelinpuolen muutosta korvataan automaattisesti, mitä et näe.
• Paikalliset muutokset eivät ole no-op. Jos Push ei löydä mitään lähetettävää, se ilmoittaa siitä ja poistuu koskematta ympäristöön.
• Onnistunut työntö muuntaa reaaliaikaisen agentin kohdeympäristössä.
• Kirjaudu ensin sisään :lla pac auth create.

pac copilot quarantine

Kopilottiagentin karanteenitila.

Pakolliset parametrit parametrille copilot quarantine

--bot-id -id

Kopilotin henkilöllisyys karanteeniin/karanteeniin poistumiseen.

Valinnaiset parametrit parametrille copilot quarantine

--environment -env

Ympäristö (tunnus, organisaation tunnus, URL-osoite, yksilöivä nimi tai osittainen nimi).

--status -s

Karanteenitilan arvo. tosi = karanteeni, epätosi = karanteeniton. Oletusarvo on tosi.

Tämä parametri ei vaadi arvoa. Se on valitsin.

pac copilot status

Kyselyn kohdistaminen määritetyn copilot-kohteen käyttöönottotilaan nykyisessä tai kohde-Dataverse-ympäristössä.

Esimerkki

Tämä komento määrittää määritetyn copilot-kohteen käyttöönottotilan nykyisessä tai kohde-Dataverse-ympäristössä.

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

Komento palauttaa seuraavankaltaiset tulokset:

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

Pakolliset parametrit parametrille copilot status

--bot-id -id

Copilotin (Chatbot) tunnus.

Valinnaiset parametrit parametrille copilot status

--environment -env

Määrittää Dataverse-kohdetaulukon. Arvo voi olla GUID-tunnus tai absoluuttinen https-URL-osoite. Kun tätä ei määritetä, käytetään aktiiviseen organisaatioon, joka on valittu nykyiseen todennusprofiiliin.

Todentaminen ja synkronointikomentojen ympäristö

Kaikki -, pull-clone, push- ja init --environment -komennot puhuvat Dataverse-ympäristöstä, joten he tarvitsevat todennusprofiilin. Kirjaudu ensin sisään :lla pac auth create.

• clone, pullja push edellyttävät aktiivista profiilia. pac copilot init tarvitset vain sellaisen välitettäessä --environment. Ilman sitä init rakennetiedostot paikallisesti eivätkä tarvitse sisäänkirjautumista.
• pull ja push lukea kohdeympäristö työtilan synkronoinnin metatiedoista, jotta ne eivät käytä --environment argumenttia. clone ja init tee.
• pac copilot pack on puhtaasti paikallinen. Se lukee ja kirjoittaa vain tiedostoja, joten se ei tarvitse todennusta eikä ympäristöä.

pull ja push toimia vain työtilassa, jonka on clone luonut tai init. Kun työtila luodaan, kirjoitetut synkronoinnin metatiedot kertovat heille, minkä agentin ja ympäristön kanssa haluat puhua, joten niiden suorittaminen muualle epäonnistuu nopeasti työtilaa ei löydy -virhesanomalla.

Katso myös

Microsoft Power Platform CLI-komentoryhmät
Microsoft Power Platform-komentorivikäyttöliittymän yleiskatsaus