Jaa

Integroi verkkosovelluksia tai alkuperäisiä sovelluksia Microsoft 365 -agenttien SDK:n kanssa

Tärkeää

Tämä sisältö on tarkoitettu kokeneille IT-ammattilaisille, kuten IT-järjestelmänvalvojille ja kehittäjille, jotka tuntevat kehittäjätyökalut, apuohjelmat ja integroidut kehitysympäristöt. Se vaatii ohjelmistokehitysosaamista.

Kun olet luonut ja testannut agenttisi Copilot Studiossa, ota se käyttöön haluamassasi kanavassa testataksesi, miten kohdekäyttäjäsi käyttävät sitä.

Huomautus

Jos haluat käyttää Copilot Studion verkkosovelluksen upotuskoodia, sinun on asetettava suojaustodentamisen asetuksissa ei todennusta. Siirry kohtaan Asetukset>Tietoturvatodentaminen> ja valitse Ei todennusta, niin se tulee julkisesti saataville.

Tässä oppaassa kerrotaan, miten voit ottaa Copilot Studio -agentin ja integroida sen olemassa olevaan verkkosovellukseesi (yleensä verkkosivustoon) tai alkuperäiseen sovellukseen käyttämällä Copilot Studio -asiakasta Microsoft 365 -agenttien SDK:n kanssa.

Tämän oppaan eri osat ovat olennaisia sen mukaan, onko sinulla olemassa oleva käyttökokemus/käyttöliittymä, johon haluat integroida agentin, vai haluatko käyttää Microsoftin tarjoamaa käyttökokemusta/käyttöliittymää. Seuraavan taulukon avulla voit löytää skenaarioosi sopivan osion.

Käyttöönottomenetelmä Miten, missä ja miksi Pikalinkki
Käytä oletusarvoista verkkokeskustelun upotuskoodia Kun agentilla ei ole todennussuojausta käytössä, se on käytettävissä Web-kanavan julkaisuruudussa Copilot Studiossa. Huomautus: Tämä vaihtoehto näkyy vain, jos Copilot Studiossa ei ole valittuna todennusta . Käytä oletusarvoista verkkochatin upotuskoodia (ilman kehitys-/koodia)
Yhteyden muodostaminen Copilot Studioon Agenttien SDK-käyttäjien kirjautumisen avulla Agentin SDK-yhteysmerkkijonon tai määritysasetusten avulla voit integroida agentin suoraan käyttämällä käyttäjien tunnistetietoja käyttämällä copilotia. Sovelluksen rekisteröinnin määrittäminen käyttäjän vuorovaikutteiselle kirjautumiselle
Yhteyden muodostaminen Copilot Studioon Agents SDK:n palvelutunnuksella kirjautumalla Käytetään, kun haluat, että agentilla on omat käyttäjätietonsa, etkä käytä sen puolesta agenttia käyttävälle käyttäjälle. Hyödyllinen tilanteissa, joissa et vaadi käyttäjäkontekstia, mutta sinun on silti käytettävä etuoikeutettuja ohjelmointirajapintoja tai tietoja ja edellytä todennusta. Huomautus: Jotta voit suorittaa tämän tehtävän, tämän agentin todentamisen arvoksi Copilot Studiossa on asetettava Ei todentamista. Määritä sovelluksen rekisteröinti palvelun päänimelle
Yhteyden muodostaminen Copilot Studioon vanhan DirectLinen avulla Voit muodostaa yhteyden DirectLineen käyttämällä DirectLine-ohjelmointirajapintaa, ja sitä tulee käyttää, jos Agents SDK ei tue skenaariotasi. Agentin julkaiseminen mobiilisovelluksiin tai mukautettuihin sovelluksiin

Edellytykset

  • .NET Core / JS/ Python
  • Packages–Copilot Studio –asiakasohjelma
  • Agentti

Menetelmät Copilot Studio -agentin integroimiseksi

  • Copilot Studio -asiakas (Agents SDK:ta käyttämällä): Tämä menetelmä on suositeltavin tapa integroida Copilot Studion kanssa.

  • DirectLine: DirectLine on vanha tapa integroida Copilot Studioon, ja sitä tulee käyttää, jos Copilot Studio -asiakasohjelmiston käyttötapaukselle ei ole tukea.

    • Ei tue palvelun päänimen tunnusta

Aloittaminen: perusmääritysten ja agenttiyhteyden testaaminen Microsoft 365 -agenttien SDK:n avulla

  1. Lataa Copilot Studion asiakasmalli Microsoft 365 -agenttien SDK:sta.

    Yksinkertaistimme integrointia Agents SDK:n kanssa verkkoa ja alkuperäisiä sovelluksia varten tarjoamalla asiakaskirjaston, jonka avulla kehittäjät voivat syöttää agenttiasi koskevia tietoja ja integroida sen helposti sovelluksiisi.

  2. Hanki Copilot Studion asiakasmalli Agentit SDK GitHub -säilöstä joko C#:ssä, JavaScriptissä tai Pythonissa.

  3. Hae agenttisi upotuskoodi tai yhteysmerkkijono Copilot Studiossa.

    Sinulla on oltava käyttöoikeus Copilot Studio -agenttiisi, jotta saat yhteysmerkkijonon tiedot (tai määritysasetuksen tiedot), jotta voit muodostaa yhteyden siihen.

    Avaa Copilot Studiossa agenttisi, valitse Asetukset>Tietoturvatodentaminen> ja tarkista sitten agenttisi asetukset.

    • Jos joko Todenna Microsoftilla tai Todenna manuaalisesti on valittuna, näet vain yhteysmerkkijonovaihtoehdon , jonka voit integroida Agents SDK:hen.

    • Jos Todennusta ei ole valittu, näet sekä sivustoosi lisättävän upotuskoodin että yhteysmerkkijonon. Upotuskoodi-asetus ei käytä Agentit SDK:ta ja vakiomuotoista, valjastettua Web Chat -osaa.

    Agentin todennusasetusten näyttökuva, joka näyttää, ettei todentamista ole valittu.

  4. Hae oma yhteysmerkkijonosi.

    Voit hakea agenttisi yhteysmerkkijonon Copilot Studiossa valitsemalla kanavasivulta joko verkkosovelluksen tai alkuperäisen sovelluksen. Valitse yhteysmerkkijonon vieressä KopioiMicrosoft 365 -agenttien SDK-kohdasta. Tämän merkkijonon avulla voit muodostaa yhteyden tähän agenttiin verkkosi tai alkuperäisen sovelluksesi koodista.

    Näyttökuva Copilot Studion Kanavat-sivusta.

    Näyttökuva Verkkosovellusten kanavapaneelista Copilot Studiossa.

  5. Hanki tietoja perinteisistä määritysasetuksista.

    Jos et halua käyttää yhteysmerkkijonomenetelmää ja käyttää sen sijaan perinteisiä määritysasetuksia, tarvitset muita metatietoja Copilot Studio -agentiltasi.

    Valitse Lisäasetukset>. Metatiedot-kohdassa tarvitset ympäristön tunnuksen, vuokraajatunnuksen ja rakenteen nimen. Tallenna nämä metatietoarvot myöhempää käyttöä varten.

    Näyttökuva Agentin Lisäasetukset-sivusta Copilot Studiossa.

  6. Määritä sovelluksen rekisteröinti oikeille käyttöoikeuksille Copilot Studion käyttämiseksi.

    Verkkosovelluksella tai alkuperäisellä sovelluksella on oltava sovelluksen rekisteröinti Azuressa. Jos sinulla ei ole sovelluksen rekisteröintiä Azuressa, voit noudattaa kaikkia ohjeita sen määrittämisessä Readmen tai Azuren dokumentaation avulla. Lisätietoja on kohdassa Sovelluksen rekisteröiminen Microsoft Entra ID:ssä.

    Huomautus

    Sinulla on todennäköisesti jo sovellusrekisteröinti rekisteröintiä varten, ja sinun on käytettävä sitä sen sijaan. Voit määrittää käyttäjän tai palvelun päänimen todennusmenetelmät agenttisi käyttöä varten.

Sovelluksen rekisteröinnin määrittäminen käyttäjän vuorovaikutteiselle kirjautumiselle

  1. Siirry ohjelmointirajapinnan käyttöoikeuden kohtaan>Lisää käyttöoikeuksia, valitse Organisaationi käyttämät ohjelmointirajapinnat ja tee haku hakusanalla Power Platform API.

  2. Valitse delegoidut> käyttöoikeudetCopilot Studio>Copilot Studio.Copilots.Invoke -käyttöoikeus. Valitse Lisää käyttöoikeudet.

Käyttäjän kirjautumista varten voit testata mallityötä sovelluksen rekisteröinnin ja Copilot Studio -agentin kanssa seuraavasti:

Yhteysmerkkijonon lisääminen appsettings.config tiedoston Copilot Studio -asiakasohjelmaasetuksiin:

  • DirectConnectUrl
  • TenantID:
  • ClientID:
  • ClientSecret:

Copilot Studion asiakasasetusten lisääminen appsettings.config tiedostoon:

  • EnvironmentID:
  • SchemaName:
  • TenantID:
  • AppClientID:
  • AppClientSecret:

Sinun pitäisi nyt pystyä suorittamaan malli ja muodostamaan yhteys agenttiin sovelluksen rekisteröintiasetusten avulla käyttämällä mallikonsolisovellusta.

Määritä sovelluksen rekisteröinti palvelun päänimelle

Vaihtoehtoisesti voit halutessasi määrittää sovelluksen rekisteröinnin palvelun todennusta varten käyttäjän todentamisen sijaan.

  1. Siirry sovelluksen rekisteröinnissä ohjelmointirajapinnan käyttöoikeuden kohtaan, lisää käyttöoikeudet, valitse Organisaationi käyttämät ohjelmointirajapinnat ja hae Power Platform API.
  2. Valitse Sovelluskäyttöoikeudet>Copilot Studio ja tarkista Copilot Studio.Copilots.Invoke-käyttöoikeus .
  3. Valitse Lisää käyttöoikeudet.

Käyttäjän kirjautumista varten voit testata mallityötä sovelluksen rekisteröinnin ja Copilot Studio -agentin kanssa seuraavasti:

  1. Yhteysmerkkijonon lisääminen appsettings.config tiedoston Copilot Studio -asiakasohjelmaasetuksiin:

    • DirectConnectUrl
    • TenantID:
    • UseS2SConnection: true
    • ClientID:
    • ClientSecret:

  2. Copilot Studion asiakasasetusten lisääminen appsettings.config tiedostoon:

    • EnvironmentID:
    • SchemaName:
    • TenantID:
    • UseS2SConnection: true
    • AppClientID:
    • AppClientSecret:

Sinun pitäisi nyt pystyä suorittamaan malli ja muodostamaan yhteys agenttiin sovelluksen rekisteröintiasetuksissa käyttämällä mallikonsolisovellusta.

Copilot Studio -asiakasohjelman integrointi olemassa olevaan käyttöliittymään tai käyttökokemukseen

Testasit agenttisi Copilot Studion asiakaskoneella. Testaamisesi varmistaa, että agentti on yhteydessä mallikonsolisovellukseen. Olet valmis integroimaan kirjaston olemassa olevaan sivustoosi tai sovellukseesi ja yhdistämään tai pintaan sen olemassa olevan käyttöliittymän avulla.

Sinun ja olemassa olevan koodikannan avulla voit integroida agentin sovellukseen. Yleensä agenttisi integrointivaiheet voivat olla seuraavat:

  1. Viittaaminen sovelluksen kirjastoon.
  2. Objektien ja menetelmien toteuttaminen projektisi asiakaskirjastosta.
  3. Di-lisäyksessä tai asiakkaan hallinnassa sovelluksen olemassa olevan rakenteen mukaan, varmista, että viittaat agentin määritystietojen sovellusasetuksiin.

Käytä oletusarvoista verkkochatin upotuskoodia (ilman kehitys-/koodia)

Voit lisätä Copilot Studio -agentin sivustoosi iFramella, joka voidaan upottaa verkkosivuston tai verkkosovelluksen HTML:ään.

Tämä koodi on näkyvissä vain, jos Ei todentamista -asetus on valittuna agentin asetuksissa Copilot Studiossa kohdassa Suojaus. Jos Todentaminen Microsoftilla tai Todenna manuaalisesti on valittuna, upotuskoodi ei ole näkyvissä.

Näyttökuva agentin todennusasetuksista.

Yhdistä Copilot Studioon DirectLinen avulla

Katso Agentin julkaiseminen mobiilisovelluksiin tai mukautettuihin sovelluksiin , jos haluat integroida DirectLinen Copilot Studio -agentin kanssa.