AWS lisää suoran verkkohaku-API:n mukautetuille agenteille ja datankäsittelyputkille

Amazon Web Services julkisti itsenäisen verkkohaku-API:n Amazon Bedrock AgentCore -palvelulle 11. marraskuuta 2026. Sen avulla sovellukset voivat hakea järjestettyjä verkkohakutuloksia yhdellä allekirjoitetulla kutsulla ilman, että niiden tarvitsee luoda yhdyskäytävää. AWS veloittaa hauista 7 dollaria 1 000 kyselyä kohden. API on suunniteltu mukautetuille agenteille, datankäsittelyputkille ja olemassa oleville sovelluksille.

Ennen tätä julkaisua AgentCoren verkkohaku toimi AgentCore Gatewayn kautta, mikä edellytti yhdyskäytävää, verkkohakukohdetta ja Model Context Protocol (MCP) -asiakasohjelmaa. Uusi InvokeWebSearch toiminto käyttää sen sijaan AWS SDK:ita tai AWS CLI:tä sekä tavallisia AWS Identity and Access Management (IAM) -tunnistetietoja ja Signature Version 4 -todennusta, eikä erillistä API-avainta tai salaisuutta tarvita. Tulokset sisältävät tekstikatkelmia sekä saatavuuden mukaan sivujen otsikot, URL-osoitteet ja julkaisuajat.

Suora haku mukautettua työnkulun ohjausta varten

API on tarkoitettu mukautetuille agenttisilmukoille ja esimerkiksi LangChainin tai LlamaIndexin kaltaisille viitekehyksille sekä muille kuin agenttipohjaisille käyttötapauksille, kuten koontinäytöille, faktantarkistusputkille, sisällön rikastamiselle ja valvontajärjestelmille. Sen avulla kehittäjät voivat myös itse hallita uudelleenyrityksiä, välimuistia ja virheenkäsittelyä sen sijaan, että nämä tehtävät annettaisiin yhdyskäytävän hoidettaviksi.

Palvelu hakee tuloksia Amazonin ylläpitämästä verkkoindeksistä. AWS:n mukaan kyselyt käsitellään AWS:n sisällä eikä niitä lähetetä kolmannen osapuolen hakukoneelle. AWS kertoo myös, että toiminto käyttää samaa hakuinfrastruktuuria kuin Alexa+, Kiro, Quick ja muut Amazonin tuotteet.

Kysely voi olla enintään 200 merkkiä pitkä. Kutsuja voi pyytää 1–25 tulosta, ja niitä palautetaan enintään 25, kun maxResults ei ole määritetty. Verkkotunnusten sisällyttämis- ja poissulkemisluetteloissa voi kummassakin olla enintään 100 kohdetta, ja juuriverkkotunnus kattaa myös sen aliverkkotunnukset. Julkaisuaikasuodattimissa käytetään UTC-aikaleimoja RFC 3339 -muodossa, ja sekä publishedAfter että publishedBefore rajat sisältyvät aikaväliin.

Python-kutsut edellyttävät Boto3-versiota 1.43.127 tai uudempaa; tuki sisältyy myös langchain-aws-versioon 1.9.3 ja AgentCore Python SDK -versioon 1.26.0. AgentCoren konsolissa käyttäjät voivat testata kyselyitä määrittämällä tulosten määrän, päivämäärän ja verkkotunnuksen, tarkastella tulosten metatietoja ja kutsun viivettä sekä luoda koodikatkelman integraatiota varten tai luoda yhdyskäytäväkohteen.

Tunnistautuminen ja yksityisen verkon hallinta

Kutsujilla on oltava bedrock-agentcore:InvokeWebSearch käyttöoikeus AWS:n hallinnoimaan verkkohakutyökaluun. Kyseessä on sama toiminto ja resurssi, jota yhdyskäytävän palvelurooli käyttää. Palvelunhallintakäytännöillä voidaan asettaa suojarajoja kaikille tileille, jolloin organisaatiot voivat hallita suoraa hakua muiden AWS-käyttöoikeuksien rinnalla.

Yksityisissä aliverkoissa toimivien työkuormien kutsut voidaan reitittää AWS PrivateLinkin avulla virtuaalisen yksityisverkon (VPC) rajapintapäätepisteen kautta. Näin liikenne pysyy AWS-verkossa ilman internet-yhdyskäytävää, NAT-yhdyskäytävää tai välityspalvelinta. Päätepistekäytännöillä, suojausryhmillä, aliverkon sijoittelulla ja aws:SourceVpce IAM-ehtomäärityksellä voidaan rajoittaa, mitkä käyttäjätunnukset ja verkkoreitit voivat kutsua hakua.

CloudTrail tallentaa InvokeWebSearch kutsut datatapahtumina, mutta niitä ei kirjata oletusarvoisesti. Jäljitykseen tai tapahtumatietovarastoon on määritettävä tapahtumavalitsin, joka koskee resurssityyppiä AWS::BedrockAgentCore::WebSearch kyseiset tapahtumat yksilöivät verkkohakutyökalun ja maxResults, mutta eivät hakutekstiä tai suodattimia. Sovellettavat hyväksyttävän käytön ehdot edellyttävät myös, että asiakkaat säilyttävät ja näyttävät tulosten mukana toimitetut lähdeviitteet ja linkit.

Saatavuus ja yhdyskäytävän rajat

API:n käyttö kirjautuu samaan käyttöluokkaan kuin yhdyskäytäväliittimen käyttö, mutta suorasta käytöstä ei peritä yhdyskäytävämaksuja. Oletuskiintiö on 10 pyyntöä sekunnissa tiliä kohden kullakin alueella, ja asiakkaat voivat pyytää kiintiön korottamista. Julkaisuhetkellä palvelu on saatavilla alueilla US East (N. Virginia), US East (Ohio), US West (Oregon), Europe (Ireland), Asia Pacific (Tokyo) ja Asia Pacific (Sydney).

AWS suosittelee edelleen AgentCore Gatewayta useimpiin agenttipohjaisiin työkuormiin, erityisesti käyttöönottoihin, joissa MCP-yhteensopivat työkalut kootaan yhden päätepisteen taakse, käytetään valinnaisia MCP-istuntoja tai sovelletaan tiiminlaajuisesti ylläpitäjän hallitsemaa yhteistä lähdekäytäntöä. Molemmat reitit hakevat samasta indeksistä, mutta yhdyskäytävä voi lisäksi todentaa kutsujat JSON Web Tokenien avulla, kun taas itsenäinen API käyttää vain IAM:ia. Yhdyskäytävän ylläpitäjät voivat määrittää kohdekohtaisia verkkotunnusluetteloita, jotka eivät näy kutsuville agenteille; suoran API:n pyynnöissä käytetään niiden omia suodattimia.

Julkaisun myötä Amazonin verkkoindeksiä voi käyttää ilman, että sovelluksen tarvitsee ottaa käyttöön MCP:tä tai yhdyskäytäväpinoa. Ero liittyy toiminnan hallintaan: suoria kutsuja tekevät tahot vastaavat itse pyyntöjen käsittelystä ja suodattamisesta, kun taas jaetut agenttiympäristöt säilyttävät yhdyskäytävän keskitetyt työkalujen, todennuksen ja lähdekäytäntöjen hallintatoiminnot.