비추천 안내 (2026년 3월): Google은 프로그래머블 검색 엔진에서 “전체 웹 검색” 옵션을 중단했습니다. 새로운 검색 엔진은 최소 하나의 특정 사이트를 구성해야 합니다. 또한, Custom Search JSON API는 Vertex AI Search로 대체되고 있습니다. Discourse AI 팀은 대체 웹 검색 제공자를 적극적으로 연구하고 있으며, LLM 제공자의 네이티브 검색(예: Gemini의 내장 검색) 지원 등을 포함한 새로운 검색 도구를 곧 출시할 예정입니다. 이 가이드는 기존 설정에 여전히 유용하지만, 새로운 구성을 만들 때 이러한 제한 사항을 인지하시기 바랍니다.
Discourse AI용 Google 검색
Discourse AI 플러그인으로 Google 검색 봇을 설정하려면 Google 프로그래머블 검색 엔진과 Custom Search API 키를 구성해야 합니다. 사용하는 AI 모델이 Google 검색 결과를 반환하려면 이 검색 도구를 사용해야 합니다. Discourse 플러그인에 AI 서비스(예: OpenAI API GPT 또는 Anthropic Claude)를 설정하고 Google 검색을 수행하는 헬퍼 봇을 사용하려면, Google 검색을 수행할 프로그래머블 검색 엔진과 검색 엔진에 액세스하여 결과를 반환하는 리서처 봇용 API 키를 구성해야 합니다.
소개: Google Cloud, 프로그래머블 검색 엔진 및 Custom Search API
프로그래머블 검색 엔진(또는 Custom Search Engine)은 누구나 웹사이트에 설정할 수 있는 무료 검색 엔진 서비스로, 검색 엔진 ID(또는 CX 번호)로 식별됩니다. Custom Search API 키는 검색 엔진에 API 요청을 수행하는 데 사용되며, API 키는 Google Cloud 콘솔에서 관리됩니다. 따라서 Google Cloud 계정을 설정해야 합니다 - 계정 등록에는 신용카드가 필요하지만, Custom Search API는 유료 과금 전까지 하루 100건의 검색 쿼리를 무료로 제공합니다(추가 요청은 1,000건당 5달러이며, 하루 최대 10,000건까지 가능하지만 추가 사용량을 구매해야 합니다). 빌링 관리 방법을 참고하세요.
또한 키를 Google Cloud 프로젝트 아래에 설정하는 것이 좋습니다. 특히 검색 키를 위해 지정된 새 프로젝트를 사용하는 것이 추적하기 용이합니다. Google Cloud에는 프로젝트 수와 빌링 계정에 연결된 프로젝트 수에 대한 할당량이 있으며, 프로젝트는 설정 및 API 키 생성 후에 빌링 계정에 추가할 수 있습니다.
체크리스트
- Google Cloud 계정 설정
- Custom Search API 키를 위한 프로젝트 생성
- 프로젝트를 빌링 계정에 연결
- API 키 생성
- Custom Search용 API 키 구성
- Google 프로그래머블 검색 엔진 설정
- Custom Search API 키와 Custom Search ID를 Discourse AI 설정에 저장
1단계: Google Cloud에서 프로젝트 설정
Custom Search Engine과 API 키를 설정하기 전에, Google Cloud에서 프로젝트를 설정하세요.
(조직의) Google Cloud API 관리 페이지로 이동하여 상위 조직에 있는지 확인하세요(Google Cloud 로고 옆 상단 필드에서 확인할 수 있습니다).
이미 사용하려는 프로젝트가 없다면 검색 엔진을 위한 프로젝트를 생성해야 합니다 - 새 프로젝트를 선택하거나 생성하는 링크는 페이지 상단에 있습니다.
새 프로젝트 생성 페이지를 완료하세요(적절한 드롭다운 필드에서 조직이 선택되어 있는지 확인하세요).
프로젝트의 빌링을 관리하려면, 조직에 빌링이 설정되어 있다고 가정하고 Google Cloud 빌링에서 프로젝트용 빌링 계정을 설정해야 합니다. (또는 빌링 계정 관리자)는 키가 생성된 후 나중에 이 작업을 수행할 수 있습니다. 조직의 Google Cloud 계정에 따라 프로젝트 및 빌링 프로젝트에 할당량이 있을 수 있습니다.
프로젝트에 빌링을 활성화하려면 Google Cloud 내비게이션 메뉴의 Billing 탭으로 이동하여 빌링 계정을 연결하거나 빌링 프로젝트 페이지에서 프로젝트의 빌링을 활성화하세요.
2단계: API 키 생성
Google Cloud Console에서 API 키를 생성하려면 Google Cloud 콘솔의 API & Services 탭으로 이동하여 새 프로젝트의 자격 증명 설정 페이지로 가세요. (“동의 화면 구성” 메시지는 무시하셔도 됩니다.) 페이지 상단의 “+ 자격 증명 생성” 링크를 클릭하고 드롭다운 옵션에서 "API 키"를 선택하세요.
새 API 키가 생성됩니다. 비밀번호 볼트 애플리케이션과 같은 안전한 곳에 복사하여 보관하세요. 키를 공유하지 마세요.
이것은 Discourse AI 설정의 ai_google_custom_search_api_key에 입력해야 하는 Google Custom Search API 키입니다.
이제 API 키 목록에 새 키가 표시되어야 합니다. 가장 오른쪽의 Actions 열의 3개 점을 클릭하고 "API 키 편집"을 선택하세요.
API 키 자격 증명 구성 페이지가 열리며, 여기서 API 키 이름을 더 적절한 이름으로 편집할 수 있습니다. (필요할 경우 API 키를 표시/복사하거나 재생성할 수도 있습니다.) 그런 다음 하단의 “API 제한” 섹션으로 가서 "키 제한"을 선택한 후 "Custom Search API"를 선택하세요. OK를 클릭한 후 API 키를 저장하세요.
제한 사항이 표시되지 않으면 API 라이브러리에서 API 서비스를 활성화해야 할 수 있습니다. "google custom search api"를 검색한 후 선택하세요. 여기에서 가격 및 추가 문서 링크를 포함한 Custom Search API 세부 정보를 볼 수 있으며 - API를 활성화하려면 링크를 클릭하세요.
이제 새 API 키는 새 이름과 함께 목록에 표시되며, Custom Search API JSON 요청으로 제한됨을 나타내는 녹색 체크표시가 표시됩니다.
3단계: 프로그래머블 검색 엔진 생성
API 키가 사용할 검색 엔진을 생성하려면 Google 프로그래머블 검색 엔진 페이지로 이동하여 로그인하지 않았다면 "시작하기"를 클릭하세요(로그인하거나 계정을 생성하세요). 로그인 후 검색 엔진 콘솔 페이지로 이동하세요. 기존 프로그래머블 검색 엔진이 모두 여기에 나열됩니다.
“추가” 버튼(또는 “첫 번째 검색 엔진 만들기!” 링크)을 클릭하여 새 검색 엔진 페이지를 엽니다. 적절한 이름을 부여하고 해당되는 필드를 채우세요.
*.example.com/*)를 추가해야 합니다. 이는 결과를 전체 웹 검색이 아니라 구성된 사이트로 제한합니다.
“생성” 버튼을 클릭하면 새 검색 엔진이 생성됩니다. 웹 인터페이스 어딘가에 검색 상자를 사용하려면 검색 스크립트를 복사할 수 있는 옵션이 제공되지만, 여기서는 API 키 자격 증명을 사용하여 액세스하는 것만 관심이 있으므로 불필요합니다.
커스터마이즈 버튼을 선택하여 검색 엔진 개요 페이지로 이동하세요. 여기에서 Discourse AI Google 검색 설정에 필요한 검색 엔진 ID(CX 번호) 및 구성할 수 있는 기타 옵션을 볼 수 있습니다. (참고: 아래로 스크롤하면 API 키 생성 링크가 있지만, 2단계에서 이미 수행했으므로 이 작업을 수행할 필요가 없습니다.)
4단계: Discourse AI 플러그인에서 Google Custom Search 구성
검색 엔진 ID 번호를 복사하여 2단계에서 만든 API 키와 함께 저장하세요. 관리 - 사이트 설정으로 이동하여 모든 사이트 설정 필터에 "google custom search"를 입력하여 필요한 두 가지 설정을 표시하세요. API 키를 ai_google_custom_search_api_key에, 검색 엔진 ID(CX 번호)를 Discourse 인스턴스의 ai_google_custom_search_cx에 붙여넣고 새 설정을 저장하세요. 기타 AI 설정은 필요에 따라 구성하세요.
5단계: API 검색 키 추적
Google Cloud Console의 API 및 서비스 세부 정보에서 Custom Search API 키의 활동을 볼 수 있으며, 할당량 및 시스템 제한 탭에서 할당량을 설정할 수도 있습니다. 비용 보고서는 비용 탭에서 볼 수 있습니다.
Discourse AI 검색 예시
다음은 OpenAI GPT-4 Turbo가 Google Custom Search를 사용하여 그것이 무엇을 하는지 및 어떻게 설정하는지 설명하는 예시입니다.
다음은 Anthropic Claude Opus가 Google Custom Search를 사용하여 "reverse centaur"의 의미를 설명하는 예시입니다.
관련 링크
- Discourse AI
- Google Developer Custom Search Engine 문서
- Google Custom Search API
- Google Cloud 빌링
- Google 프로그래머블 검색 엔진
