Jaa


pac copilot

Työkalut ja apuohjelmat copilot-hallintaan

Komennot

Komento Kuvaus
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 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 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.

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

Huomautukset

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

Katso myös

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