Jaa


Copilot Studio Kitin asentaminen

Copilot Studio Kit on avoimen lähdekoodin työkalupaketti Copilot Studio -agenttien testaukseen ja arviointiin. Sen avulla voit esimerkiksi määrittää testitapauksia, simuloida käyttäjien kyselyitä ja vahvistaa agenttivastauksia. Tässä artikkelissa on vaiheittaiset ohjeet paketin asentamiseen MarketplaceorGitHub sekä käyttöönoton jälkeiset vaiheet ja määritysasetukset.

Note

Ennen kuin lataat ja asennat Copilot Studio Kitin, varmista, että kaikki prerequisites täyttyvät.

Copilot Studio Kitin asentaminen Marketplacesta

Jos haluat asentaa GitHub:stä Copilot Studio Kitin, siirry kohtaan Install Copilot Studio Kit kohteesta GitHub.

Käyttöönotto Marketplace-palvelusta

Jos haluat ottaa Copilot Studio Kitin käyttöön Marketplacesta, toimi seuraavasti:

  1. Siirry Copilot Studio Kit -pakettiin Marketplace.
  2. Valitse Hanki se nyt.
  3. Kirjaudu tarvittaessa sisään.
  4. Valitse Install Copilot Studio Kit -näkymässä ympäristö, jossa haluat ottaa Copilot Studio Kitin käyttöön.
  5. Tarkista ehdot ja lausunnot. Jos hyväksyt ne, valitse ruudut ja valitse Asenna.

Copilot Studio Kitin asennus alkaa.

Käyttöönoton jälkeiset vaiheet (Marketplace)

Kun asennus on valmis, toimi seuraavasti käyttöönoton jälkeen:

  1. Kirjaudu sisään kohtaan Power Apps.
  2. Valitse Ratkaisut.
  3. Valitse Oletusratkaisu.
  4. Valitse Yhteysviittaukset.
  5. Etsi Copilot Studio Kit – Dataverse ja avaa se muokkaamista varten.
  6. Varmista, että kaikki pakolliset kentät on täytetty ja että valittu yhteys on kelvollinen. Luo uusi yhteys Dataverseen tarvittaessa.
  7. Valitse Tallenna.
  8. Seuraa lisä- ja valinnaisia määritysvaiheita.

Copilot Studio Kitin asentaminen GitHub

Näiden ohjeiden avulla voit asentaa GitHub Copilot Studio Kitin. Jos haluat asentaa sovelluksen Marketplacesta, siirry osoitteeseen Install Copilot Studio Kit Marketplacesta.

Lataa uusin GitHub versio

Lataa uusin versiohallitusta Power CAT Copilot Studio Kit -ratkaisusta.

Asenna hallittu CopilotStudioKit-tiedosto

Copilot Studio Kitin hallitun ratkaisun asentaminen:

  1. Kirjaudu sisään kohtaan Power Apps.
  2. Valitse ympäristö, johon haluat asentaa Copilot Studio Kitin.
  3. Valitse Ratkaisut.
  4. Valitse Tuo ratkaisu.
  5. Valitse Selaa.
  6. Valitse CopilotStudioKit*-_managed.zip tiedosto.
  7. Valitse Seuraava.
  8. Kun olet tarkistanut ratkaisun tiedot, valitse Seuraava.
  9. Luo pyydettäessä tarvittavat yhteydet ja valitse Tuo.
  10. Jätä keskustelun suorituskykyilmaisimien raporttiarvot as-is toistaiseksi. Voit päivittää nämä arvot myöhemmin.
  11. Odota, että tuontitoiminto päättyy.

Päivitä olemassa oleva ratkaisu (GitHub)

Jos olet asentanut Copilot Studio Kitin aiemman version ja haluat päivittää uusimpaan versioon, toimi seuraavasti:

  1. Kirjaudu sisään kohtaan Power Apps.
  2. Valitse ympäristö, johon haluat päivittää Copilot Studio Kitin.
  3. Valitse Ratkaisut.
  4. Valitse Tuo ratkaisu.
  5. Valitse Selaa.
  6. Valitse CopilotStudioKit*_managed.zip.
  7. Valitse Seuraava. Power Apps tunnistaa, että tämä päivitys on olemassa oleva hallittu ratkaisu.
  8. Vahvista, että haluat päivittää olemassa olevan ratkaisun valitsemalla Seuraava.
  9. Jätä keskustelun suorituskykyilmaisimien raporttiarvot as-is toistaiseksi. Voit päivittää nämä arvot myöhemmin.
  10. Valitse Tuo.

Note

Kun päivität Copilot Studio Kit -sarjan, saatat kohdata seuraavan virheilmoituksen: Ratkaisun "Power CAT Copilot Studio Kit" tuominen epäonnistui: ImportAsHolding epäonnistui poikkeuksena: määritettä ei voi poistaa: cat_copilottestrunid entiteetistä: cat_CopilotTestRun, koska määrite ei ole mukautettu kenttä.

Tämä ongelma on tunnettu ja tutkittavana. Voit kiertää ongelman järjestämällä päivityksen ennen sen käyttöä. Lue lisätietoja kohdasta Ratkaisun päivittäminen tai päivittäminen.

Lisämääritysvaiheet ja valinnaiset määritysvaiheet

Nämä määritysvaiheet koskevat sitä, oletko asentanut Copilot Studio Kitin Marketplacesta vai GitHub.

Vihje

Copilot Studio Kit sisältää ohjatun asennustoiminnon yhteysviittausten, ympäristömuuttujien ja pilvipalvelutyönkulkujen määrittämiseksi. Lue lisää Setup Wizardin käytöstä.

SharePoint synkronoinnin määrittäminen

Seuraavat vaiheet ovat valinnaisia ja pakollisia vain, jos aiot käyttää SharePoint-synkronointiominaisuutta. Voit määrittää nämä arvot milloin tahansa ennen ominaisuuden käyttöä.

Ohjaa yhteys SharePointin lähdesivustoon. Osoita Dataversen URL-osoite Dataverse-esiintymään mukautetuille kohdeagentille, joissa sisältö synkronoidaan.

Voit suorittaa seuraavat vaiheet tai käyttää Asennusvelhoa määrittääksesi SharePoint-yhteysviittauksen.

SharePoint synkronointitoiminnon käyttäminen:

  1. Asenna Copilot Studio Kit, joka kuvattiin aiemmin tässä artikkelissa.
  2. Kirjaudu sisään kohtaan Power Apps.
  3. Valitse Ratkaisut.
  4. Valitse Oletusratkaisu.
  5. Valitse Yhteysviittaukset.
  6. Etsi Copilot Studio Kit – SharePointyhteyden viittaus ja avaa se muokkaamista varten.
  7. Varmista, että kaikki pakolliset kentät on täytetty ja että valittu yhteys on kelvollinen. Luo uusi yhteys SharePoint tarvittaessa.
  8. Valitse Tallenna.

Lisää tietoja: Lue lisätietoja agenttien määrittämisestä Copilot Studio Kit:ssä, mukaan lukien siitä, miten voit määrittää uuden agentin tiedostojen synkronointia varten.

Konfiguroi agenttivarasto

Seuraavat vaiheet ovat valinnaisia ja pakollisia vain, jos aiot käyttää Agenttivarasto-ominaisuutta . Voit määrittää nämä arvot milloin tahansa ennen ominaisuuden käyttöä.

Ratkaisussa olevat yhteysviittaukset ohjaavat agenttien näkyvyyttä. Vaikka voit käyttää muita tilejä, voit näiden käyttöoikeuksien avulla saada täyden näkyvyyden.

  • Copilot Studio Kit – Power Platform for Admins hakee vuokraajan ympäristöluettelon. Edellyttää Power Platform -järjestelmänvalvojatason käyttöoikeuksia.
  • Copilot Studio Kit - Dataverse kerää agenttitiedot ympäristöistä. Edellyttää järjestelmänvalvojatason käyttöoikeuksia kaikkiin ympäristöihin.

Voit seurata näitä vaiheita tai käyttää Setup Wizardia Agent Inventory -yhteysviittausten konfigurointiin.

Agent Inventory -ominaisuuden käyttäminen:

  1. Asenna Copilot Studio Kit, joka kuvattiin aiemmin tässä artikkelissa.
  2. Kirjaudu sisään kohtaan Power Apps.
  3. Valitse Ratkaisut.
  4. Valitse Oletusratkaisu.
  5. Valitse Yhteysviittaukset.
  6. Etsi Copilot Studio Kit – Power Platform for Admins -yhteysviittaus ja avaa se muokkaamista varten.
  7. Varmista, että kaikki pakolliset kentät on täytetty ja että valittu yhteys on kelvollinen.
  8. Valitse Tallenna.
  9. Etsi Copilot Studio Kit - Dataverseyhteyden viittaus ja avaa se muokkaamista varten.
  10. Varmista, että kaikki pakolliset kentät on täytetty ja että valittu yhteys on kelvollinen.
  11. Valitse Tallenna.

Ota käyttötiedot käyttöön

Jos haluat ottaa valinnaiset käyttötiedot käyttöön agenttivarastossa, suorita seuraavat vaiheet:

  1. Varmista, että liitin on HTTP With Microsoft Entra ID (preauthorized) sallittu ympäristössäsi.
  2. Tuo _AgentInventoryUsage*-managed.zip tiedosto Power CAT Copilot Studio Kit GitHub -säilöstä.
  3. Luo tuontiprosessin aikana yhteys käyttöoikeusisännän URL-osoitteen avulla: https://licensing.powerplatform.microsoft.com/

Screenshot, jossa näkyy käyttöoikeusisännän URL-osoitteen määrittäminen HTTP:n perusresurssin URL-osoitteena Microsoft Entra ID connector.

Työnkulkujen käyttöönotto

Note

Jos aiot käyttää SharePoint-synkronointia, määritä SharePoint-synkronointi ennen liittyvien työnkulkujen käyttöönottoa (nimet alkavat SharePoint-synkronoinnilla).

Jos haluat ottaa Copilot Studio Kitiin sisältyvät pilvityönkulut käyttöön, täydennä seuraavat vaiheet tai käytä ohjattua Setup-toimintoa.

  1. Asenna Copilot Studio Kit, joka kuvattiin aiemmin tässä artikkelissa.
  2. Kirjaudu sisään kohtaan Power Automate.
  3. Varmista, että ympäristö, jossa on Copilot Studio Kit, on valittuna.
  4. Valitse Ratkaisut.
  5. Valitse Copilot Studio Kit.
  6. Valitse Pilvityönkulut.
  7. Varmista, että kaikki työnkulut ovat käytössä (Tila = Käytössä).
  8. Aktivoi työnkulut, jotka eivät ole käytössä, seuraavassa järjestyksessä:
    1. Työnkulut, jotka päättyvät lapsenlapsiin.
    2. Työnkulut, jotka päättyvät Lapsi.
    3. Muut työnkulut tarpeen mukaan missä tahansa järjestyksessä.

Perusta Compliance Hub

Määritä Compliance Hub noudattamalla kohdan Asenna ja määritä Copilot Studio Kit -yhteensopivuuskeskus ohjeita. Compliance Hub vaatii agenttien inventaarion.

Upotetun keskustelun suorituskykyilmaisimen koontinäytön määrittäminen

Nämä vaiheet vaaditaan vain, jos aiot käyttää upotetun keskustelun suorituskykyilmaisimien koontinäyttöä.

Huomioi seuraavat arvot vaiheiden aikana:

  • Työtilan nimi
  • Työtilan GUID
  • Raportin nimi
  • Raportti-GUID

Julkaise raportti

Keskusteluiden suorituskykyilmaisinraportin julkaiseminen:

  1. Asenna Copilot Studio Kit, joka kuvattiin aiemmin tässä artikkelissa.

  2. Lataa Conversation.KPIs.zipPower CAT Copilot Studio Kit GitHub -säilöstä.

  3. Pura .zip tiedoston sisältö.

  4. Avaa Conversation KPIs.pbit -tiedosto Power BI Desktop -sovelluksessa.

  5. Anna Dataversen URL-osoite ympäristön URL-osoitteena avautuvassa valintaikkunassa ja valitse Lataa (esimerkiksi org3c23948.crm.dynamics.comilman https:// etuliitettä).

    Jos valintaikkuna ei tule näkyviin, syötä ympäristön URL-osoiteHome>Transform data>Edit -parametreihin.

  6. Päivitä tiedot ja kirjaudu sisään tarpeen mukaan.

  7. Tallenna ja julkaise työtilaan.

  8. Kirjaa muistiin Raportin nimi ja Työtilan nimi.

  9. Kirjaudu sisään kohtaan Power BI.

  10. Avaa julkaisemasi raportti ja kirjoita muistiin työtilan GUID-tunnus ja raportin GUID-tunnus URL-osoitteessa.

    Jos julkaiset oman työtilan, työtilan GUID-tunnus on 00000000-0000-0000-0000-000000000000.

  11. Valitse kolme pistettä (...) ja sitten Näytä semanttinen malli.

  12. Avaa Tiedostoasetukset>.

  13. Tarkista, että Tietolähteen tunnistetiedoissa ei ole ongelmia. Voit korjata mahdolliset ongelmat kirjautumaan sisään.

  14. Siirry Päivitä-kohtaan ja määritä päivitysaikataulu.

Päivitä raporttiympäristömuuttuja

Jos haluat määrittää upotetun keskustelun suorituskykyilmaisimien koontinäytön, päivitä aiheeseen liittyvä ympäristömuuttuja oikeilla tunnisteilla. Voit joko seurata näitä ohjeita tai käyttää Setup Wizardia.

  1. Kirjaudu sisään Power Apps ja valitse ympäristö, johon asensit Copilot Studio Kitin.
  2. Valitse Ratkaisut>Oletusratkaisu.
  3. Valitse Ympäristömuuttujat.
  4. Etsi ja valitse Keskustelu KPI -raportti.
  5. Korvaa Oletusarvo-kohdan paikkamerkit työtilan nimellä, työtilan GUID-tunnuksilla, raportin nimellä ja raportin GUID-arvoilla , jotka merkitsit muistiin julkaisuprosessin aikana.
  6. Valitse Tallenna.

Lisää tietoja: Lue lisätietoja agenttien määrittämisestä Copilot Studio Kit mukaan lukien siitä, miten voit määrittämällä uuden agentin Conversation KPIs -palvelulle.

Copilot Studio Kit -sovelluksen käyttäminen

Copilot Studio Kit -sovelluksen käyttäminen:

  1. Kirjaudu sisään Power Apps ja valitse ympäristö, johon asensit Copilot Studio Kitin.
  2. Siirry sovelluksiin.
  3. Etsi ja valitse Power CAT Copilot Studio Kit.
  4. Valitse Toista.
  5. (Valinnainen) Lisää sovellus kirjanmerkkeihin .

Seuraava vaihe