Azure Databricks에서 웹 검색

이 페이지에서는 Azure Databricks 대한 웹 검색과 이를 사용하여 웹의 실시간 정보로 모델 응답을 접지하는 방법을 설명합니다. 웹 검색은 MCP(모델 컨텍스트 프로토콜)를 통해 인류 모델에 사용할 수 있습니다.

팁 (조언)

지니 코드 (에이전트 모드)는 이 작업을 수행할 수 있습니다. 다음 예제 프롬프트를 사용해 보세요.

Query the databricks-gemini-2-5-pro model using the OpenAI client with the google_search parameter enabled, ask a question about a current event, and print the response.

웹 검색은 기본 모델이 응답 생성 중에 인터넷에서 최신 정보를 검색할 수 있게 합니다. 웹 검색을 사용하도록 설정하면 모델은 웹을 검색하여 관련 정보를 찾아 응답에 통합할 수 있습니다. 이는 현재 이벤트, 최근 데이터 또는 실시간 정보가 응답을 향상시키는 항목에 대한 질문에 유용합니다.

Azure Databricks Marketplace의 You.com 같은 웹 검색 MCP 서버를 사용하여 Anthropic 모델에 대한 웹 검색을 사용하도록 설정합니다.

MCP를 사용하는 인류 모델

Anthropic의 네이티브 웹 검색 도구는 Azure Databricks Foundation Model API를 통해 사용할 수 없습니다. 대신 You.com 같은 검색 공급자와 함께 MCP(모델 컨텍스트 프로토콜) 를 사용하여 인류 모델에 웹 검색을 추가할 수 있습니다.

You.com MCP 서버 설정

  1. Azure Databricks 작업 영역에서 Marketplace > Agents > MCP Servers로 이동합니다.
  2. You.com 검색하고 설치를 클릭합니다.
  3. 연결을 구성합니다.
  • 연결 이름: 이름(예 youcom_web_search: )을 입력합니다.
  • 전달자 토큰: You.com API 키를 입력합니다.
  1. Install을 클릭합니다.
  2. 카탈로그 연결 [사용자 연결] 권한에서 적절한 사용자 또는 그룹에게 연결 사용 권한을 부여합니다.

설치 후 MCP 서버는 AI Playground, 에이전트 및 기타 MCP 호환 클라이언트에서 도구로 사용할 수 있습니다. 연결에 대한 프록시 엔드포인트 URL은 다음과 같습니다.

https://<workspace_host>.databricks.com/api/2.0/mcp/external/<connection_name>

Claude Code와 함께 사용

Azure Databricks Foundation Model API와 함께 Claude Code를 사용하는 경우 You.com MCP 서버를 추가하여 웹 검색을 사용하도록 설정합니다.

claude mcp add youcom-search \
  --transport http \
  --url "https://<workspace_host>.databricks.com/api/2.0/mcp/external/<connection_name>" \
  --header "Authorization: Bearer <your-databricks-pat>"

서버가 claude mcp list와 함께 추가되었는지 확인합니다.

서버를 ~/.claude.json에 직접 추가하세요.

{
  "mcpServers": {
    "youcom-search": {
      "type": "http",
      "url": "https://<workspace_host>.databricks.com/api/2.0/mcp/external/<connection_name>",
      "headers": {
        "Authorization": "Bearer <your-databricks-pat>"
      }
    }
  }
}

지원되는 모델

인류 모델(MCP를 통해)

MCP를 통한 웹 검색은 도구 사용을 지원하는 모든 Anthropic 기본 모델에서 지원됩니다.

  • databricks-claude-sonnet-4-6
  • databricks-claude-sonnet-4-5
  • databricks-claude-opus-4-7
  • databricks-claude-opus-4-6
  • databricks-claude-opus-4-5
  • databricks-claude-opus-4-1
  • databricks-claude-sonnet-4

제한점

  • 웹 검색은 토큰당 종량제 기반 모델 엔드포인트에서만 사용할 수 있습니다. 프로비전된 처리량 엔드포인트는 웹 검색을 지원하지 않습니다.
  • 외부 모델은 Azure Databricks 통해 웹 검색을 지원하지 않습니다.
  • 웹 검색 쿼리가 HIPAA 규격이 아닌 외부 검색 서비스로 전송되므로 HIPAA/BAA 규정 준수를 사용하도록 설정된 작업 영역에는 웹 검색을 사용할 수 없습니다.
  • 웹 검색 결과는 검색 쿼리를 작성하고 결과를 합성하는 모델의 기능에 따라 달라집니다. 응답 품질은 다를 수 있습니다.

추가 리소스

  • Last updated on