Mukautettuihin agentteihin työkalujen lisääminen

Työkalut ovat rakennuspalikoita, joiden avulla agentti voi olla vuorovaikutuksessa ulkoisten järjestelmien kanssa. Työkalut laajentavat agenttisi mahdollisuuksia, antaen agentille mahdollisuuden suorittaa erilaisia toimintoja käyttäjän pyyntöjen tai autonomisten laukaisijoiden perusteella. Jokainen työkalu edustaa tiettyä ominaisuutta, jonka agenttisi voi suorittaa. Esimerkiksi voit varustaa agenttisi työkaluilla, jotka suorittavat tehtäviä kuten:

• 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äämisen mekanismit agentteihin

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 nimenomaan aiheen sisällä.

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:

• Yhdistin: tietojen hakeminen tai toimintojen tekeminen yhdistämällä omiin ohjelmointirajapintoihin ja palveluihin Power Platform -yhdistimien avulla.
  • 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ä.
• Agentin työnkulku: vähintään yhden suoritettavan toiminnon sisältävän agentin työnkulun määrittäminen.
• Kehote: yksivaiheinen mallipohjainen kehote, joka voi viitata annettuihin tietoihin ja analysoida tietoja luomalla koodia.
• REST API: REST API -yhteyden määrittämien sekä vähintään yhden työkaluna lisättävän ohjelmointirajapinnan päätepisteen ja menetelmän valitseminen.
• Mallin kontekstin protokolla: työkalujen ja resurssien käyttäminen muodostamalla yhteys MCP-palvelimeen.
• Tietokonekäyttö: antaa agentille mahdollisuuden käyttää mitä tahansa järjestelmää, jossa on graafinen käyttöliittymä, sivustoissa ja työpöytäsovelluksissa painikkeiden ja valikkojen valitsemiseen sekä tekstin syöttämiseen näytöllä oleviin kenttiin.

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
   • Agentin työnkulku
   • 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. Luo uusi työkalu valitsemalla tilanteen mukaan Tallenna tai Julkaisu.

8. Valitse Lisää ja määritä. Työkalu lisätään agenttiin. Työkalun määrityssivu avautuu. Työkalumääritystä voi tarkastella ja muuttaa 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 määrityssivu avautuu. Tiedot näkyvät kolmessa osassa:

• Yksityiskohdat
• Syötteet
• Valmistuminen

Agentin työkaluina yhdistetyissä MCP-palvelimissa määrityssivu on erilainen kuin muissa työkalutyypeissä. Tiedot-osa on samankaltainen, mutta Syötteet- ja Valmistuminen-osien tilalla on Työkalut- ja Resurssit-osat, joissa on tietoja MCP-palvelimessa käytettävissä olevista työkaluista ja resursseista. Lisätietoja on Aiemmin luodun MCP-palvelimen työkalujen ja resurssien näyttäminen.

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 .
  • Todentaminen: Valitaan, käytetäänkö käyttäjän (Loppukäyttäjä) tai tekijän (Tekijän antamat) tunnistetietoja työkalussa. Oletusarvoisesti käyttäjän todentaminen on voimassa.
  • Kuvaus: Valinnaisena voidaan lisätä työkalun kuvaus, jonka agentti näyttää kuluttajalle, kun tämä 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. Agentti tunnistaa näiden tietojen avulla, milloin työkalua käytetään. Työkalun kuvaus auttaa myös orkestroijaa käyttämään generatiivista tekoäly luomaan kysymyksiä tarvittaessa keräämään syötteitä. Agentti voi kerätä kysymysten avulla tietoja työkalun käyttöön tarvittavien syötteiden täyttämiseen. Tämän vuoksi sinun ei tarvitse luoda manuaalisesti kysymyssolmuja kerätäksesi kaikki tarvittavat syötteet, kuten työnkulun syötteet. Agentin orkestroija käsittelee syötteiden keräyksen suorituksen aikana.

Agentti ottaa työkalun valinnassa huomioon useita tekijöitä:

• 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 generatiivista tilaa käytetään, työkalut palauttavat oletuksena tietonsa agentille. Agentti voi luoda työkalun vastauksen avulla tilannekohtaisen vastauksen käyttäjän kyselyyn. Vaihtoehtoisesti voit ohjata työkaluasi vastaamaan heti, joko luomalla viestin tai luomalla eksplisiittisen viestin.

Tip

Työkalusta luotuja kysymyksiä käytettäessä käyttäjille ilmoitetaan, että tekoäly on luonut 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ötapauksestasi riippuen saatat käyttää työkaluasi osana laajempaa aihetta, joka käyttää useita solmuja. Tai, kuten seuraavassa esimerkissä, yksittäisen toiminnon (työkalun) lisääminen aiheeseen voi olla kaikki mitä tarvitset.

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 käynnistinlauseet. Edellisen vaiheen säätietoesimerkkiä käytettäessä käynnistinlauseita voivat olla esimerkiksi seuraavat:

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

4. Valitse Lisää solmu (+) ja valitse sitten Lisää työkalu.

5. 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
   • Connector
   • Työkalu

   Toiminto-solmusi on nyt lisätty aiheeseesi.

6. 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:

• Loppukäyttäjän tunnistetiedot: Agentti todentaa palvelun käyttämällä käyttäjän tunnistetietoja. Tämä menetelmä varmistaa, että käyttäjät käyttävät vain tietoja, jotka heillä on oikeus nähdä.
• Tekijän antamat tunnistetiedot: Agentti käyttää palvelun todentamiseen tekijän tunnistetietoja. 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ä agentissa

Agentin työkalu voidaan ottaa käyttöön tai poistaa käytöstä työkalun määrityssivulla. Vaikka työkalun poistaminen käytöstä estää agenttia käyttämästä työkalua, työkalu on edelleen yhdistetty agenttiin ja voidaan ottaa takaisin käyttöön myöhemmin. Kun lisäät työkalun agenttiin, työkalu on oletuksena päällä.

Työkalun poistaminen käytöstä agentissa:

1. Siirry agenttiin ja valitse agentin Työkalut-sivu.
2. Siirry työkalun määrityssivulle valitsemalla työkalu.
3. Poista työkalu käytöstä määrityssivun yläosan Käytössä-vaihtopainikkeella.
4. Ota muutos käyttöön valitsemalla Tallenna .

Työkalu näkyy edelleen agentin työkaluluettelossa, mutta se ei ole enää käyttöönotettuna.

Työkalun poistaminen agentista

Työkalun poistaminen käytöstä estää työkalun käytön, mutta se voidaan kuitenkin ottaa joustavasti takaisin käyttöön myöhemmin. Työkalu voidaan poistaa myös pysyvästi agentista. Työkalun poistaminen agentista:

1. Siirry agenttiin ja valitse agentin Työkalut-sivu.
2. Etsi työkalu työkaluluettelosta ja siirrä osoitin työkalun nimen päälle. Valitse kolme pistettä (...).
3. Valitse Poista. Vahvistusikkuna avautuu:
4. Poista työkalu valitsemalla Poista.

Työkalu ei näy enää agentin työkaluluettelosta.

Note

Työkaluja voidaan poistaa vain agentin työkalusivulla. Työkaluja ei voi poistaa Copilot Studion Työkalut-pääsivulla.

Työkalujen rajoitukset agenteissa

• Generatiivista orkestrointia käytettäessä orkestroija voi käsitellä enintään 128 työkalua per agentti. Parhaan suorituskyvyn ja tulosten saavuttamiseksi suosittelemme kuitenkin rajoittamaan agentin työkalujen määrän enintään 25–30:een.
• Kun käytetään moniagenttiorkestrointia lapsiagenttien kanssa, lapsiagenteilla on oma orkestrointinsa ja ne voivat hallita omaa jopa 128 työkalun sarjaansa.

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)