pac copilot

Työkalut ja apuohjelmat copilot-hallintaan.

Commands

Command Description
pac copilot create Luo uuden copilot-kohteen käyttämällä olemassa olevaa mallitiedostoa viitteenä.
pac copilot extract-template Poimii mallitiedoston ympäristössä aiemmin luodusta copilotista.
pac copilot extract-translation Poimii tiedoston, joka sisältää lokalisoitua sisältöä yhdelle tai useammalle botille.
pac copilot init-skills Poimi Copilot-taitomääritelmätiedostot nykyiseen hakemistoon.
pac copilot list Luettelo copiloteista nykyisessä tai kohde-Dataverse-ympäristössä.
pac copilot mcp Paikallisen MCP-palvelimen (Model Context Protocol) tiedot.
pac copilot merge-translation Yhdistä tiedostoja, jotka sisältävät lokalisoitua sisältöä yhdelle tai useammalle botille.
pac copilot model list AI Builder -mallit nykyisessä ympäristössä.
pac copilot model predict Lähettää tekstin tai kehotteen tekoälymalliin
pac copilot model prepare-fetch Ottaa FetchXML-tiedoston AI Large Language Modelista (LLM) ja valmistelee sen suorittamista varten nykyisessä ympäristössä.
pac copilot publish Mukautetun copilotin julkaiseminen
pac copilot quarantine Kopilottiagentin karanteenitila.
pac copilot status Kyselyn kohdistaminen määritetyn copilot-kohteen käyttöönottotilaan nykyisessä tai kohde-Dataverse-ympäristössä.

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 extract-template

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

Example

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.

Example

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-skills

Poimi Copilot-taitomääritelmätiedostot nykyiseen hakemistoon.

Valinnaiset parametrit parametrille copilot init-skills

--output -o

Osaamistiedostojen tuloskansio. Default: .github/skills

--skills -s

Pilkuin eroteltu luettelo kopioitavista taitojen nimistä (ylimmän tason nimistä), esim. järjestelmänvalvoja, todennus. Oletus: kaikki taidot.

pac copilot list

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

Example

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.

Example

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.

Remarks

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.

Example

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 errors

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ä.

Example

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 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 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ä.

Example

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.

See also

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

  • Last updated on