Copilot Studio -agenttien käytön taitojen määrittäminen

Copilot Studion avulla voit laajentaa agenttiasi käyttämällä skills -menetelmää. Jos organisaatiossasi on jo agentteja, jotka on otettu käyttöön (Microsoft 365 -agenttien SDK tai muiden koodia tukevien työkalujen avulla) tietyissä skenaarioissa, voit muuntaa nämä botit taidoiksi ja rekisteröidä nämä taidot Copilot Studio -agentissa.

Huomautus

Jos haluat lisätä Microsoft Teams:n Copilot Studio -sovelluksen osaamista, sinulla on oltava erillinen Microsoft Copilot Studio tilaus.

Tämä artikkeli on tarkoitettu taitoihin perehtyneille järjestelmänvalvojille ja IT-ammattilaisille.

Kun olet rekisteröinyt taidon Copilot Studio -agentissa, voit saumattomasti käynnistää taitotoiminnot keskustelussa.

Vaatimukset

Tärkeää

Copilot Studio -agentit tukevat vain taitoja, jotka on luotu käyttämällä Legacy Bot Framework SDK -versiota 4.12.0+ ja Microsoft 365 -agenttien SDK v1.0.0+. Uusia taitoja tulee kehittää Microsoft 365 -agenttien SDK:n avulla.

Jos haluat määrittää taidon, määritä siihen liittyvän sovelluksen rekisteröinti Microsoft Entra ID yhden vuokraajan määritykseen.

Milloin kannattaa käyttää agentin työnkulkuja tai taitoja?

Seuraavan taulukon avulla voit määrittää, milloin agenttityönkulkuja tai -taitoja käytetään keskusteluun.

Kerroin Milloin agenttivirtoja kannattaa käyttää Milloin taitoja kannattaa käyttää
Henkilötyyppi 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.
Keskustelutyyppi Käytä työnkulkuja yksinkertaisissa yksivuoroisissa toiminnoissa. Esimerkiksi tilauksen tekemisessä tai tilauksen tilan noutamisessa. Käytä taitoja monimutkaisiin monivaiheisiin toimintoihin. Esimerkiksi tapaamisen tai lennon varaamiseen.
Vastaus Käytä työnkulkuja agenttivastauksen lähettämisessä. 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.
Tapahtumat Käytä virtauksia palvelimen puolella olevien yksittäisten toimintojen toteuttamiseen. 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 ja ota käyttöön osaamista koodausta tukevien työkalujen avulla organisaatiossasi. Tutustu näihin näytteisiin:

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

Taidon lisääminen agenttiin:

  1. Siirry agenttiin.

  2. Siirry taitojen sivulle valitsemalla Asetukset>Taidot.

  3. Valitse Lisää taito.

  4. Kopioi agentin tunnus. Anna taitojen kehittäjälle agentin tunnus.

  5. Anna taitoluettelon URL-osoite. Taidon luettelo sisältää tiedot, jotka agentti tarvitsee käynnistääkseen toimintoja taidon avulla.

  6. 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 turvaamiseksi vaadimme, että taidot rekisteröidään sovelluksena sisäänkirjautuneen käyttäjän Microsoft Entra ID vuokraajassa.

Virheiden vianmääritys taidon rekisteröinnin yhteydessä

Järjestelmä suorittaa joukon vahvistustarkistuksia URL-osoitteeseen. Nämä tarkistukset varmistavat, että agenttiin lisäämäsi taidon vaatimustenmukaisuus, hallinto ja käytettävyys täyttyvät. Nämä virheet on korjattava ennen taidon rekisteröimistä.

Virhesanoma Vianmääritys/korjaustoimet
Meillä oli ongelmia taitomanifestin saamisessa.
(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ä luettelo on kelvollinen JSON-tiedosto.
(b) Tarkista, sisältääkö manifestissa vaaditut ominaisuudet
Esimerkiksi (name, msaAppId, yksittäinen endpoint, activities/id,activities/description , , activities/type(vain event tai message tuettu)).
Päätepisteissäsi on ristiriita
(MANIFEST_ENDPOINT_ORIGIN_MISMATCH)		 Tarkista, vastaako taidon päätepiste Microsoft Entra ID sovelluksen rekisteröinnin kenttää Publisher domain (ensisijainen) tai Home page URL -kenttä. Lisätietoja päätepisteiden aloitussivun määrittämisestä.
Taidon lisäämiseksi se täytyy ensin rekisteröidä
(APPID_NOT_IN_TENANT)		 Tarkista, onko osaamisesi sovellustunnus rekisteröity organisaatiosi Microsoft Entra ID vuokraajaan.
Linkki ei ole pätevä; Linkin täytyy alkaa https://
(URL_MALFORMED, URL_NOT_HTTPS)		 Muokkaa linkkiä ja lisää suojattu URL-osoite.
Manifesti 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 kokeile rekisteröidä 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.
Näyttää siltä, että jokin meni pieleen.
(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 sovellusrekisteröinti on otettu käyttöön samassa vuokraajassa.
Tämä taito ei ole mahdollistanut agenttisi listautumista
(ENDPOINT_HEALTHCHECK_UNAUTHORIZED)		 Tarkista, onko agentti lisätty sallittujen taitojen luetteloon.
  • Last updated on