Yhteyksien määrittäminen ja hallinta

Agentit käyttävät työkaluja ja tietoja toimintojen suorittamiseen käyttäjien puolesta ja soveltuvien tilannekohtaisten tietojen keräämiseen. Kehittäjät tallentavat usein näitä työkaluja ja tietolähteitä ulkoisiin järjestelmiin, kuten Microsoft Dataverse, Microsoft SharePoint tai muihin ohjelmointirajapintoihin. Jotta näihin resursseihin pääsee turvallisesti, agenttien täytyy tunnistautua ja luoda yhteyksiä itsensä ja ulkoisen järjestelmän välille. Agentti voi käyttää joko agentin tekijän tunnistautumista tai käyttäjän tunnistautumista tilanteesta riippuen.

Microsoft Copilot Studio käytät yhteyksiä, joiden avulla voit turvallisesti käyttää todennettuja työkaluja ja tietämystä. Voit luoda yhteyksiä erilaisiin tietolähteisiin, kuten Microsoft Dataverseen, Microsoft SharePointiin tai ulkoisiin ohjelmointirajapintoihin.

Agenttiyhteyksien tarkasteleminen ja hallinta

Copilot Studiossa voit tarkastella ja määrittää yhteyksiä, joita agenttisi käyttää Yhteysasetukset -sivulla.

Yhteysasetukset-sivulla voit konfiguroida ja hallita agenttisi käyttämiä yhteyksiä. Voit tarkastella olemassa olevia yhteyksiä, luoda uusia ja muokata tai katkaista niitä tarvittaessa.

Yhteyksien tarkasteleminen Yhteysasetukset-sivulla

1. Mene agenttisivullesi Copilot Studio:ssa valitsemalla Agentit ja sitten agentti, jonka haluat katsoa.

   Agentin yleiskatsaussivu avautuu.

2. Avaa Agentin Asetukset-sivu valitsemalla Asetukset.

3. Valitse Yhteysasetukset.

Näet taulukossa listan, jossa on kaikki agenttiisi liittyvät yhteydet. Jokaiselle yhteydelle voit katsoa:

• Yhteyden nimi
• Työkalut ja tiedonlähteet, jotka käyttävät tätä yhteyttä
• Yhteyden tila

Yhteystilan määritelmät

Yhteyden tila ilmaisee yhteyden nykyisen tilan. Useita mahdollisia tiloja on olemassa.

• Yhdistetty: Yhteys on aktiivinen, ja agentti voi käyttää sitä päästäkseen siihen liittyvään työkaluun tai tietoon.
• Ei yhteyttä: Ei ole aktiivista yhteyttä. Agentti ei pääse käsiksi siihen liittyvään työkaluun tai tietoon. Sinun täytyy luoda yhteys.
• Deaktivoitu: Yhteys on deaktivoitu, mahdollisesti ylläpitäjän toimesta, eikä agentti käytä sitä tällä hetkellä.
• Vanhentunut: Yhteyden tunnistautumistiedot ovat vanhentuneet eivätkä enää voimassa. Yhteys täytyy tunnistaa uudelleen, jotta agentti pääsee käsiksi siihen liittyvään työkaluun tai tietoon.
• Vanhentuneisuus: Yhteys ei ole enää voimassa tai käyttökelpoinen, yleensä koska se katkaistiin tai aikakatkaisu. Sinun täytyy tarkistaa, päivittää tai vaihtaa yhteys, jotta agentti pääsee käsiksi siihen liittyvään työkaluun tai tietoon.

Yhteyksien suodattaminen

Jos agentillasi on useita yhteyksiä, suodata lista löytääksesi haluamasi yhteyden. Sovella eri suodattimia nähdäksesi yhteyksiä niiden tilan perusteella, kuten Aktivoitu, Deaktivoitu, Yhdistetty, Ei yhdistetty, Vanhentunut tai Vanhentunut.

Valitse tai luo yksittäinen yhteys

1. Linkkimerkinnän Tila-kohdasta valitse tila vieressä oleva hyperlinkki avataksesi Luo tai valitse yhteyspaneeli.

2. Valitse ... avataksesi yhteyden asetukset.

3. Valitse olemassa oleva yhteys listasta tai valitse Luo uusi yhteys luodaksesi uuden.

   Jos valitset Luo uusi yhteys, yhteyden määritysruutu avautuu. Tarvittaessa sinua saatetaan pyytää kirjautumaan palveluun tai antamaan lisätietoja yhteyden viimeistelyä varten.

4. Kun olet valmis, tallenna muutokset valitsemalla Lähetä .

   Määritit yhteyden ja liitit sen agenttiisi. Välittäjäsi voi käyttää yhteyttä päästäkseen käsiksi työkaluihin ja tietoon.

Katso yksityiskohdat ja määritä yhteysparametrit

Valitse Luettelon Yhteysmerkinnän hallinta -kohdasta Näytä tiedot , niin saat lisätietoja yhteydestä.

Tiedot näkyvät kahdessa välilehdessä:

• Tiedot: Näyttää yhteyden nimen, kuvauksen, tilan ja luonnin tiedot.
• Yhteysparametrit: Näyttää yhteysparametrit, kuten todentamisen tiedot, ohjelmointirajapinta-avaimet tai muut vaaditut tiedot, ja voit määrittää tiedot.

On-Behalf-Of (OBO) -todennuksen yhteysparametrien jakaminen

Joissakin yhteyksissä, jotka tukevat kertakirjautumista (SSO), voit asettaa yhteyden käyttämään On-Behalf-Of (OBO) -tunnistautumista. OBO-prosessissa käyttäjä delegoi agentin käyttämään käyttäjän yhteysparametreja palvelun kanssa käyttäjän puolesta. Tämä todennusmenetelmä on hyödyllinen, kun agentin täytyy käyttää resursseja, jotka vaativat käyttäjäkohtaisia käyttöoikeuksia, tai kun toimenpiteitä täytyy suorittaa käyttäjän identiteetin kontekstissa.

Parametrien jakamisen käyttöönotto OBO:ssa

Voit antaa käyttäjän sallia tiettyjen yhteysparametrien jakamisen luettelon yhteysparametrien Kohdassa Yhteysparametrit .

1. Ota Yhteysparametrit-kohdassa käyttöön Salli parametrien jakamisoikeus.

   

2. Valitse valintaruudut parametreille, jotka haluat sallia käyttäjän jakaa.

   Käyttäjää pyydetään antamaan lupa näiden parametrien käyttöön, kun agentti käyttää OBO-todennusta.

OBO-todennuksen käyttökokemus

Kun agentti käyttää OBO-todennusta, käyttäjää pyydetään myöntämään agentille käyttöoikeus käyttää yhteysparametrejaan. Käyttäjä voi valintansa mukaan joko myöntää tai kieltää tämän oikeuden. Jos käyttäjä sallii sen, agentti voi käyttää resursseja ja suorittaa toimintoja käyttäjän puolesta. Agentti muodostaa yhteyden palvelimeen läpinäkyvästi käyttämällä jaettuja yhteysparametreja.

Toistuvia yhteyskehotteita oAuth 2.0:aa käytettäessä Microsoft Graph API työkalujen kanssa

Kun käytät OAuth 2.0 -tunnistautumista, jokaisen käyttäjän on kirjauduttava sisään ja annettava suostumus. Kun jaat tai isännöit agenttia, muut käyttäjät eivät ole vielä suostuneet, joten he näkevät Connect-kortin.

Välttääksesi toistuvat kehotteet, kokeile jotakin seuraavista tunnistautumisvaihtoehdoista:

• Ota käyttöön Teamsin kertakirjautuminen (SSO) on-beunder (OBO) -prosessilla: Käyttäjät kirjautuvat kerran Teamsissa. Chatissa ei vaadita ylimääräistä suostumusta.

• Käytä sovelluksen käyttöoikeuksia (palveluperiaate): Taustajärjestelmä kutsuu Microsoft Graph sovelluksen tunnuksia käyttäen. Käyttäjän suostumusta ei tarvita.

• Käytä yleistä OAuth SSO:ta web-isännöityille agenteille: sovelluksesi hoitaa kirjautumisen ja välittää tokenin agentille.

• Myönnä ylläpitäjän suostumus delegoiduille skaaleille: Poistaa käyttäjäkohtaiset käyttöoikeuspyynnöt. Alkuperäinen kirjautuminen vaaditaan edelleen.

Liittyvä sisältö

• Mukautettujen yhdistimien OBO-todennuksen määrittäminen