Muistiinpano
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää kirjautua sisään tai vaihtaa hakemistoa.
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää vaihtaa hakemistoa.
Note
Tässä artikkelissa kuvataan ominaisuuksia, joita käytetään agenteissa tai agenttivirroissa, joita käytetään standardivaljastuksen voimalla.
Important
Tämä artikkeli sisältää tietoa Azure Bot Service Skills -ominaisuudesta, koodipohjaisesta tavasta laajentaa agentin kykyjä vakiokehyksessä. Azure Bot Service -taidot eroavat seuraavista:
- Agentin taidot, ohjeisiin perustuvat taidot, joita lisäät agenteihin, joita tukee GitHub Copilot tai Customer Conversation harness. Lue lisää Taitojen yleiskatsauksesta agenteille.
- Plugin-taidot, ominaisuus, jonka Microsoft 365 Copilot -lisäosa voi sisältää. Lisätietoja on artikkelissa Osaamiset laajennuksen ominaisuuksina.
Copilot Studio antaa sinun laajentaa agenttiasi käyttämällä Azure Bot Service taitoja. Jos sinulla on jo agentteja rakennettu ja otettu käyttöön organisaatiossasi (käyttäen Microsoft 365 -agenttien SDK tai muita pro-code-työkaluja) tiettyihin tilanteisiin, voit muuntaa nämä botit Azure Bot Service taidoiksi ja rekisteröidä taidot Copilot Studio-agenttiin.
Note
Jos haluat lisätä Azure Bot Service -taidon Microsoft Teamsin Copilot Studio -sovelluksessa, sinulla täytyy olla erillinen Microsoft Copilot Studio -tilaus.
Tämä artikkeli on tarkoitettu järjestelmänvalvojille tai IT-ammattilaisille, jotka tuntevat Azure Bot Service taidot.
Kun rekisteröit Azure Bot Service taidon Copilot Studio-agentille, voit saumattomasti laukaista Azure Bot Service taitotoimintoja keskustelussa.
Vaatimukset
Important
Copilot Studio agentit tukevat vain sellaisia Azure Bot Service taitoja, jotka on rakennettu Legacy Bot Framework SDK version 4.12.0+ ja Microsoft 365 -agenttien SDK v1.0.0+ avulla. Uusia Azure Bot Service-taitoja tulisi rakentaa Microsoft 365 -agenttien SDK avulla.
Määrittääksesi Azure Bot Service -taidon aseta Microsoft Entra ID:ssä taitoosi liittyvä sovellusrekisteröinti yhden vuokraajan määritykseksi.
Milloin käyttää agenttivirtoja tai Azure Bot Service -taitoja
Seuraava taulukko auttaa sinua määrittämään, milloin käyttää agenttien virtoja tai Azure Bot Service taitoja keskustelussa.
| Kerroin | Milloin agenttivirtoja kannattaa käyttää | Milloin käyttää Azure Bot Service -taitoja |
|---|---|---|
| Henkilötyyppi | Agenttien tekijät voivat kehittää uudelleenkäytettäviä työnkulkuja upotettavaksi mihin tahansa agenttikeskusteluun. | Kehittäjät voivat luoda, ottaa käyttöön ja isännöidä räätälöityjä Azure Bot Service-taitoja omassa ympäristössään. |
| Keskustelutyyppi | Käytä työnkulkuja yksinkertaisissa yksivuoroisissa toiminnoissa. Esimerkiksi tilauksen tekemisessä tai tilauksen tilan noutamisessa. | Hyödynnä Azure Bot Servicen taitoja monimutkaisissa, monivaiheisissa operaatioissa. 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ä Azure Bot Service taitoja tuottaaksesi minkä tahansa tuetun agentin vastauksen. Esimerkiksi mukautuvan kortin näyttämiseen tai satunnaisten vastausten lähettämiseen. |
| Toiminnot | Käytä virtauksia palvelimen puolella olevien yksittäisten toimintojen toteuttamiseen. Esimerkiksi HTTP-ohjelmointirajan kutsuminen tai mukautetun yhdistimen käynnistäminen. | Käytä Azure Bot Service -taitoja palvelin- ja asiakaspuolen tapahtumien ja toimintojen käynnistämiseen. Esimerkiksi siirtyminen tietylle sivulle agenttivastauksen jälkeen. |
Määritä Azure Bot Service -taito
Ensiksi käytä Copilot Studiota agentin luomiseen ja luo sekä ota käyttöön Azure Bot Service taito pro-koodityökaluilla organisaatiossasi. Tutustu näihin näytteisiin:
Ennen Azure Bot Service-taidon rekisteröintiä anna agentin ID taitokehittäjällesi, jotta hän voi valtuuttaa agentin kutsumaan toimintoja taidossa. Lue lisää Azure Bot Service -taidon sallittujen luettelosta. Voit saada agentti-ID:si Lisää taito -ikkunasta.
Voit lisätä Azure Bot Service -taidon agenttiisi seuraavasti:
Siirry agenttiin.
Valitse Asetukset>Taidot.
Valitse Lisää taito.
Kopioi agentin tunnus. Sinun täytyy antaa agentin tunnus skill-kehittäjällesi.
Syötä Azure Bot Service skill-manifestin URL-osoite. Skillin manifesti sisältää tiedot, joita agenttisi tarvitsee aktivoidakseen toimintoja skillin sisällä.
Aloita vahvistusprosessi valitsemalla Next. Kun validointi onnistuu, taitosi lisätään agentillesi. Voit nyt käyttää tätä taitoa aiheissasi.
Yhteensopivuuteen liittyvät näkökohdat
Käyttäjän yksityisyyden suojaamiseksi sinun tulee rekisteröidä Azure Bot Service -osaaminen sovellukseksi kirjautuneen käyttäjän Microsoft Entra ID -vuokraajassa.
Azure Bot Service -taitojen rekisteröinnin virheiden vianmääritys
Järjestelmä suorittaa joukon vahvistustarkistuksia URL-osoitteeseen. Nämä tarkistukset varmistavat agenttiisi lisäämäsi taidon vaatimustenmukaisuuden, hallinnan ja käytettävyyden. Sinun täytyy korjata nämä virheet ennen kuin rekisteröit Azure Bot Service taidon.
| Virheviesti | 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ä.
Lue lisää päätepisteiden etusivun asettamisesta. |
| 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 lisännyt agenttiasi sallittujen luetteloon ( ENDPOINT_HEALTHCHECK_UNAUTHORIZED) |
Tarkista, onko agenttisi lisätty taidon lupalistalle. |