Bot Framework -taidon määrittäminen Copilot Studiossa käytettäväksi

Artikkeli
04/08/2024

Copilot Studion avulla voit laajentaa avustajaa käyttämällä Bot Framework -taitoja. Jos olet jo kehittänyt ja ottanut käyttöön organisaatiossasi botteja (käyttäen Bot Frameworkin SDK:ta ja ammattitasoisia koodaustyökaluja) tiettyjä skenaarioita varten, voit muuntaa nämä botit taidoksi ja rekisteröidä kyseisen taidon Copilot Studion avustajassa.

Muistiinpano

Voit lisätä taidon Microsoft Teamsin Copilot Studio -sovelluksessa, mutta se edellyttää erillistä Microsoft Copilot Studio -tilausta.

Tämä artikkeli on tarkoitettu järjestelmänvalvojille tai IT-ammattilaisille, jotka ovat perehtynyt Bot Framework -taitoihin. Kun taito on rekisteröity Copilot Studio -avustajaan, tekijät voivat saumattomasti käynnistää taitotoimintoja keskustelussa.

edellytykset

Copilot Studiossa käytettävien taitojen rajoitusten ja vahvistuksen tarkistaminen

Tärkeää

Copilot Studion avustajat tukevat vain taitoja, joiden kehittämiseen on käytetty Bot Framework SDK:n versiota 4.12.0+.

Perinteiset keskustelubotit tukevat vain taitoja, joiden luomisessa on käytetty Bot Framework SDK:n versiota 4.7+.

Jos käytät Bot Framework Composeria on erittäin suositeltavaa käyttää Composer-versiota 2.x. Jos haluat käyttää aiemmin luotua Composer 1.x -avustajaa, siirrä se ensin Composer-versioon 2.x, ennen kuin käytät sitä taitona.

Taidon määrittäminen edellyttää, että taidon Microsoft Entra ID:ssä liitetty sovelluksen rekisteröinniksi on määritettävä usean vuokraajan määritys.

Työnkulku- ja taitotoiminnot

Seuraava taulukko auttaa sen päättämisessä, milloin kannattaa käyttää taitoja keskustelussa.

	Työnkulkutoiminnot	Taitotoiminnot
Rooli	Avustajien tekijät voivat kehittää uudelleenkäytettäviä työnkulkuja upotettavaksi mihin tahansa avustajakeskusteluun	Sovelluskehittäjät voivat luoda, ottaa käyttöön ja isännöidä mukautettuja taitoja omassa ympäristössään
Keskustelu	Käytä työnkulkuja yksinkertaisissa yksivuoroisissa toiminnoissa. Esimerkiksi tilauksen tekemisessä tai tilauksen tilan noutamisessa.	Käytä taitoja monimutkaisiin monivoroisiin toimintoihin. Esimerkiksi tapaamisen tai lennon varaamiseen.
Response	Käytä työnkulkuja avustajavastauksen lähettämiseen. Näytä esimerkiksi mukautettu viesti tai tekstiin sidottuja kuvia.	Käytä taitoja minkä tahansa tuetun avustajavastauksen lähettämiseen. Esimerkiksi mukautuvan kortin näyttämiseen tai satunnaisten vastausten lähettämiseen.
Toiminnot	Käytä työkaluja käynnistääksesi yksivuoroisia palvelinpuolen toimintoja. Esimerkiksi HTTP-ohjelmointirajan kutsuminen tai mukautetun yhdistimen käynnistäminen.	Käytä taitoja käynnistääksesi palvelin- ja asiakaspuolen tapahtumia ja toimintoja. Esimerkiksi siirtyminen tietylle sivulle avustajavastauksen jälkeen.

Taidon määrittäminen

Käytä ensin Copilot Studiota avustajan luomisessa ja luo ja ota käyttöön taito ammattimaisten ohjelmointityökalujen avulla organisaatiossa.

Ennen kuin rekisteröit taidon, anna taitojen kehittäjälle avustajatunnus, jotta avustajan voi valtuuttaa kutsumaan toimintoja taidossa. Lisätietoja taitojen sallittujen kohteiden luettelosta Löydät avustajan tunnuksen Lisää taito -ikkunasta.

Voit lisätä avustajaan taidon seuraavasti:

Laajenna siirtymisruudussa Asetukset ja valitse Taidot.
Valitse Taidot-sivun yläosassa Lisää taito.
Kopioi avustajasi tunnus ja anna se taitojen kehittäjälle.
Kirjoita taitoluettelon URL-osoite. Taidon luettelo sisältää tiedot, jotka avustaja tarvitsee käynnistääkseen toimintoja taidon avulla.
Aloita vahvistusprosessi valitsemalla Next. Kun tarkistus on tehty, taito lisätään avustajaan. Voit nyt käyttää tätä taitoa aiheissasi.

Yhteensopivuuteen liittyvät näkökohdat

Käyttäjien tietosuojan vuoksi edellytetään, että taidot rekisteröidään sovelluksena kirjautuneen käyttäjän Microsoft Entra ID -vuokraajassa.

Virheiden vianmääritys taidon rekisteröinnin yhteydessä

URL-osoitteelle tehdään joukko vahvistustarkastuksia. Nämä tarkastukset varmistavat avustajaasi lisättävän taidon yhteensopivuuden, hallinnon ja käytettävyyden. Nämä virheet on korjattava ennen taidon rekisteröintiä.

Virhesanoma	Vianmääritys/korjaustoimet
Taidon luettelotiedostoa ei voitu noutaa. (`MANIFEST_FETCH_FAILED`)	Yritä avata luettelon URL-osoite verkkoselaimessa. Jos URL-osoite hahmontaa sivun 10 sekunnin kuluessa, rekisteröi taitosi uudelleen.
Luettelotiedosto on yhteensopimaton. (`MANIFEST_MALFORMED`)	(a) Tarkista, että luettelotiedosto on kelvollinen JSON-tiedosto. (b) Tarkista, sisältääkö luettelotiedosto pakolliset ominaisuudet Esimerkiksi: (`name`, `msaAppId`, yksi `endpoint`, `activities`/`id`, `activities`/`description`, `activities`/`type` (vain kohteita `event` tai `message` tuetaan)).
Päätepisteissä on ristiriita (`MANIFEST_ENDPOINT_ORIGIN_MISMATCH`)	Tarkista, vastaako taidon päätepiste Microsoft Entra ID -sovellusrekisteröinnin kenttää `Publisher domain` (ensisijainen) vai `Home page URL`. Lisätietoja päätepisteiden aloitussivun määrittämisestä.
Jos haluat lisätä taidon, se on ensin rekisteröitävä (`APPID_NOT_IN_TENANT`)	Tarkasta, onko taitosi sovellustunnus rekisteröity organisaation Microsoft Entra ID -vuokraajaan.
Linkki ei kelpaa. Linkin alussa on oltava https:// (`URL_MALFORMED`, `URL_NOT_HTTPS`)	Syötä linkki uudelleen suojattuna URL-osoitteena.
Luettelotiedosto on liian suuri; (`MANIFEST_TOO_LARGE`)	Tarkista luettelotiedoston koko. Se saa olla enintään 500 kt.
Tämä taito on jo lisätty avustajaan. (`MANIFEST_ALREADY_IMPORTED`)	Poista taito ja yritä rekisteröintiä uudelleen.
Taito voi sisältää enintään 100 toimintoa. (`LIMITS_TOO_MANY_ACTIONS`)	Taitoluettelossa on määritetty liian monta taitotoimintoa. Poista toimintoja ja yritä sitten uudelleen.
Toiminnoissa voi olla enintään 25 syötettä. (`LIMITS_TOO_MANY_INPUTS`)	Taitotoiminnon syöteparametreja on liikaa. Poista parametreja ja yritä sitten uudelleen.
Toiminnoissa voi olla enintään 25 tulostetta. (`LIMITS_TOO_MANY_OUTPUTS`)	Taitotoiminnon tulosteparametreja on liikaa. Poista parametreja ja yritä sitten uudelleen.
Avustajassa voi olla enintään 100 taitoa. (`LIMITS_TOO_MANY_SKILLS`)	Avustajaan on lisätty liian monta taitoa. Poista aiemmin luotu taito ja yritä sitten uudelleen.
Jokin meni vikaan. (`AADERROR_OTHER`)	Taitosi vahvistamisessa tapahtui lyhytaikainen virhe. Yritä uudelleen.
Taitoa tarkistettaessa tapahtui virhe. (`ENDPOINT_HEALTHCHECK_FAILED`, `HEALTH_PING_FAILED`)	Tarkasta, onko taitosi päätepiste online-tilassa ja vastaako se viesteihin.
Avustajaa ei ole merkitty tämän taidon sallittujen luetteloon (`ENDPOINT_HEALTHCHECK_UNAUTHORIZED`)	Tarkasta, onko avustaja lisätty taidon sallittujen kohteiden luetteloon.

Jaa