Copilot Agent Kitin asentaminen

Copilot Agent Kit on avoimen lähdekoodin työkalupaketti Copilot Studio -agenttien testaamiseen ja arviointiin. Se auttaa esimerkiksi määrittämään testitapauksia, simuloimaan käyttäjäkyselyitä ja vahvistamaan agenttivastaukset. Tämä artikkeli tarjoaa vaiheittaiset ohjeet Copilot Agent Kitin asentamiseen Marketplacesta tai GitHubista, sekä käyttöönoton jälkeiset vaiheet ja määritysvaihtoehdot.

Note

Ennen kuin lataat ja asennat Copilot Agent Kitin, varmista, että täytät kaikki vaatimukset.

Asenna Copilot Agent Kit Marketplace-palvelusta

Jos haluat asentaa Copilot Agent Kitin GitHubista, ohita tämä ja siirry Copilot Agent Kitin asentaminen GitHubista -osioon.

Käyttöönotto Marketplace-palvelusta

Käyttöönottaaksesi Copilot Agent Kitin Marketplace-palvelusta, noudata seuraavia ohjeita:

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

Copilot Agent Kitin asennus alkaa.

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

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

  1. Kirjaudu Power Appsiin.
  2. Valitse Ratkaisut.
  3. Valitse Oletusratkaisu.
  4. Valitse Yhteysviittaukset.
  5. Etsi Copilot Agent Kit - Dataverse ja avaa se muokkattavaksi.
  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.

Asenna Copilot Agent Kit GitHubin kautta

Seuraa näitä ohjeita Copilot Agent Kitin asentamiseksi GitHubista. Jos haluat asentaa Microsoft Marketplacesta, siirry kohtaan Asenna Copilot Agent Kit Marketplacesta.

Lataa uusin GitHub-julkaisu

Lataa Power CAT Copilot Agent Kitin hallitun ratkaisun uusin versio.

Asenna Copilot Agent Kitin hallittu zip-tiedosto

Copilot Agent Kitin hallitun ratkaisun asentamiseksi:

  1. Kirjaudu Power Appsiin.
  2. Valitse ympäristö, johon haluat asentaa Copilot Agent 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)

Päivittääksesi Copilot Agent Kitin uusimpaan versioon, noudata näitä vaiheita:

  1. Kirjaudu Power Appsiin.
  2. Valitse ympäristö, jossa haluat päivittää Copilot Agent 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

Copilot Agent Kitin päivittäessä saatat kohdata seuraavan virheen: Ratkaisu "Power CAT Copilot Agent Kit" epäonnistui tuontiin: ImportAsHolding epäonnistui poikkeuksella: Ei voi poistaa attribuuttia: cat_copilottestrunid Entity: cat_CopilotTestRun:stä, koska attribuutti 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ä konfigurointivaiheet koskevat sekä Marketplacesta että GitHubista asennettua Copilot Agent Kit -ratkaisua.

Vinkki

Copilot Agent Kit sisältää asetusohjelman, jolla voi määrittää yhteysviitteet, ympäristömuuttujat ja pilvityönkulut. Lue lisää ohjatun asennuksen 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 noudattaa näitä vaiheita tai käyttää Setup-ohjelmaa SharePoint-yhteysviittauksen määrittämiseen.

SharePoint-synkronointitoiminnon käyttäminen:

  1. Asenna Copilot Agent Kit aiemmin tässä artikkelissa kuvatulla tavalla.
  2. Kirjaudu Power Appsiin.
  3. Valitse Ratkaisut.
  4. Valitse Oletusratkaisu.
  5. Valitse Yhteysviittaukset.
  6. Etsi Copilot Agent Kit - SharePoint-yhteysviite ja avaa se muokkausta varten.
  7. Varmista, että kaikki pakolliset kentät on täytetty ja että valittu yhteys on kelvollinen. Luo uusi yhteys SharePointiin tarpeen mukaan.
  8. Valitse Tallenna.

Lisätietoja: Lue lisää agenttien konfiguroinnista Copilot Agent Kitissä, mukaan lukien uuden agentin konfigurointi tiedostojen synkronointiin.

Määritä 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 Agent Kit - Power Platform for Admins hakee listan ympäristöistä vuokralaisessa. Edellyttää Power Platform -järjestelmänvalvojatason käyttöoikeuksia.
  • Copilot Agent Kit – Dataverse kerää agenttitietoa 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.

Kun yhteysviittaukset on asetettu, määrität ympäristön laajuuden, agentityypit, ympäristöryhmät, inventaariovaihtoehdot ja synkronointiaikataulun Agenttivaraston sisältä. Lisätietoja on artikkelissa Agenttivaraston määrittäminen.

Agent Inventory -ominaisuuden käyttäminen:

  1. Asenna Copilot Agent Kit aiemmin tässä artikkelissa kuvatulla tavalla.
  2. Kirjaudu Power Appsiin.
  3. Valitse Ratkaisut.
  4. Valitse Oletusratkaisu.
  5. Valitse Yhteysviittaukset.
  6. Etsi Copilot Agent Kit - Power Platform for Admins -yhteysviite ja avaa se muokkattavaksi.
  7. Varmista, että kaikki pakolliset kentät on täytetty ja että valittu yhteys on kelvollinen.
  8. Valitse Tallenna.
  9. Etsi Copilot Agent Kit - Dataverse-yhteysviite ja avaa se muokkausta varten.
  10. Varmista, että kaikki pakolliset kentät on täytetty ja että valittu yhteys on kelvollinen.
  11. Valitse Tallenna.

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

Copilot Agent Kitiin sisältyvät pilvityönkulut voi ottaa käyttöön joko seuraamalla näitä vaiheita tai käyttämällä ohjattua toimintoa.

  1. Asenna Copilot Agent Kit aiemmin tässä artikkelissa kuvatulla tavalla.
  2. Kirjaudu Power Automate -palveluun
  3. Varmista, että Copilot Agent Kitin sisältävä ympäristö on valittu.
  4. Valitse Ratkaisut.
  5. Valitse Copilot Agent 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 alitason alitasoon.
    2. Työnkulut, jotka päättyvät alitasoon.
    3. Muut työnkulut tarpeen mukaan missä tahansa järjestyksessä.

Yhteensopivuuskeskuksen määrittäminen

Yhteensopivuuskeskuksen käyttöönottoa varten seuraa ohjeita kohdassa Perusta ja määritä Copilot Agent Kit -yhteensopivuuskeskus. 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 Agent Kit aiemmin tässä artikkelissa kuvatulla tavalla.

  2. Lataa Conversation.KPIs.zipPower CAT Copilot Agent Kit GitHub repositoriosta.

  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 Power Appsiin ja valitse sitten ympäristö, johon Copilot Agent Kit on asennettu.
  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 agenttien konfiguroinnista Copilot Agent Kitissä, mukaan lukien uuden agentin konfigurointi keskustelun KPI-mittareita varten.

Käytä Copilot Agent Kit -sovellusta

Copilot Agent Kit -sovelluksen käyttäminen:

  1. Kirjaudu Power Appsiin ja valitse sitten ympäristö, johon Copilot Agent Kit on asennettu.
  2. Siirry sovelluksiin.
  3. Etsi ja valitse Power CAT Copilot Agent Kit.
  4. Valitse Toista.
  5. (Valinnainen) Lisää sovellus kirjanmerkkeihin .

Jaa Copilot Agent Kit -sovellus

Kun olet varmistanut, että sovellus käynnistyy onnistuneesti, omistajan (tai järjestelmänvalvojan, joka asensi Kitin) täytyy jakaa Copilot Agent Kit -sovellus tiimille.

  1. Kirjaudu Power Appsiin.
  2. Valitse Sovellukset.
  3. Etsi "Copilot Agent Kit" ja valitse sovellus, jonka tyyppi on Koodi (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

Käyttäjien ja tiimien määrittäminen

  • Viimeksi päivitetty