Jaa


Asenna Copilot Studio Kit

Copilot Studio Kit on avoimen lähdekoodin työkalupaketti Copilot Studio-agenttien testaukseen ja arviointiin. Se auttaa esimerkiksi määrittämään testitapauksia, simuloimaan käyttäjäkyselyitä ja vahvistamaan agenttivastaukset. Tässä artikkelissa on vaiheittaiset ohjeet paketin asentamiseen MarketplaceorGitHub sekä käyttöönoton jälkeiset vaiheet ja määritysasetukset.

Note

Varmista ennen Copilot Studio Paketin lataamista ja asentamista, että täytät kaikki edeilöt.

Copilot Studio Kitin asentaminen Marketplacesta

Jos haluat asentaa GitHub 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 -kohtaan 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 Paketin 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:stä

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 versiohallinnoidusta ratkaisusta Power CAT Copilot Studio Kitille.

Asenna hallittu CopilotStudioKit-tiedosto

Hallitun Copilot Studio Kit -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 Kit.
  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 Kitin, saatat kohdata seuraavan virheilmoituksen: Solution "Power CAT Copilot Studio Kit" epäonnistui tuonnissa: ImportAsHolding epäonnistui poikkeuksella: määritettä ei voi poistaa: cat_copilottestrunid entiteetistä: cat_CopilotTestRun koska määrite ei ole mukautettu field.

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, jonka avulla voidaan määrittää yhteysviittauksia, ympäristömuuttujia ja pilvipalvelutyönkulkuja. 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 lähde-SharPoint-sivustoon. Osoita Dataversen URL-osoite Dataverse-esiintymään mukautetuille kohdeagentille, joissa sisältö synkronoidaan.

Voit suorittaa seuraavat vaiheet tai käyttää Asennuksen ohjattua toimintoa SharePoint-yhteysviittauksen määrittämiseen.

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 yhteysviittaus Copilot Studio Kit – SharePoint 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 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 yhteysviittaus Copilot Studio Kit – Dataverse 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, Configure SharePoint synkronointi ennen liittyvien työnkulkujen käyttöönottoa (nimet alkavat SharePoint Synkronointi).

Jos haluat ottaa Copilot Studio Kitiin sisältyvät pilvityönkulut käyttöön, ei toimi seuraavasti 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 alatason alatasoon.
    2. Työnkulut, jotka päättyvät alatasoon.
    3. Muut työnkulut tarpeen mukaan missä tahansa järjestyksessä.

Yhteensopivuuskeskuksen määrittäminen

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

Noudata näitä vaiheita 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.

Lue lisätietoja agenttien määrittämisestä Copilot Studio Kit mukaan lukien siitä, miten voit määrittämällä uuden agentin keskustelun suorituskykyilmaisimia varten.

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 .

Jaa Copilot Studio Kit -sovellus

Kun sovellus käynnistyy onnistuneesti, Paketin asentaneen omistajan (tai järjestelmänvalvojan) on jaettava Copilot Studio Kit -sovellus tiimille.

  1. Kirjaudu sisään kohtaan Power Apps.
  2. Valitse Sovellukset.
  3. Hae "Copilot Studio Kit" ja etsi se, jonka tyyppi on Code (ei mallipohjainen sovellus).
  4. Valitse kolme pistettä (...) ja valitse sitten Jaa sovelluksen nimen vierestä.
  5. Etsi ja lisää käyttäjät tai käyttöoikeusryhmät, jotka tarvitsevat käyttöoikeuden.
  6. Vahvista valitsemalla Jaa .

Lisätietoja on artikkelissa Pohjaan perustuvan sovelluksen jakaminen organisaatiosi kanssa.

Seuraava vaihe