Bocha Wanxiang: API de busca de conhecimento para aplicações de IA

O que é

Bocha Wanxiang é o serviço de API de busca da plataforma aberta Bocha AI. Ele combina recuperação híbrida multimodal com reordenação semântica para localizar notícias, imagens, vídeos e conteúdo enciclopédico em um índice de quase dez bilhões de páginas web. O foco são agentes de IA, chatbots e sistemas RAG que precisam de conhecimento atual do mundo em formato estruturado, o que reduz alucinação e mantém as respostas rastreáveis até as fontes.

Diferente de um endpoint de busca tradicional, o esquema de resposta é organizado conforme o que um modelo de linguagem consome: título, URL, trecho, ícone do site, data de publicação e imagens chegam no mesmo payload, sem exigir outra camada de limpeza. A plataforma reúne busca web, geração de respostas, reordenação semântica e um banco de busca híbrida, aceita consultas em linguagem natural e informa latência de até 0,15 segundo na busca web. O operador declara que os dados não saem da China continental e que os resultados seguem as normas locais de segurança, ponto importante em implantações reguladas.

Principais recursos

• Web Search API: busca em linguagem natural na web aberta, com campos estruturados como título, URL, trecho, ícone do site, data e imagens. Até 50 resultados por chamada e latência de até 0,15 segundo.
• AI Search API: recuperação híbrida com dados estruturados automáticos por domínio vertical, além de respostas geradas pelo modelo, perguntas de acompanhamento e saída em streaming. Devolve referências multimodais junto ao resumo.
• Semantic Reranker API: Transformer próprio de 80 milhões de parâmetros que reordena candidatos após a primeira etapa BM25/RRF, suporta recall50@top_n50 e devolve pontuações de relevância para aproximar o resultado do que um LLM prefere ler.
• Agent Search API: direciona a pergunta a um agente definido e devolve uma resposta mais profunda com sugestões de acompanhamento. O beta foi encerrado; casos verticais devem migrar para o AI Search.
• Bocha Hybrid Search Database (BochaDB): recuperação híbrida de palavras-chave e vetores com reordenação semântica embutida, pensada como camada única para sistemas RAG.
• API de saldo: consulta em tempo real do saldo e do consumo de recursos.

Como usar

1. Cadastre-se e obtenha a chave. Crie a conta em https://open.bochaai.com/, resgate o pacote de recursos de chamadas e gere a API key no console.
2. Escolha a forma de integração. API REST oficial, function calling compatível com OpenAI e LangChain, plugins para plataformas como Tencent Yuanqi, Coze, DingTalk e Dify, ou um servidor MCP.
3. Chame a busca web. Envie a consulta para https://api.bocha.cn/v1/web-search em linguagem natural; é possível limitar o período, restringir domínios e pedir resumos de texto.
4. Use o AI Search quando precisar de resposta. Ele recupera primeiro e depois redige um resumo com referências; em produtos interativos, ative o streaming para reduzir o tempo até o primeiro token.
5. Reordene seus próprios candidatos. Envie um conjunto existente ao bocha-semantic-reranker, use as pontuações e reordene antes de montar o contexto do modelo.
6. Acompanhe o consumo. Conecte o endpoint de saldo e revise a cota com frequência para que a operação não pare por limite.

A API é RESTful em JSON e autentica com um token Bearer que carrega a chave.

Onde se aplica

• IA conversacional: dar acesso à web em tempo real para que o chatbot cite fontes em vez de inventar fatos.
• Perguntas e respostas com RAG: usar a API como camada de recuperação de conhecimento estruturado e citável da web aberta, ao lado de uma base interna.
• Produtos de busca com IA: montar uma experiência conversacional com resumos, referências multimodais e perguntas de acompanhamento.
• Desenvolvimento de agentes: acrescentar recuperação de informação em tempo real via function calling ou plugin de plataforma.
• Implantação com exigências de conformidade: os dados permanecem na China continental, o que atende aplicações corporativas locais com regras rígidas de conteúdo e fluxo de dados.

Limites e cuidados

• Cada busca retorna no máximo 50 resultados web; pagine ou divida a consulta quando precisar de mais cobertura.
• Os 0,15 segundo se referem à latência do Web Search. O AI Search gera texto, então o tempo total é maior; o streaming melhora a percepção de velocidade.
• O Agent Search saiu da fase beta, portanto necessidades verticais específicas devem usar o AI Search ou um agente próprio.
• A qualidade depende da formulação da consulta e dos sites indexados; em temas de cauda longa, conteúdo interno ou assuntos muito dinâmicos, restrinja domínios e datas.
• Os resultados ainda exigem verificação e citação explícita: a saída da API é evidência, não verdade absoluta.
• Preço, cota e limites de concorrência são definidos no console oficial; faça um teste de carga pequeno antes de enviar tráfego de produção.

Perguntas frequentes

Qual é a diferença em relação a uma API de busca comum?

Uma API comum devolve links. O Bocha Wanxiang devolve campos estruturados para modelos, além de reordenação semântica e respostas geradas, com foco no problema de alucinação e atualidade.

Quais formas de integração existem?

A API REST oficial, function calling compatível com OpenAI e LangChain, plugins para Tencent Yuanqi, Coze, DingTalk e Dify, e um servidor MCP.

Como funciona a conformidade de dados?

O operador declara que os dados não saem da China continental e que os resultados seguem as normas locais. Vale confirmar termos e certificações com o fornecedor antes de depender disso.