Cloudflare hap kërkimin web për agjentët, por furnizuesi mbetet vendimtar

Cloudflare hapi Web Search API në beta të hapur më 2 tetor 2026, siç shënon analiza e Digital Applied. Shërbimi i lejon një aplikacioni të kërkojë në web përmes AI Gateway, duke zgjedhur Ceramic.ai, Exa ose Linkup dhe duke marrë rezultate që mund t’ia kalojë një modeli si kontekst.

Për zhvilluesin, beta sjell një mënyrë të përbashkët për të kërkuar dhe lexuar rezultate nga këta furnizues. Zgjedhja e tyre mbetet pjesë e kërkesës: ata përdorin mënyra të ndryshme kërkimi, kthejnë përshkrime të ndryshme dhe kanë tarifa të ndryshme. Aplikacioni vazhdon të vendosë kur duhet kërkimi dhe cilat burime janë të dobishme për përgjigjen e agjentit.

Një format rezultati, burime të ndryshme

Web Search API kthen një listë rezultatesh me URL dhe titull për secilën faqe; përshkrimi përfshihet kur furnizuesi e jep. Kjo strukturë i jep agjentit një pikënisje për pyetje që varen nga dokumentacioni i ndryshuar ose nga ngjarje të fundit. URL-ja është lidhja me burimin, ndërsa përshkrimi është fragmenti që aplikacioni mund të përzgjedhë për kontekstin e modelit.

Normalizimi ka një kufi të qartë: ai unifikon fushat e përgjigjes, jo faqet që gjen secili furnizues. Një ndryshim i parametrit provider mund të sjellë burime, renditje dhe fragmente të tjera për të njëjtën pyetje. Prandaj kodi që lexon rezultatin mund të mbetet i njëjtë, ndërsa përgjigjja e agjentit mund të ndryshojë sipas materialit që ka marrë.

Fushat shtesë, si imazhi, ikona e faqes ose data e përditësimit, janë fakultative. Për një agjent që u referohet burimeve, dallimi mes fragmentit dhe faqes është thelbësor: një përshkrim kërkimi ndihmon të zgjidhet rezultati, por nuk është domosdoshmërisht përmbajtja e plotë e tij. Ruajtja e URL-së bashkë me fragmentin lejon që përgjigjja të lidhet me faqen përkatëse.

Kërkesa minimale REST

Udhëzimi REST i Cloudflare përcakton një kërkesë POST në adresën https://api.cloudflare.com/client/v4/accounts/{account_id}/ai/websearch/ dhe një kufi prej 10 rezultatesh për kërkesë. Thirrja mund të vijë nga një backend i zakonshëm; integrimi përmes lidhjes AI në Cloudflare Workers është një mundësi tjetër. Tokeni i Cloudflare duhet të ketë lejet Account > Workers AI > Read dhe Account > AI Gateway > Read.

Kërkesa përdor kokat Authorization: Bearer me tokenin API dhe Content-Type: application/json. Trupi më poshtë është një shembull ilustrues, jo rezultat i një kërkimi të kryer: {"query":"dokumentacioni i Cloudflare Workers","provider":"ceramic","limit":5,"options":{"gateway":{"id":"default"}}}. Identifikuesi i llogarisë në adresë dhe tokeni zëvendësohen me vlerat përkatëse; default është identifikuesi i portës së përdorur në këtë shembull.

Parametri query mban pyetjen, provider zgjedh furnizuesin dhe limit përcakton sa rezultate kërkohen brenda kufirit të API-së. Te options.gateway.id caktohet AI Gateway që do ta kalojë kërkesën. Nëse provider lihet bosh, përdoret Ceramic.ai. Për një agjent, aplikacioni mund ta lidhë këtë thirrje me një mjet kërkimi: modeli kërkon përdorimin e mjetit, aplikacioni thërret endpoint-in dhe pastaj ia kthen modelit rezultatet.

Përgjigjja ka një listë items dhe një objekt metadata me të dhëna për kërkesën. Një element ilustrues i listës është {"url":"URL_E_FAQES","title":"Titull shembull","description":"Përshkrim shembull"}. Aplikacioni mund t’i lexojë të njëjtat fusha bazë pavarësisht furnizuesit, por duhet të pranojë që fushat fakultative mund të mungojnë. Nëse përshkrimi mungon, URL-ja dhe titulli mbeten të nevojshëm për ta identifikuar rezultatin.

Ku ndryshojnë Ceramic.ai, Exa dhe Linkup

Në tabelën e furnizuesve të Cloudflare, çmimet e listës janë 0,25 dollarë për 1 000 kërkesa te Ceramic.ai, 5 dollarë te Linkup dhe 7 dollarë te Exa. Kur përdoren kreditë e AI Gateway, kërkimet faturohen me çmimin e listës së furnizuesit, pa shtesë nga Cloudflare. Me një çelës API të vetin, përdoruesi faturohet drejtpërdrejt nga furnizuesi sipas marrëveshjes së tij.

• Ceramic.ai: është furnizuesi i parazgjedhur dhe ofron përshkrime të gjata të faqeve. Kjo i jep aplikacionit më shumë tekst për të përzgjedhur, por edhe më shumë për të administruar përpara se fragmentet të futen në kontekstin e modelit.
• Exa: përdor mënyrën auto dhe e mbush përshkrimin me fragmente të lidhura me pyetjen. Është alternativë kur agjenti përfiton nga pasazhe të shkurtra e të përqendruara te kërkesa konkrete.
• Linkup: përdor mënyrën fast dhe kthen rezultate burimore pa hartuar vetë një përgjigje. Kjo i lë aplikacionit dhe modelit detyrën e përzgjedhjes së burimeve dhe të formulimit të përgjigjes.

Këto dallime përshkruajnë mënyrën e ofrimit, jo një renditje të matur të cilësisë. Furnizuesi më i lirë për kërkesë mund të mos kthejë të njëjtat faqe ose fragmente si alternativat e tjera. Kostoja e një përgjigjeje të agjentit varet gjithashtu nga numri i kërkimeve që ai kryen dhe nga sasia e tekstit të rezultateve që i dërgohet modelit.

Çfarë kontrollon AI Gateway

Kërkesat e kërkimit kalojnë përmes AI Gateway dhe shfaqen në regjistrat e analitikën e tij pranë thirrjeve drejt modeleve. Porta mund të kufizojë cilët furnizues përdoren dhe kush mund të dërgojë kërkesa. Kjo i jep ekipit një vend të përbashkët për të ndjekur aktivitetin e agjentit, edhe kur kërkimi dhe gjenerimi i përgjigjes janë veprime të ndara.

Rruga e pagesës kërkon vëmendje të veçantë. Nëse në gateway është ruajtur një çelës i furnizuesit me aliasin default, ai mund të përdoret edhe kur kërkesa nuk përmban byokAlias; përndryshe kërkimi faturohet nga kreditë e AI Gateway. Kur aliasi kërkohet shprehimisht, por çelësi nuk është konfiguruar, kërkesa dështon në vend që të kalojë në faturimin me kredite.

Formati i përbashkët nuk i bashkon kushtet e furnizuesve për trajtimin e pyetjeve dhe ripërdorimin e rezultateve. Për një ekip që dërgon pyetje me të dhëna të ndjeshme, marrëveshja e rrugës së zgjedhur ka rëndësi po aq sa kontrolli në gateway. Regjistrat tregojnë sa dhe ku kërkon agjenti; vlera e përgjigjes vazhdon të varet nga burimet që furnizuesi i zgjedhur i kthen për ato pyetje.

Lexoni gjithashtu:

• Perplexity Pro apo ChatGPT Plus: kërkimi dhe krijimi ndajnë fituesin
• ChatGPT apo Gemini për kërkim të thellë: burimet dhe sinteza ndahen
• n8n apo Make për agjentë AI: vetëhostimi ndryshon faturën