Työkalujen lisääminen mukautettuihin agentteihin

Työkalut ovat rakennusosia, joiden avulla agentti voi olla vuorovaikutuksessa ulkoisten järjestelmien kanssa. Työkalut laajentavat agentin toimintoja, jolloin se voi reagoida käyttäjän pyyntöihin tai itsenäisiin käynnistimiin suorittamalla erilaisia toimintoja. Jokainen työkalu edustaa tiettyä ominaisuutta, jonka agentti voi suorittaa. Voit esimerkiksi varustaa agenttisi työkaluilla, jotka tekevät seuraavanlaisia asioita:

• Sähköpostien lähettäminen Office 365 Outlook -yhdistimen avulla
• Nykyisen säätilan ja sääennusteiden tarkistaminen
• Dataversen tietojen lukeminen ja kirjoittaminen
• Viestien lukeminen ja julkaiseminen Teamsiin

Työkalujen lisäysmekanismit

Voit laajentaa mukautetun agentin ominaisuuksia lisäämällä yhden tai useamman työkalun. Agentti voi vastata työkalujen avulla käyttäjille automaattisesti käyttämällä generatiivista orkestrointia. Työkaluja voidaan myös nimenomaisesti kutsua aiheessa.

Agentti voi vastata käyttäjälle ja valita generatiivisen orkestroinnin (joka on käytössä oletusarvoisesti) automaattisesti sopivimman työkalun tai aiheen taikka tehdä hakuja koko tietämyksessä. Tämä orkestrointitila luo entistä dynaamisemman ja älykkään keskustelukokemuksen.

Perinteisessä tilassa (generatiivinen orkestrointi pois käytöstä) agentti voi hyödyntää vain aiheita käyttäjälle vastattaessa. Agentti voidaan silti kuitenkin suunnitella kutsumaan työkaluja nimenomaisesti aiheista.

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 yhdistin: valittavana on valmiita yhdistimiä tuhansiin suosittuihin Microsoftin ja muiden kuin Microsoftin palvelujen ohjelmointirajapintoihin.
  • Mukautettu yhdistin: Yhteyden määrittäminen mukautettuun palveluun tai järjestelmään sekä mukautettujen työkaluvaihtoehtojen ottaminen käyttöön tavoin Power Platform -yhdistimien 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äilö liittyvien työkalujen joukolle.
• Asiakasohjelmatyökalu: tapahtuma-aktiviteetin lähettäminen asiakasohjelmaan, jolloin asiakasohjelma suorittaa toiminnon ja palauttaa vastauksen.

Lisätietoja taidoista ja asiakasohjelmatyökaluista on Liittyvä sisältö -osan linkeissä.

Uuden työkalun luominen ja lisääminen agenttitasolla

Uusien työkalujen luonti suoraan Copilot Studiossa sujuvoittaa kehittämisprosessi ja varmistan asianmukaisen integroinnin agentin kanssa. Agenttiin lisätyt työkalut ovat käytettävissä automaattiseen orkestrointiin koko agenttikeskustelujen keston ajan.

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 lisättävän työkalun tyyppi avautuvasta luettelosta:

   • Kehote
   • Agentin työnkulku
   • Tietokoneen käyttö
   • Mukautettu liitin
   • Mallin kontekstin protokolla
   • REST API

   

6. Suorita valitun työkalutyypin mukaiset määritysvaiheet. Jos valintasi on esimerkiksi Kehote, seuraavat vaiheet on suoritettava:

   • Kehotteen mallin ja ohjeiden määrittäminen
   • Syöteparametrien määrittäminen
   • 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ä.

Uusi työkalu näkyy agentin Työkalut-sivulla.

Työkalumäärityksen tarkasteleminen ja muutosten tekeminen

Työkalun määritystä voi tarkastella ja muokata koska tahansa: siirry agentin Työkalut-sivulla ja valitse työkalu työkaluluettelosta.

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

• Tiedot
• 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.

Tiedot

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

Siellä voi tarkastella ja päivittää seuraavat:

• Nimi: Työkalun nimi. Tämä nimi näkyy agentin 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 selkeitä ja tarkkoja kuvauksia, mukaan lukien työkalun tehtävä ja milloin sitä pitäisi käyttää.

• Lisätiedot:

  • Salli agentin päättää dynaamisesti, milloin työkalua käytetään: Kun tämä vaihtoehto on valittu, agentti voi päätellä generatiivisen orkestroinnin avulla, milloin työkalua päätetään. 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: Käyttäjän keskustelukokemuksessa agentilta kysytään vahvistus ennen työkalun suorittamista. Tämä vaihtoehto on oletusarvoisesti 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. Käyttäjä tietää tämän kuvauksen perusteella, mitä heitä pyydetään todentamaan.

Syötteet

Täällä voidaan tarkastella ja määrittää työkalun syötteitä. Syötteiden avulla kerätään käyttäjältä tietoja, joilla täytetään työkalun tarvitsemat syötteet. Tiedot näytetään taulukkona, ja kutakin syötettä vastaa yksi rivi.

Oletusarvoisesti kunkin syötteen Täyttömenetelmä-sarakkeen arvona on Täytä dynaamisesti käyttäen 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. Voit käyttää yksityiskohtaisempia syötteiden keräämisen ja täyttämisen mukautuksia valitsemalla Mukauta:

• Näyttönimi ja kuvaus: syötteen näkyminen käyttäjälle.
• Tunnista kohteena: käyttäjän vastauksen tulkinta esimerkiksi tekstimerkkijonona tai valmiiksi määritettyyn entiteettiin määritettynä.
• Uudelleenyrityslogiikka: jos agentti ei tunnista entiteettiä käyttäjän ilmauksesta, se voi kysyä kysymyksen uudelleen.
• Syötteen vahvistus: käyttäjän syötteen lisävahvistuksen määrittäminen entiteettityypin oletusarvon lisäksi.

Voit myös ohittaa syötteen eksplisiittisellä arvolla sen sijaan, että antaisit agentin purkaa sen. Ohitus voidaan määrittää määrittämällä Täyttömenetelmä-arvoksi Mukautettu arvo ja syöttämällä arvon, valitsemalla muuttujan tai käyttämällä Power Fx -kaavaa. Jos syöte ohitetaan, agentti ei kysy arvoa käyttäjältä.

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. Vastaus voidaan lisäksi muotoilla Power Fx -kaavojen avulla.

Valitse Suorittamisen jälkeen -kohdassa jokin eri vaihtoehdoista sille, miten työkalu vastaa käyttäjälle työkalun suorittamisen jälkeen:

• Älä vastaa (oletus): agentti sisällyttää työkalun tuloksen vastaukseen
• Kirjoita vastaus generatiivisen tekoälyn avulla: tekoäly saa luoda tilannekohtaisen vastauksen työkalun tulosten avulla
• Lähetä tietty vastaus: mallivastaus laaditaan lisäämällä muuttuja
• Lähetä mukautuva kortti: painikkeita ja toimintoja sisältävien monipuolisten, vuorovaikutteisten vastausten luonti

Lisäksi voidaan määrittää, mitkä tulosmuuttujat ovat agentin ja muiden työkalujen käytettävissä.

Työkalun valinta ja syötekokoelma

Kun työkalu määritetään Copilot Studio, annetaan myös tiedot, joilla kuvataan 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
• Kulloisenkin keskustelun konteksti
• Viestistä johdettu käyttäjän tarkoitus
• Käytettävissä olevat syötteet ja tulokset
• Keskustelussa käytetty edellinen työkalu

Generatiivista tilaa käytettäessä työkalut palauttavat oletusarvoisesti tiedot takaisin 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.

Tippi

Työkalusta luotuja kysymyksiä käytettäessä käyttäjille ilmoitetaan, että tekoäly on luonut osan keskustelusta.

Järjestelmän Keskustelun aloitus -aiheeseen voidaan esimerkiksi lisätä ylimääräinen viesti. Tämä aihe määrittää käyttäjillesi näytettävän viestin, kun uusi keskustelu alkaa.

Olemassa olevan työkalun kutsuminen aiheen sisällä

Työkalu voidaan kutsua nimenomaisesti aiheessa. Tilanteen mukaan työkalua voidaan käyttää useita solmuja käyttävän laajan aiheen osana. Vaihtoehtoisesti aiheeseen tarvitsee lisätä vain solmu, kuten säätietoesimerkissä.

Työkalun kutsuminen aiheen sisällä:

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

2. Luo uusi aihe ja anna sen nimeksi esimerkiksi Hae säätiedot.

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 sitten Lisää työkalu. Valitse työkalu käytettävissä olevista työkaluista. Kolmessa välilehdessä on erityyppisiä työkaluja:

   • Perustyökalut
   • Yhdistin
   • Työkalu

   Toiminto-solmu lisätään nyt aiheeseen.

5. Valitse Tallenna.

MCP-yhdistimen tiedot

MCP-yhdistimen osalta voidaan tarkastella niiden MCP-työkalujen ja -resurssien nimiä ja kuvauksia, joiden käytön MCP-yhdistin mahdollistaa. Työkaluja ja resursseja koskevat tiedot näytetään taulukossa siten, että kullakin työkalulla on oma rivi.

Työkalujen todentamiseen liittyviä seikkoja

Joissakin työkaluissa todennuksen on toimittava oikein, kuten dynaamisessa kehotteessa tai muissa, joissa kutsutaan Dataversen ohjelmointirajapinta. Oikein määritetty todennus varmistaa suojauksen samalla, kun käyttökokemus pysyy sujuvana.

Työkalut suoritetaan aina agentin suorituspalvelussa, eikä niitä voi suorittaa, ellei todennus ole käytössä. 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. Tätä todennusmenetelmää käytetään, kun kyse on jaetuista resursseista tai kun käyttäjien ei pitäisi tarvita omia käyttöoikeuksia.

Työkalun testaaminen

Generatiivisessa orkestroinnissa orkestroija valitsee työkalun, kun sen katsotaan liittyvän käyttäjän kyselyyn.

Vaihtoehtoisesti voit kutsua olemassa olevaa työkalua aiheen sisällä.

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 työkalu lisätään agenttiin, se otetaan oletusarvoisesti käyttöön.

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 ... (Lisää vaihtoehtoja)
3. Valitse Poista. Vahvistusikkuna avautuu:
4. Poista työkalu valitsemalla Poista.

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

Muistiinpano

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

Liittyvä sisältö

• Yhdistimien käyttäminen
• Kehotteiden käyttäminen
• Agentin työnkulkujen käyttäminen agentissa
• Mallin kontekstin protokolla (MCP)
• Työkalujen lisääminen REST API ‑ohjelmointirajapinnasta
• Osaamisalueiden käyttäminen
• Asiakastyökalut
• Tietokonekäyttö (esiversio)