Bocha Wanxiang: API de căutare a cunoștințelor pentru aplicații AI

Prezentare generală

Bocha Wanxiang este serviciul API de căutare al platformei deschise Bocha AI. Combină căutarea hibridă multimodală cu reordonarea semantică pentru a extrage știri, imagini, videoclipuri și conținut enciclopedic dintr-un index de aproximativ zece miliarde de pagini web. Se adresează agenților AI, roboților conversaționali și sistemelor RAG care au nevoie de cunoștințe actuale despre lume în formă structurată, ceea ce reduce halucinațiile și păstrează răspunsurile trasabile până la sursă.

Spre deosebire de un endpoint clasic de căutare web, schema răspunsului este construită în jurul a ceea ce consumă efectiv un model de limbaj: titlul, URL-ul, fragmentul, pictograma site-ului, data publicării și imaginile ajung într-un singur răspuns, fără a mai fi nevoie de o altă etapă de curățare. Platforma reunește căutarea web, generarea de răspunsuri, reordonarea semantică și o bază de date de căutare hibridă, acceptă interogări în limbaj natural și anunță o latență a căutării web de până la 0,15 secunde. Operatorul afirmă că datele nu părăsesc China continentală și că rezultatele respectă regulile locale de securitate, aspect important în implementările reglementate.

Funcții principale

• Web Search API: căutare în limbaj natural pe web, cu câmpuri structurate precum titlu, URL, fragment, pictograma site-ului, data publicării și imagini. Până la 50 de rezultate per apel, latență de la 0,15 secunde.
• AI Search API: căutare hibridă cu preluare automată de date structurate pe domenii verticale, plus răspunsuri generate de model, întrebări de continuare și ieșire în streaming. Returnează referințe multimodale împreună cu un răspuns sumar.
• Semantic Reranker API: un Transformer propriu cu 80 de milioane de parametri care reordonează candidații după prima etapă BM25/RRF, acceptă recall50@top_n50 și returnează scoruri de relevanță pentru ca ordinea să fie mai aproape de ce preferă să citească un LLM.
• Agent Search API: direcționează întrebarea către un agent desemnat și returnează un răspuns mai aprofundat cu sugestii de continuare. Etapa beta s-a încheiat, așa că nevoile verticale specializate ar trebui să treacă pe AI Search.
• Bocha Hybrid Search Database (BochaDB): căutare hibridă între cuvinte-cheie și vectori, cu reordonare semantică integrată, ca singur strat de recuperare pentru RAG.
• API de sold: verificarea soldului contului și a consumului de resurse în timp real.

Cum se folosește

1. Înregistrare și obținerea cheii API. Creează un cont pe https://open.bochaai.com/, ridică pachetul de resurse pentru apeluri și generează o cheie API din consolă.
2. Alegerea căii de integrare. API REST oficial, function calling compatibil cu OpenAI și LangChain, pluginuri pentru Tencent Yuanqi, Coze, DingTalk și Dify, sau un server MCP.
3. Apelarea căutării web. Trimite o interogare în limbaj natural la https://api.bocha.cn/v1/web-search; poți limita intervalul de timp, domeniile și poți cere un rezumat text.
4. Trecerea la AI Search când ai nevoie de un răspuns. Se caută mai întâi, apoi se redactează un răspuns sumar cu surse; în produsele interactive activează streamingul pentru a reduce timpul până la primul token.
5. Reordonarea candidaților proprii. Trimite un set existent de documente către bocha-semantic-reranker, preia scorurile și reordonează înainte de a construi contextul pentru model.
6. Monitorizarea consumului. Conectează endpointul de sold și verifică periodic cota, ca lansarea în producție să nu se blocheze din cauza limitelor.

API-ul este RESTful JSON și se autentifică printr-un token Bearer care conține cheia.

Unde se potrivește

• AI conversațional: acces web live pentru un chatbot, astfel încât răspunsurile să citeze surse în loc de fapte inventate.
• Întrebări și răspunsuri cu RAG: folosit ca strat de recuperare pentru cunoștințe structurate și citabile din web, alături de o bază internă.
• Produse de căutare cu AI: construirea unei experiențe conversaționale cu rezumate, referințe multimodale și întrebări de continuare.
• Dezvoltarea de agenți: adăugarea recuperării de informații în timp real prin function calling sau printr-un plugin de platformă.
• Implementări cu cerințe de conformitate: datele rămân în China continentală, ceea ce se potrivește aplicațiilor enterprise locale cu reguli stricte privind conținutul și fluxurile de date.

Limitări și atenționări

• O căutare returnează cel mult 50 de rezultate web; pentru o acoperire mai mare folosește paginarea sau împarte interogarea.
• Cifra de 0,15 secunde se referă la latența Web Search. AI Search generează text, deci timpul total este mai mare; streamingul îmbunătățește percepția.
• Agent Search nu mai este în beta, așa că nevoile verticale specializate trebuie rezolvate cu AI Search sau cu un agent propriu.
• Calitatea depinde de formularea interogării și de acoperirea indexului. Pentru subiecte de nișă, conținut din interiorul site-urilor sau știri care se schimbă rapid, limitează domeniile și intervalele de timp.
• Rezultatele necesită verificare și citare explicită; ieșirea API este o dovadă, nu un adevăr final.
• Prețurile, cota și limitele de concurență sunt stabilite în consola oficială; rulează un test mic de încărcare înainte de traficul de producție.

Întrebări frecvente

Care este diferența față de un API obișnuit de căutare web?

Un API obișnuit returnează o listă de linkuri. Bocha Wanxiang returnează câmpuri structurate potrivite modelelor, plus reordonare semantică și răspunsuri generate, vizând halucinațiile și prospețimea datelor în RAG și agenți.

Ce opțiuni de integrare există?

API-ul REST oficial, function calling compatibil cu OpenAI și LangChain, pluginuri pentru Tencent Yuanqi, Coze, DingTalk și Dify, și un server MCP.

Cum este tratată conformitatea datelor?

Operatorul declară că datele nu părăsesc China continentală și că rezultatele respectă regulile locale. Este recomandat să confirmi termenii exacți și certificările cu furnizorul înainte de a te baza pe ele.