Bocha Wanxiang: API поиска знаний для ИИ-приложений

Что это такое

Bocha Wanxiang — сервис поискового API открытой платформы Bocha AI. Он объединяет мультимодальный гибридный поиск и семантический реранкинг, находя новости, изображения, видео и энциклопедические материалы в индексе примерно из десяти миллиардов веб-страниц. Сервис рассчитан на ИИ-агентов, чат-ботов и RAG-системы, которым нужны актуальные знания о мире в структурированном виде: это снижает число галлюцинаций и сохраняет прослеживаемость ответов до источников.

В отличие от обычного поискового эндпоинта, схема ответа построена вокруг того, что реально потребляет языковая модель. Заголовок, URL, фрагмент текста, иконка сайта, дата публикации и изображения приходят одним ответом, поэтому отдельный слой очистки писать не нужно. Платформа объединяет веб-поиск, генерацию ответов, семантический реранкинг и гибридную поисковую базу, принимает запросы на естественном языке и заявляет задержку веб-поиска до 0,15 секунды. Оператор указывает, что данные не выводятся за пределы материкового Китая, а результаты соответствуют местным требованиям безопасности, что важно для регулируемых внедрений.

Основные возможности

• Web Search API: поиск на естественном языке по открытому вебу со структурированными полями — заголовок, URL, фрагмент, иконка сайта, дата публикации, изображения. До 50 результатов за вызов, задержка от 0,15 секунды.
• AI Search API: гибридный поиск с автоматическим получением структурированных данных по отраслям, а также сгенерированный моделью ответ, уточняющие вопросы и потоковый вывод. Возвращает мультимодальные ссылки вместе с кратким ответом.
• Semantic Reranker API: собственная Transformer-модель на 80 млн параметров переупорядочивает кандидатов после первого прохода BM25/RRF, поддерживает recall50@top_n50 и возвращает оценки релевантности, чтобы порядок лучше соответствовал предпочтениям LLM.
• Agent Search API: передаёт вопрос заданному агенту и возвращает более глубокий ответ с уточняющими вопросами. Бета-тест завершён, узкие отраслевые задачи стоит переводить на AI Search.
• Bocha Hybrid Search Database (BochaDB): гибридный поиск по ключевым словам и векторам со встроенным семантическим реранкингом — единый слой извлечения для RAG.
• API баланса: просмотр остатка на счёте и расхода ресурсов в реальном времени.

Как пользоваться

1. Зарегистрироваться и получить ключ. Создайте аккаунт на https://open.bochaai.com/, получите пакет ресурсов для вызовов и сгенерируйте API-ключ в консоли.
2. Выбрать способ интеграции. Официальный REST API, function calling, совместимый с OpenAI и LangChain, плагины для Tencent Yuanqi, Coze, DingTalk и Dify либо MCP-сервер.
3. Вызвать веб-поиск. Отправьте запрос на https://api.bocha.cn/v1/web-search на естественном языке; можно ограничить период, задать домены и запросить текстовое резюме.
4. Перейти на AI Search, если нужен ответ. Сначала выполняется поиск, затем формируется краткий ответ со ссылками на источники; в интерактивных продуктах включайте потоковый вывод, чтобы сократить время до первого токена.
5. Переупорядочить свои кандидаты. Передайте готовый набор документов в bocha-semantic-reranker, возьмите оценки релевантности и отсортируйте заново перед отправкой контекста в модель.
6. Следить за расходом. Подключите эндпоинт баланса и регулярно проверяйте квоту, чтобы рабочий запуск не остановился из-за лимитов.

API работает по RESTful-схеме с JSON и авторизуется через Bearer-токен с ключом.

Где применяется

• Диалоговый ИИ: дать чат-боту доступ к вебу в реальном времени, чтобы ответы содержали ссылки на источники, а не выдуманные факты.
• Вопросы и ответы на базе RAG: использовать сервис как слой извлечения структурированных и цитируемых знаний из открытого веба вместе с внутренней базой.
• Поисковые продукты с ИИ: строить диалоговый поиск с резюме, мультимодальными ссылками и уточняющими вопросами.
• Разработка агентов: добавлять извлечение актуальной информации через function calling или плагин платформы.
• Проекты с требованиями соответствия: данные остаются в материковом Китае, что подходит локальным корпоративным приложениям со строгими правилами по контенту и потокам данных.

Ограничения и замечания

• Один поиск возвращает не более 50 веб-результатов; при необходимости используйте постраничный вывод или дробите запросы.
• 0,15 секунды относится к задержке Web Search. AI Search генерирует текст, поэтому общее время больше; потоковый вывод улучшает восприятие.
• Agent Search больше не работает в бета-режиме, узкоспециализированные задачи стоит решать через AI Search или собственного агента.
• Качество зависит от формулировки запроса и охвата индекса. Для нишевых тем, внутренних страниц сайтов и быстро меняющихся новостей ограничивайте домены и период.
• Результаты требуют последующей проверки и явного цитирования: вывод API — это свидетельство, а не окончательная истина.
• Тарифы, квоты и лимиты параллельных запросов задаются в официальной консоли. Перед выводом в продакшен проведите небольшой нагрузочный тест.

Частые вопросы

Чем это отличается от обычного поискового API?

Обычный API возвращает список ссылок. Bocha Wanxiang возвращает структурированные поля, удобные для моделей, плюс семантический реранкинг и готовые ответы, закрывая проблемы галлюцинаций и актуальности в RAG и агентах.

Какие способы интеграции поддерживаются?

Официальный REST API, function calling с совместимостью OpenAI и LangChain, плагины для Tencent Yuanqi, Coze, DingTalk и Dify, а также MCP-сервер.

Как обеспечивается соответствие требованиям к данным?

Оператор заявляет, что данные не выводятся за пределы материкового Китая, а результаты соответствуют местным нормам безопасности. Точные условия и наличие сертификатов стоит уточнить у поставщика до внедрения.