Työkalujen lisääminen mukautettuihin agentteihin

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 liittimen avulla
• 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. Agentti voidaan kuitenkin suunnitella kutsumaan työkaluja nimenomaisesti osana eri aiheita.

Työkalujen lisäämiseen agenttiin on käytettävissä useita mekanismeja:

• 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. Yhdistin tarvitsee organisaation tarkastelu- ja jako-oikeudet, jotta agentti voi käyttää yhdistintä.
• 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.

Työkalumaisen toiminnan lisäämiseen agenttiin on käytettävissä lisäksi kaksi muuta mekanismia:

• 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
   • Mallikontekstiprotokolla
   • REST API

   

6. Suorita valitun työkalutyypin mukaiset 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 agentillesi. 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:

• Lisätietoja
• 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.

Lisätietoja

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 työkalun tehtävän selkeästi ilmaiseva nimi.

• Kuvaus: Työkalun kuvaus. Generatiivinen orkestrointi päättelee tämän kuvauksen perusteella, milloin agentin olisi käytettävä 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ätä vaihtoehtoa ei valita, agentti käyttää työkalua vain, kun sitä nimenomaisesti kutsutaan aiheesta. (Vaihtoehto valitaan oletusarvoisesti, kun generatiivinen orkestrointi on otettu käyttöön.)
  • 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äytetään käyttäjän todentamista.
  • 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 loppuun.

Voit määrittää agentin luomaan käyttäjälle automaattisesti tilannekohtaisen vastauksen käyttäjän kyselyn ja työkalun tuloksen perusteella.

Vaihtoehtoisesti voit luoda tietyn muotoillun vastauksen, jonka työkalu palauttaa. Viitteet tulosmuuttujiin voidaan lisätä työkalusta 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

Lisäksi voidaan määrittää, mitkä tulosmuuttujat 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. Agenttiorkestroija käsittelee syötteiden kokoamisen 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 tulokset
• Keskustelussa käytetty edellinen työkalu

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 työkalu voidaan ohjeistaa vastaamaan aina heti joko luomalla viesti tai laatimalla selkeä viesti.

Olemassa olevan työkalun kutsuminen aiheen sisällä

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ällä:

1. Siirry Copilot Studiossa muokattavan agentin Topics -sivulle.

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. Kolmessa välilehdessä on erityyppisiä työkaluja:

   • Perustyökalut
   • Yhdistin
   • 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ökalujen todentamiseen liittyviä seikkoja

Jotkin työkalut edellyttävät, että todentaminen toimii oikein, kuten dynaaminen kehote tai muut, jotka kutsuvat Dataverse-ohjelmointirajapintaa. Oikein määritetty todennus varmistaa suojauksen samalla, kun käyttökokemus pysyy sujuvana.

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 voivat käyttää 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 myös poistaa pysyvämmin agentistasi. 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.

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)