Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Monivaiheisen pyynnön koko kulku

Oppitunti 4 / 14 Päivitetty 29. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Pyynnöstä vastaukseen
  2. Vaihe 1: pyynnön vastaanotto ja analyysi
  3. Vaihe 2: alagenttien käynnistäminen
  4. Vaihe 3: tutkimus ja keskustelu
  5. Vaihe 4: pääagentin synteesi
  6. Mitä vastaanotat
  7. Suoratoisto (Streaming)
  8. Viiveen vaikutukset
  9. Keskeiset asiat

Pyynnöstä vastaukseen

Pyynnön lähettämisen ja vastauksen ilmestymisen välillä tapahtuu huomattavasti enemmän kuin tavallisessa LLM-kutsussa. Tämän polun seuraaminen askel askeleelta auttaa sinua tulkitsemaan epätavallista viivettä, liian yleisiä vastauksia tai yllättäviä token-kuluja.

Vaihe 1: pyynnön vastaanotto ja analyysi

Kun pyyntösi saapuu mallille grok-4.20-multi-agent-0309, pääagentti aloittaa sen analysoinnilla. Se määrittää tehtävän luonteen – onko kyseessä faktatutkimus, vertaileva analyysi vai synteesi – arvioi tutkittavien näkökulmien määrän, tunnistaa tarvittavat työkalut ja päättää strategiansa alagenttien tehtävien jakamiseksi.

Et näe tätä alkuperäistä analyysiä: se on osa pääagentin laskutettavaa päättelyä, eikä se koskaan ilmesty vastaukseen. Tämä on myös vaihe, jossa epäselvä sanamuoto aiheuttaa eniten haittaa, sillä kaikki myöhempi toiminta rakentuu tämän ensivaikutelman varaan.

Vaihe 2: alagenttien käynnistäminen

Pääagentti jakaa tämän jälkeen osatehtävät. Jokainen alagentti saa erityisen ohjeistuksen ja aloittaa työskentelyn rinnakkain muiden kanssa. Aiemmin mainitussa eurooppalaisia pilvistrategioita koskevassa pyynnössä jako näyttäisi tältä: yksi agentti tutkii palveluntarjoajien tuoreimpia ilmoituksia, toinen analysoi sääntelynäkökohtia (GDPR, AI Act), kolmas vertaa hinnoittelutasoja ja neljäs tarkastelee teknistä dokumentaatiota.

Kun käytössä on 16 agenttia, jako tarkentuu ja kattaa useampia näkökulmia: jokainen palveluntarjoaja voi saada oman tutkijansa, ja sääntelynäkökohdat voidaan jakaa useamman lainkäyttöalueen kesken.

Vaihe 3: tutkimus ja keskustelu

Alagentit eivät työskentele eristyksissä. Ne käyttävät sisäänrakennettuja työkaluja – web_search, x_search, code_execution ja muita – vaihtavat tietoja keskenään päällekkäisyyksien välttämiseksi ja johtolankojen tarkentamiseksi sekä ilmoittavat pääagentille odottamattomista löydöistä, jotka ansaitsevat lisätutkimusta. Tämä sisäinen vuorovaikutus erottaa moniagenttijärjestelmät yksinkertaisista rinnakkaiskutsuista: agentti, joka löytää kollegansa tietoihin ristiriitaista informaatiota, voi ohjata tutkimusta uudelle uralle.

Tämä on myös pisin vaihe ja ehdottomasti kallein, sillä jokainen agentti tuottaa omat syöte-, tuloste- ja päättelytokeninsa. Kun pyyntö pyörii minuutin ilman, että tekstiä ilmestyy näkyviin, aika kuluu juuri tässä vaiheessa.

Vaihe 4: pääagentin synteesi

Kun alagentit ovat valmistuneet tai päättelybudjetti on käytetty loppuun, pääagentti ottaa ohjat ja suorittaa aina saman sekvenssin. Se kerää ensin kaikki tulokset ja poistaa päällekkäisyydet – pilvipyyntötapauksessa kolme agenttia on todennäköisesti löytänyt saman alueellisen saatavuusilmoituksen, jonka pitäisi esiintyä vain kerran. Se jäsentää tiedot pyytämääsi muotoon, siteeraa lähteitä tarvittaessa ja tuottaa lopulta varsinaisen vastauksen.

Tässä vaiheessa ratkeaa tuloksen koettu laatu: samalla tutkimuksella saat joko kaiken kattavan kappaleen tai luettavan vertailutaulukon riippuen siitä, kuinka tarkasti olet kuvannut odottamaasi lopputuotetta.

Mitä vastaanotat

Vastaus sisältää pääagentin kirjoittaman tekstin – sen synteesin –, kaikkien agenttien (pääagentti mukaan lukien) tekemät työkalukutsut ja, jos olet ottanut käyttöön parametrin use_encrypted_content=True, salatun sisältölohkon. Nämä työkalukutsut ovat ainoa ikkunasi kulissien takana tehtyyn työhön.

Muu ei koskaan saavuta sinua: ei alagenttien sisäistä päättelyä avotekstinä, ei niiden keskinäistä viestintää eikä pääagentin valitseman delegointistrategian yksityiskohtia. Siksi on turha rakentaa valvontatyökaluja näiden elementtien ympärille – ne eivät koskaan poistu mallista.

Suoratoisto (Streaming)

Suoratoistotilassa näet pääagentin vastauksen rakentuvan vähitellen. Parametri verbose_streaming vie tämän pidemmälle ja lähettää sinulle työkalukutsut sitä mukaa kun ne tapahtuvat, mikä antaa sinulle suoran näkymän agenttien toimintaan.

Hyöty on todellinen pitkissä pyynnöissä: voit seurata verkkohakujen laukeamista yksi toisensa jälkeen agenttien työskennellessä ja näyttää käyttäjällesi jotain muuta kuin staattista latausindikaattoria.

Viiveen vaikutukset

Moniagenttijärjestelmä on luonnostaan hitaampi kuin tavallinen kutsu kolmesta kumulatiivisesta syystä: alagentit tekevät työtä rinnakkain, mutta koordinoinnilla on hintansa; pääagentin on odotettava kaikkia tuloksia ennen synteesin tekemistä; ja viive kasvaa mukana olevien agenttien määrän myötä.

Tästä seuraa yksinkertainen suunnittelusääntö. Interaktiiviseen käyttöön – kuten keskustelubottiin tai hakukenttään – pysy 4 agentissa. Varaa 16 agenttia asynkronisiin tehtäviin: taustalla generoitavaan raporttiin, yön yli jatkuvaan valvontatehtävään tai analyysiin, jonka tuloksen käyttäjä tarkistaa myöhemmin.

Keskeiset asiat

  • Kulku noudattaa neljää vaihetta: analyysi → delegointi → tutkimus → synteesi
  • Alagentit työskentelevät rinnakkain ja vaihtavat tietoja keskenään
  • Vastaanotat vain pääagentin vastauksen ja työkalukutsut
  • Suoratoisto parametrilla verbose_streaming mahdollistaa toiminnan seuraamisen reaaliajassa
  • Viive on suurempi kuin tavallisessa kutsussa, erityisesti käytettäessä 16 agenttia