Mukautettuihin agentteihin työkalujen lisääminen

Työkalut ovat rakenneosia, joiden avulla agenttisi voi olla vuorovaikutuksessa ulkoisten järjestelmien kanssa. Työkalut laajentavat agenttisi toimintaa, jolloin se voi suorittaa erilaisia toimintoja käyttäjän pyyntöihin tai itsenäisiin käynnistimiin vastaamiseksi. Jokainen työkalu edustaa tiettyä ominaisuutta, jonka agenttisi voi suorittaa. Voit esimerkiksi varustaa agentillesi työkaluja, jotka tekevät esimerkiksi seuraavaa:

• Sähköpostiviestien lähettäminen Office 365 Outlook -liittimellä
• Tarkista nykyiset sääolosuhteet ja ennusteet
• Tietojen lukeminen ja kirjoittaminen Dataversesta
• Viestien lukeminen ja lähettäminen Teamsiin

Työkalujen lisäysmekanismit

Voit laajentaa mukautetun agenttisi ominaisuuksia lisäämällä yhden tai useamman työkalun. Agenttisi voi työkalujen avulla vastata käyttäjille automaattisesti luontiorkestroinnilla. Voit myös kutsua työkaluja suoraan aiheen sisältä.

Kun käytössä on muodostava orkestrointi (oletusarvoisesti aktiivinen), agenttisi voi automaattisesti valita sopivimman työkalun tai aiheen tai hakea tiedoista, jotta hän voi vastata käyttäjälle. Tämä orkestrointitila luo dynaamisemman ja älykkäämmän keskustelukokemuksen.

Perinteisessä tilassa (muodostava orkestrointi on poistettu käytöstä), agentti voi vain vastata käyttäjälle aiheiden avulla. Voit kuitenkin edelleen suunnitella agentin kutsumaan työkaluja eksplisiittisesti aiheista.

Käytettävissäsi on useita mekanismeja työkalujen lisäämiseksi agenttiin:

• Liitin: Yhdistä omiin API:iin ja palveluihin Power Platform Connectors -liittimillä, jotta voit hakea dataa tai suorittaa toimintoja.
  • Valmis liitin: Valitse esiasetetut yhteydet tuhansiin suosittuihin ohjelmointirajapintoihin sekä Microsoftista että muista palveluista.
  • Mukautettu liitin: Määritä yhteys mukautettuun palveluun tai järjestelmään mukautettujen työkaluvaihtoehtojen käyttöönottamiseksi Power Platform -liittimien avulla. Liittimen on tarkasteltava ja jaettava organisaation käyttöoikeuksia, jotta agentti voi käyttää liitintä.
• Agenttivirta: Määrittele agenttivirta, mukaan lukien yksi tai useampi suoritettava toimenpide.
• Kehote: Yksittäinen mallipohjainen kehote, joka voi viitata antamaasi tietoon ja tuottaa koodia datan analysointia varten.
• REST API: Määrittele yhteys REST-rajapintaan ja valitse yksi tai useampi API-päätepiste ja metodi lisättäväksi työkaluiksi.
• Mallikontekstiprotokolla: Yhdistä MCP-palvelimeen käyttääksesi työkaluja ja resursseja.
• Tietokoneen käyttö: Mahdollistaa agentin vuorovaikutuksen minkä tahansa graafisen käyttöliittymän järjestelmän kanssa, kuten verkkosivuille ja työpöytäsovelluksille, painikkeiden valinnan, valikoiden ja tekstin syöttämisen ruudun kentille.

On olemassa kaksi muuta mekanismia, joiden avulla voit lisätä työkalun kaltaisen käyttäytymisen agenttiisi:

• Taidot: Säiliö joukolle aiheeseen liittyviä työkaluja.
• Asiakastyökalu: Lähetä tapahtumatoiminto asiakkaalle, jotta asiakas suorittaa toiminnon ja palauttaa vastauksen.

Lisätietoja taidoista ja asiakastyökaluista saat Aiheeseen liittyvä sisältö -osion linkeistä.

Luo ja lisää uusi työkalu agenttitasolla

Uusien työkalujen luominen suoraan Copilot Studiossa tehostaa kehitysprosessia ja varmistaa asianmukaisen integraation agenttisi kanssa. Agentille lisätyt työkalut ovat käytettävissä automaattiseen orkestrointiin agenttisi keskusteluissa.

1. Avaa mukautettu agentti valitsemalla vasemmasta siirtymisruudusta Agentit ja valitsemalla agenttisi luettelosta.

2. Siirry agentin Työkalut-sivulle .

3. Valitse Lisää työkalu.

4. Valitse Lisää työkalu -ruudussa Uusi työkalu.

5. Valitse näyttöön tulevasta luettelosta työkalun tyyppi, jonka haluat lisätä:

   • Kehote
   • Agenttivirta
   • Tietokoneen käyttö
   • Mukautettu liitin
   • Mallin kontekstin protokolla
   • REST API

   

6. Suorita valitsemasi työkalun tyypin määritysvaiheet. Jos valitset esimerkiksi Kehote, sinun on suoritettava seuraavat vaiheet:

   • Kehotemallin ja ohjeiden määrittäminen
   • Määritä syöteparametrit
   • Tietolähteiden määrittäminen
   • Vastausmuodon ja rajoitusten määrittäminen

7. Valitse Tallenna tai Julkaise tarpeen mukaan luodaksesi uuden työkalun.

8. Valitse Lisää ja määritä. Työkalu lisätään agenttiisi. Työkalun asetussivu tulee näkyviin. Voit tarkastella ja tehdä muutoksia työkalun kokoonpanoon täällä.

Näet uuden työkalun agentin Työkalut-sivulla .

Tarkastele työkalujen määrityksiä ja tee niihin muutoksia

Voit tarkastella ja muokata työkalun määrityksiä milloin tahansa: siirry agenttisi Työkalut-sivulle ja valitse työkalu työkaluluettelosta.

Työkalun asetussivu avautuu. Tiedot näkyvät kolmessa osassa:

• Yksityiskohdat
• Syötteet
• Valmistuminen

MCP-palvelimilla, jotka on yhdistetty agenttityökaluiksi, konfiguraatiosivu eroaa muista työkalutyypeistä. Tiedot-osio on samanlainen, mutta Syötteet ja valmistuminen -osion sijaan on Työkalut- ja Resurssit-osiot, joissa on tietoa MCP-palvelimen käytettävissä olevista työkaluista ja resursseista. Lisätietoja on kohdassa Aiemmin luodun MCP-palvelimen työkalujen ja resurssien tarkasteleminen.

Yksityiskohdat

Tiedot-osiossa voit määrittää työkalun perustiedot.

Täällä voit tarkastella ja päivittää:

• Nimi: Tämä on työkalun nimi. Tämä nimi näkyy agenttisi työkaluluettelossa. Valitse nimi, joka osoittaa selvästi työkalun funktion.

• Kuvaus: Työkalun kuvaus. Luotu orkestrointi käyttää tätä kuvausta määrittäessään, milloin agenttisi tulee käyttää työkalua. Kirjoita selkeät ja tarkat kuvaukset siitä, mitä työkalu tekee ja milloin sitä tulee käyttää.

• Lisätiedot:

  • Salli agentin päättää dynaamisesti, milloin työkalua käytetään: Kun tämä vaihtoehto valitaan, agentti voi käyttää muodostavaa orkestrisointia työkalun käytön määrittämiseen. Jos tämä vaihtoehto ei ole valittuna, agentti käyttää työkalua vain, kun se on nimenomaisesti kutsuttu aiheesta. (Oletusarvoisesti tämä asetus on valittuna, kun muodostava orkestrointi on käytössä.)
  • Kysy loppukäyttäjältä ennen suorittamista: Pyydä loppukäyttäjältä vahvistusta ennen työkalun suorittamista käyttäjän keskustelutoiminnossa. Tämän asetuksen oletusarvona on Ei .
  • Todennus: Valitse, käytetäänkö työkalussa käyttäjän (loppukäyttäjä) vai tekijän (tekijän antama) tunnistetietoja. Oletusarvoisesti käyttäjän todentaminen on voimassa.
  • Kuvaus: Vaihtoehtoisesti voit lisätä kuvauksen työkalusta, jonka asiakaspalvelija näyttää käyttäjälle, kun se haluaa suorittaa työkalun. Tämän kuvauksen avulla käyttäjä tietää, mitä häntä pyydetään todentamaan.

Syötteet

Täällä voit tarkastella ja määrittää työkalun syötteitä. Syötteitä käytetään tietojen keräämiseen käyttäjältä työkalun vaadittujen syötteiden täyttämiseksi. Tiedot näytetään taulukkona, yksi rivi jokaista syötettä kohden.

Oletusarvon mukaan kunkin syötteen Täyttö käyttäen sarakearvoa -asetuksena on Dynaamisesti täytetty tekoäly. Agentti yrittää poimia arvon käytettävissä olevasta kontekstista, kuten käyttäjän viestistä. Jos sopivaa arvoa ei löydy, se luo kysymyksen, jossa käyttäjältä pyydetään arvoa. Valitse Mukauta , jos haluat käyttää tarkempia mukautuksia syötekokoelmaa ja täyttöä varten:

• Näyttönimi ja Kuvaus: Miten syöte näytetään käyttäjälle.
• Tunnista muodossa: miten käyttäjän vastaus tulkitaan, esimerkiksi tekstimerkkijonoksi tai yhdistettynä esimääritettyyn entiteettiin.
• Uudelleenyritysten logiikka: Jos agentti ei tunnista entiteettiä käyttäjän lausekkeessa, se voi esittää kysymyksen uudelleen.
• Syötteiden vahvistus: Määritä käyttäjän syötteelle ylimääräinen vahvistustoiminta entiteettityypin oletusarvon lisäksi.

Voit myös ohittaa syötteen eksplisiittisellä arvolla sen sijaan, että antaisit agentin poimia sen. Jos haluat määrittää ohituksen, määritä Täyttö käyttämällä -arvoksi Mukautettu arvo ja anna arvo, valitse muuttuja tai käytä Power Fx -kaavaa. Jos syöte ohitetaan, agentti ei pyydä käyttäjältä arvoa.

Valmistuminen

Täällä voit valita, mitä haluat tapahtuvan, kun työkalu on suoritettu.

Voit pyytää agenttia luomaan käyttäjälle automaattisesti tilannekohtaisen vastauksen kyselyn ja työkalun tuloksen perusteella.

Vaihtoehtoisesti voit luoda tietyn, muotoillun vastauksen työkalullesi palautettavaksi. Voit lisätä viittauksia työkalun tulostemuuttujiin muuttujan valitsimen avulla. Voit myös muotoilla vastausta Power Fx -kaavojen avulla.

Valitse Suorittamisen jälkeen yksi muutamista eri vaihtoehdoista sille, miten työkalun pitäisi vastata käyttäjälle työkalun suorittamisen jälkeen:

• Älä vastaa (oletus): Agentti sisällyttää työkalutulosteen vastaukseensa
• Kirjoita vastaus luomalla tekoäly: Anna tekoälyn luoda tilannekohtainen vastaus työkalutulosteiden avulla
• Lähetä tietty vastaus: luo mallillinen vastaus muuttujan lisäämisen avulla
• Mukautuvan kortin lähettäminen: luo monipuolisia vuorovaikutteisia vastauksia painikkeiden ja toimintojen avulla

Voit myös määrittää, mitkä tulostemuuttujat ovat agentin ja muiden työkalujen käytettävissä.

Työkalun valinta ja syötekokoelma

Kun määrität työkalun Copilot Studiossa, annat myös tietoja, jotka kuvaavat sen tarkoitusta. Näiden tietojen avulla asiakaspalvelija tunnistaa, milloin työkalua käytetään. Työkalun kuvaus auttaa myös orkestroijaa generatiivisen tekoälyn avulla luomaan kysymyksiä tarpeen mukaan syötteiden keräämiseksi. Asiakaspalvelijasi voi käyttää kysymyksiä kerätäkseen tietoa työkalun käyttöön tarvittavien syötteiden täyttämiseksi. Tämän vuoksi sinun ei tarvitse luoda manuaalisesti kysymyssolmuja kerätäksesi kaikki tarvittavat syötteet, kuten työnkulun syötteet. Agentin orkestraattori hoitaa syötteen keräämisen puolestasi suorituksen aikana.

Agentti ottaa huomioon useita tekijöitä työkalun valinnan määrittämiseksi:

• Työkalun nimi ja kuvaus
• Nykyinen keskustelukonteksti
• Käyttäjän tarkoitus johdettuna viestistä
• Käytettävissä olevat syötteet ja tulosteet
• Keskustelun edellisen työkalun käyttö

Kun työkalut käyttävät generatiivista tilaa, ne palauttavat oletuksena tietonsa takaisin agentille. Työkaluvastauksen avulla asiakaspalvelija voi luoda kontekstuaalisen vastauksen käyttäjän kyselyyn. Vaihtoehtoisesti voit ohjata työkaluasi vastaamaan heti, joko luomalla viestin tai luomalla eksplisiittisen viestin.

Vinkki

Kun käytät työkalun tuottamia kysymyksiä, kerro käyttäjille, että tekoäly loi osan keskustelusta.

Voit esimerkiksi lisätä ylimääräisen viestin Keskustelun käynnistä järjestelmä -ohjeaiheessa. Tämä aihe määrittää käyttäjillesi näytettävän viestin, kun uusi keskustelu alkaa.

Olemassa olevan työkalun kutsuminen aiheen sisältä

Voit kutsua työkalun suoraan aiheen sisältä. Käyttötapauksesta riippuen saatat käyttää työkalua osana laajempaa aihetta, jossa käytetään enemmän solmuja. Tai kuten sää esimerkissä, solmun lisääminen aiheeseen saattaa olla ainoa asia, jota et tarvitse.

Työkalun kutsuminen aiheen sisältä:

1. Siirry Copilot Studiossa sen agentin Aiheet-sivulle, jota haluat muokata.

2. Luo uusi aihe ja anna sille nimi, esimerkiksi Hae sää.

3. Lisää sopivat Trigger-lauseet. Jos haluat jatkaa samaa sääesimerkkiä edellisestä vaiheesta, laukaisulausekkeet voivat olla seuraavat:

   • sataako
   • kuluvan päivän ennuste
   • hae sää
   • millainen sää on

4. Valitse Lisää solmu (+) ja valitse sitten Lisää työkalu. Valitse työkalu käytettävissä olevista työkaluista. Käytettävissä on kolme välilehteä, jotka näyttävät erityyppiset työkalut:

   • Perustyökalut
   • Yhdistin
   • Työkalu

   Toiminto-solmusi on nyt lisätty aiheeseesi.

5. Valitse Tallenna.

MCP-yhdistimen tiedot

MCP-liittimen osalta voit tarkastella MCP-työkalujen nimiä ja kuvauksia sekä resursseja, jotka MCP-liitin tuo saataville. Työkalujen ja resurssien tiedot näytetään taulukossa, yksi rivi kullekin työkalulle.

Työkaluissa huomioitavat todentamisen seikat

Jotkin työkalut edellyttävät, että todentaminen toimii oikein, kuten dynaaminen kehote tai muut, jotka kutsuvat Dataverse-ohjelmointirajapintaa. Asianmukainen todentamismääritys takaa suojauksen ja takaa samalla sulavan käyttökokemuksen.

Työkalut suoritetaan aina agentin suorituspalvelussa käyttäjäkontekstissa, eikä niitä voi suorittaa, ellei todentamista käytetä. Kahta todennustyyppiä tuetaan:

• Käyttäjän todentaminen: Agentti käyttää käyttäjän tunnistetietoja palveluun todentamiseen. Tämä menetelmä varmistaa, että käyttäjät käyttävät vain tietoja, jotka heillä on oikeus nähdä.
• Copilot author authentication: Agentti käyttää tekijänsä tunnistetietoja todentamisessa palvelussa. Käytä tätä todennustilaa jaetuille resursseille tai kun käyttäjien ei pitäisi tarvita yksittäisiä käyttöoikeuksia.

Työkalun testaaminen

Kun generatiivinen orkestrointi tapahtuu, orkestroija valitsee työkalusi, kun se katsoo sen olevan relevantti käyttäjäkyselyssä.

Vaihtoehtoisesti voit kutsua aiemmin luotua työkalua aiheen sisältä.

Työkalun ottaminen käyttöön tai poistaminen käytöstä asiakaspalvelijassa

Voit ottaa työkalun käyttöön tai poistaa sen käytöstä asiakaspalvelijalle työkalun määrityssivulla. Työkalun poistaminen käytöstä estää asiakaspalvelijaa käyttämästä työkalua, mutta työkalu on edelleen yhteydessä asiakaspalvelijaan ja se voidaan ottaa myöhemmin uudelleen käyttöön. Kun lisäät työkalun agenttiin, se on oletuksena päällä.

Työkalun sammuttaminen agentissa:

1. Siirry asiakaspalvelijaan ja valitse asiakaspalvelijan Työkalut-sivu .
2. Valitse työkalu siirtyäksesi työkalun määrityssivulle.
3. Sammuta työkalu määrityssivun yläreunassa Käytössä-kytkimellä .
4. Ota muutos käyttöön valitsemalla Tallenna .

Työkalu näkyy edelleen asiakaspalvelijan työkalujen luettelossa, mutta se ei ole enää käytössä.

Työkalun poistaminen asiakaspalvelijalta

Työkalun sammuttaminen estää työkalun käytön, mutta antaa sinulle myös joustavuutta käynnistää se myöhemmin uudelleen. Voit myös poistaa työkalun pysyvämmin agentiltasi. Työkalun poistaminen asiakaspalvelijalta:

1. Siirry asiakaspalvelijaan ja valitse asiakaspalvelijan Työkalut-sivu .
2. Etsi työkalu työkaluluettelosta ja vie hiiren kursori työkalun nimen päälle. Valitse ... (Lisää vaihtoehtoja).
3. Valitse Poista. Vahvistusikkuna tulee näkyviin.
4. Poista työkalu valitsemalla Poista .

Työkalu katoaa asiakaspalvelijan työkaluluettelosta.

Note

Voit poistaa työkaluja vain asiakaspalvelijan työkalujen sivulta. Et voi poistaa työkaluja Copilot Studio Tools -pääsivulta.

Liittyvä sisältö

• Liittimien käyttäminen
• Kehotteiden käyttäminen
• Agentin työnkulkujen käyttäminen agentissa
• Mallin kontekstin protokolla (MCP)
• Työkalujen lisääminen REST-ohjelmointirajapinnasta
• Osaamisalueiden käyttäminen
• Asiakastyökalut
• Tietokoneen käyttö (esikatselu)