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

Artikkeli
02/18/2025

Copilot Studion avulla voit laajentaa agenttia 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 Studio -agentissa.

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 -agenttiin, tekijät voivat saumattomasti käynnistää taitotoimintoja keskustelussa.

edellytykset

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

Tärkeää

Copilot Studio -agentit 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-agenttia, siirrä se ensin Composer-versioon 2.x, ennen kuin käytät sitä taitona.

Jotta voit määrittää taidon, siihen liittyvän Microsoft Entra ID:n sovellusrekisteröinnin on oltava määritettynä palveluna tarjottavan sovelluksen määritystä varten.

Työnkulku- ja taitotoiminnot

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

	Työnkulkutoiminnot	Taitotoiminnot
Rooli	Agenttien tekijät voivat kehittää uudelleenkäytettäviä työnkulkuja upotettavaksi mihin tahansa agenttikeskusteluun.	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 agenttivastauksen lähettämiseen. Näytä esimerkiksi mukautettu viesti tai tekstiin sidottuja kuvia.	Käytä taitoja minkä tahansa tuetun agenttivastauksen 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 agenttivastauksen jälkeen.

Taidon määrittäminen

Luo ensin agentti Copilot Studion avulla ja luo taito ja ota se käyttöön ammattimaisten ohjelmointityökalujen avulla organisaatiossa.

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

Taidon lisääminen agenttiin:

Laajenna siirtymisruudussa Asetukset ja valitse Taidot.
Valitse Taidot-sivun yläosassa Lisää taito.
Kopioi agenttisi tunnus ja anna se taitojen kehittäjälle.
Kirjoita taitoluettelon URL-osoite. Taidon luettelo sisältää tiedot, jotka agentti tarvitsee käynnistääkseen toimintoja taidon avulla.
Aloita vahvistusprosessi valitsemalla Next. Kun vahvistus on onnistunut, taito lisätään agenttiin. 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 agenttiisi 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 agenttiin. (`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.
Agentilla voi olla enintään 100 taitoa. (`LIMITS_TOO_MANY_SKILLS`)	Agenttiin 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. Tarkista myös, että yhden vuokraajan taidon sovelluksen rekisteröinti on otettu käyttöön samassa vuokraajassa.
Agenttia ei ole merkitty tämän taidon sallittujen luetteloon (`ENDPOINT_HEALTHCHECK_UNAUTHORIZED`)	Tarkasta, onko agentti lisätty taidon sallittujen kohteiden luetteloon.

Jaa