LibreChatGoogle 검색
LibreChat에서 Google Custom Search를 에이전트 도구로 설정하기
웹 검색을 찾으시나요?
이 페이지는 Google Custom Search 에이전트 도구에 대해 다룹니다. LibreChat의 내장 Web Search 기능(Serper/SearXNG + Firecrawl + Jina)에 대해서는 Web Search를 참조하세요.
Google Search 도구는 에이전트가 Custom Search JSON API를 사용하여 Google에 쿼리할 수 있도록 합니다. Google Custom Search Engine ID와 API 키가 필요합니다.
설정
프로그래밍 가능한 검색 엔진(Programmable Search Engine) 만들기
Programmable Search Engine 제어판으로 이동하여 Google 계정으로 로그인하세요.
Add를 클릭하여 새로운 검색 엔진을 생성합니다. 이름을 입력하고 Search the entire web을 선택한 다음, Create를 클릭합니다.
Google Search API 키 가져오기
Custom Search JSON API 소개 페이지로 이동하여 Get a Key를 클릭하세요.
프로젝트 이름을 지정하고, 서비스 약관에 동의한 뒤, API 키를 복사하세요.
환경 변수 추가
두 값을 .env 파일에 추가하세요:
GOOGLE_SEARCH_API_KEY=your-api-key-here
GOOGLE_CSE_ID=your-search-engine-id-here에이전트에 도구 추가하기
LibreChat에서 Agents 패널로 이동하여 에이전트를 생성하거나 편집하세요. 에이전트의 Tools 목록에서 Google Search를 선택하세요.
재시작 및 테스트
| 배포 | 명령어 |
|---|---|
| Docker | docker compose down && docker compose up -d |
| Local | 중지 (Ctrl+C) 후 npm run backend |
"AI에 대한 최신 뉴스 검색해 줘"와 같은 메시지를 에이전트에게 보내세요. 에이전트는 Google Custom Search를 사용하여 관련 결과를 찾아 반환합니다.
일반적인 문제
검색 결과가 나오지 않는다면, Programmable Search Engine이 **전체 웹 검색(Search the entire web)**으로 설정되어 있는지(특정 사이트로 제한되지 않았는지) 확인하세요. 또한 .env 파일에 GOOGLE_SEARCH_API_KEY와 GOOGLE_CSE_ID가 모두 설정되어 있는지, 그리고 변경 사항을 적용한 후 LibreChat을 재시작했는지 확인하시기 바랍니다.
관련 페이지
이 가이드는 어떤가요?