Michael JohnsonCloudflare esitteli Web Search API:n 2. lokakuuta 2026 AI Gatewayn kautta. Se on verkkohakupalvelu tekoälyagenteille ja sovelluksille. Aluksi yhtiö otti käyttöön Ceramic.ai:n, Exan ja Linkupin. Kahdeksantena lokakuuta tarkistettu, 2. lokakuuta päivitetty virallinen yleiskatsausdokumentaatio määrittelee tuotteen avoimeksi betaksi.
Kehittäjän kannalta tärkein muutos on mahdollisuus lisätä haku olemassa olevaan mallien käyttöympäristöön. AI Gateway -integraation kuvauksen mukaan hakupyynnöt saavat samat lokit, analytiikan, laskutuksen ja käyttöoikeuksien hallintatyökalut kuin mallipyynnöt. Näin hakua voidaan käsitellä erillisenä ja seurattavana vaiheena agentin tehtävän suorituksessa.
Miksi agentti tarvitsee hakupyyntöjä
Cloudflare kertoo julkistuksessaan käytännön ongelmasta: agentti saattaa arvata tarvittavan sivun osoitteen, jolloin virheelliseen URL-osoitteeseen tehty pyyntö palauttaa 404-virheen. Hakutyökalu tarjoaa vaihtoehtoisen toimintatavan: se muodostaa kyselyn, hakee aiheeseen liittyvien materiaalien osoitteet ja hyödyntää löydettyjä tietoja vastauksen laatimisessa.
Toinen käyttötapa liittyy mallin koulutuksen jälkeen tapahtuneisiin muutoksiin. Cloudflare mainitsee erikseen tuoreet tapahtumat, muuttuvat API:t ja uudet työkalujulkaisut. Koodin kirjoittamista avustavalle agentille hyödyllinen haku voi kohdistua tietyn kirjastoversion dokumentaatioon tai äskettäin lisättyyn parametriin. Tällaisessa prosessissa haku toimittaa aineistoa kontekstiin, ja sovellus päättää, mitkä tulokset välitetään mallille.
Käytännön neuvo tiimille: säilyttäkää löydetyn katkelman yhteydessä sen URL-osoite ja hakulauseke. Näin vastauksen tarkistaja voi selvittää, mihin aineistoon agentti tukeutui. Versioita koskevissa tehtävissä hakulausekkeeseen kannattaa myös sisällyttää tuotteen nimi ja haluttu versio.
Uuden API:n käyttöönotto
Dokumentaatiossa kuvataan kaksi kutsutapaa: REST API ulkoisesta taustapalvelusta ja AI binding Cloudflare Workersissa. Palveluntarjoaja valitaan provider-parametrilla. Kaikki kolme palvelua palauttavat tulokset yhteisessä muodossa: otsikoina, URL-osoitteina ja kuvauksina. Tämä helpottaa palveluntarjoajan vaihtamista sovelluksen vastaustenkäsittelyssä.
Yhtenäinen muoto sopii oman hakutyökalusovittimen rakentamiseen. Sen tehtävänä on ottaa vastaan agentin pyyntö, kutsua valittua palveluntarjoajaa ja välittää valitut tulokset mallille. Sovellustasolla on erikseen päätettävä, milloin hakutuloksen kuvaus riittää ja milloin löydetty sivu on avattava tietyn väitteen tarkistamiseksi.
AI Gatewayn sisäänrakennetut palvelinpuolen työkalut mainitaan julkaisua käsittelevässä kirjoituksessa tulevana ominaisuutena. Cloudflare kertoo, että verkkohaku tulee olemaan yksi ensimmäisistä tällaisista työkaluista. Julkaisun yhteydessä esitelty käyttötapa edellyttää omaa orkestrointia: työkalukutsun käsittelyä ja hakuvastauksen välittämistä seuraavaan mallipyyntöön.
Mitä ehdoista on vahvistettu
Dokumentaation maksuehtojen mukaan pyynnöt voi maksaa AI Gateway -krediiteillä palveluntarjoajan julkisen API-hinnan mukaisesti ilman Cloudflaren lisämaksua. Tuettua on myös Bring Your Own Key eli palveluntarjoajan oman API-avaimen käyttö. Tätä vaihtoehtoa valitsevan tiimin kannattaa sopia etukäteen, missä kulutusta seurataan ja laskutusta tarkistetaan.
Tarkistetuissa julkistuksessa ja yleiskatsaussivulla ei ilmoiteta konkreettisia hintoja eikä pyyntöjen määrällisiä kiintiöitä. Siksi integraation budjetti kannattaa laskea valitun palveluntarjoajan hinnaston tarkistamisen jälkeen. Hyväksymistestit kannattaa rakentaa omien tehtävien ympärille: sopivien lähteiden osuus, vastausaika, hakupyyntöjen määrä suoritettua tehtävää kohden ja virhetilanteiden käsittely.
Tietojen säilytys on erillinen kysymys. Zero Data Retention -kuvauksessa Cloudflare lupaa merkitä kumppanit, jotka tukevat ZDR:ää. Tietyn hakureitin osalta on tarkistettava erikseen palveluntarjoajan säilytysehdot ja AI Gatewayn lokiasetukset: julkistuksen mukaan hakupyynnöt kirjataan samalla havainnointijärjestelmään.
Palveluntarjoajat sitoutuvat myös noudattamaan Cloudflaren Verified bots -vaatimuksia: tunnistamaan bottinsa, huomioimaan robots.txt-tiedoston ja indeksointiohjeet, pitämään pyyntötiheyden kohtuullisena ja kunnioittamaan sivustojen omistajien toiveita. Web Search API:n yleiskatsaus vahvistaa, että jokaiseen tulokseen on liitettävä lähdelinkki.
Kehittäjille julkaisu tarjoaa selkeän tavan liittää verkkohaku agenttiin ja seurata sitä yhteisessä ympäristössä. Arviointi kannattaa aloittaa pienellä joukolla todellisia tehtäviä, valita palveluntarjoaja tietoisesti ja säilyttää vastauksissa lähdelinkit. Nämä valinnat ratkaisevat, kuinka hyvin löydetty aineisto auttaa sovellusta suorittamaan sille annetun tehtävän.