보차 완샹(Bocha Wanxiang): AI 애플리케이션을 위한 지식 검색 API

개요

보차 완샹은 보차 AI 오픈 플랫폼이 제공하는 검색 API 서비스입니다. 멀티모달 하이브리드 검색과 시맨틱 리랭킹을 결합해 약 100억 개 웹페이지 색인에서 뉴스, 이미지, 영상, 백과형 콘텐츠를 찾아냅니다. AI 에이전트와 챗봇, RAG 시스템이 최신 세상 지식을 구조화된 형태로 받아볼 수 있도록 설계되어 환각을 줄이고 답변의 출처를 추적할 수 있게 합니다.

일반적인 웹 검색 엔드포인트와 달리 응답 스키마가 언어 모델이 실제로 소비하는 형태에 맞춰져 있습니다. 제목, URL, 스니펫, 사이트 아이콘, 게시 시각, 이미지가 한 번의 응답에 담기므로 별도의 정제 계층을 다시 작성할 필요가 없습니다. 웹 검색, 답변 생성, 시맨틱 리랭킹, 하이브리드 검색 데이터베이스를 한 플랫폼에서 제공하며 자연어 질의를 지원하고 Web Search 지연 시간은 최저 0.15초로 안내됩니다. 운영사는 데이터가 중국 본토 밖으로 나가지 않으며 검색 결과가 국내 보안 규범을 따른다고 밝히고 있어 규제가 엄격한 도입 환경에 적합합니다.

주요 기능

• Web Search API: 자연어로 웹 전체를 검색하고 제목, URL, 스니펫, 사이트 아이콘, 게시 시각, 이미지 등 구조화 필드를 반환합니다. 호출당 최대 50건, 지연 시간은 최저 0.15초입니다.
• AI Search API: 하이브리드 검색과 함께 업종별 구조화 데이터를 자동으로 가져오고, 모델이 답변을 생성하며 후속 질문과 스트리밍 출력을 지원합니다. 멀티모달 참조 자료와 요약 답변을 함께 돌려줍니다.
• Semantic Reranker API: 자체 개발한 80M 파라미터 Transformer가 BM25/RRF 1차 정렬 이후 후보를 다시 정렬합니다. recall50@top_n50을 지원하고 관련도 점수를 반환해 LLM이 선호하는 순서에 가깝게 만듭니다.
• Agent Search API: 지정한 에이전트에 질문을 넘겨 더 깊은 답변과 후속 질문을 받습니다. 베타는 종료되었으며 업종 특화 수요는 AI Search로 옮겨야 합니다.
• Bocha Hybrid Search Database(BochaDB): 키워드와 벡터 하이브리드 검색에 시맨틱 리랭킹을 내장해 RAG를 위한 단일 검색 계층을 제공합니다.
• 잔액 조회 API: 계정 잔액과 리소스 소모를 실시간으로 확인합니다.

사용 방법

1. 가입하고 API 키 발급: https://open.bochaai.com/ 에서 계정을 만들고 호출용 리소스 패키지를 받은 뒤 콘솔에서 API 키를 생성합니다.
2. 연동 방식 선택: 공식 REST API, OpenAI 및 LangChain 호환 Function Calling, 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 형식이며 API 키를 담은 Bearer 토큰으로 인증합니다.

적합한 활용 사례

• 대화형 AI 강화: 챗봇에 실시간 웹 접근을 붙여 추측 대신 출처가 있는 답변을 제공합니다.
• RAG 질의응답: 공개 웹에서 인용 가능한 구조화 지식을 가져오는 검색 계층으로 사용하고 사내 지식베이스와 결합합니다.
• AI 검색 제품: 요약, 멀티모달 참조 자료, 후속 질문을 갖춘 대화형 검색을 만들 수 있습니다.
• 에이전트 개발: Function Calling이나 플랫폼 플러그인을 통해 에이전트에 실시간 정보 획득 능력을 더합니다.
• 규제 대응형 도입: 데이터가 중국 본토에 머무르므로 콘텐츠와 데이터 흐름 요건이 엄격한 국내 기업 애플리케이션에 맞습니다.

제한과 주의 사항

• 한 번의 검색에서 웹 결과는 최대 50건입니다. 더 넓은 범위가 필요하면 페이지를 나누거나 질의를 분할해야 합니다.
• 0.15초는 Web Search의 지연 시간입니다. AI Search는 답변을 생성하므로 전체 소요 시간이 길어지며, 스트리밍으로 체감 속도를 개선할 수 있습니다.
• Agent Search는 베타가 종료되어 특수한 업종 수요는 AI Search나 자체 에이전트로 해결해야 합니다.
• 검색 품질은 질의 표현과 색인 범위에 달려 있습니다. 롱테일 주제, 사이트 내부 정보, 변화가 빠른 이슈는 도메인과 기간을 제한하는 편이 좋습니다.
• 검색 결과는 하위 단계에서 사실 확인과 인용 표시가 필요합니다. API 출력을 유일한 사실로 간주하지 마세요.
• 요금, 할당량, 동시성 한도는 공식 콘솔 설정을 따릅니다. 운영 트래픽을 보내기 전에 소규모 부하 테스트를 권장합니다.

자주 묻는 질문

일반 웹 검색 API와 무엇이 다른가요?

일반 API는 링크 목록을 돌려줍니다. 보차 완샹은 모델 친화적 구조화 필드에 시맨틱 리랭킹과 생성 답변을 더해 RAG와 에이전트의 환각 및 최신성 문제를 겨냥합니다.

어떤 연동 방식을 지원하나요?

공식 REST API, OpenAI 및 LangChain 호환 Function Calling, Tencent Yuanqi·Coze·DingTalk·Dify 플러그인, MCP 서버를 지원합니다.

데이터 규정 준수는 어떻게 처리되나요?

운영사는 데이터가 중국 본토 밖으로 이전되지 않고 결과가 국내 보안 규범을 따른다고 설명합니다. 정확한 조건과 인증 여부는 도입 전에 제공사에 확인하세요.