Pesquisa na Web no Azure Databricks

Esta página descreve a pesquisa na web no Azure Databricks e como usá-la para basear respostas de modelo com informações em tempo real da web. A pesquisa na Web está disponível para modelos antropáticos por meio do PROTOCOLO MCP (Model Context Protocol).

Tip

O Código do Gênio (modo agente) pode fazer isso por você. Experimente este prompt de exemplo:

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.

A pesquisa na Web permite que os modelos de fundação recuperem informações atualizadas da Internet durante a geração de respostas. Quando a pesquisa na Web está habilitada, o modelo pode pesquisar na Web para encontrar informações relevantes e incorporá-la em sua resposta. Isso é útil para perguntas sobre eventos atuais, dados recentes ou qualquer tópico em que as informações em tempo real melhorem a resposta.

Habilite a pesquisa na Web para modelos antropáticos usando um servidor MCP de pesquisa na Web, como You.com do Azure Databricks Marketplace.

Modelos antropáticos com MCP

A ferramenta de pesquisa na web nativa da Anthropic não está disponível por meio das APIs do Modelo Base do Azure Databricks. Em vez disso, você pode adicionar pesquisa na Web a modelos antropáticos usando o PROTOCOLO MCP (Model Context Protocol) com um provedor de pesquisa, como You.com.

Configurar o servidor MCP You.com

  1. Navegue até Marketplace > Agents > Servidores MCP em seu espaço de trabalho Azure Databricks.
  2. Pesquise You.com e clique em Instalar.
  3. Configure a conexão:
  • Nome da conexão: insira um nome (por exemplo, youcom_web_search).
  • Token de portador: insira sua chave de API de You.com.
  1. Clique em Instalar.
  2. Conceda privilégios USE CONNECTION a usuários ou grupos apropriados em Conexões > de Catálogo > [sua conexão] > Permissões.

Após a instalação, o servidor MCP estará disponível como uma ferramenta no AI Playground, agentes e outros clientes compatíveis com MCP. A URL do terminal proxy para sua conexão é:

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

Usar com o Claude Code

Se você usar o Claude Code com as APIs do modelo do Azure Databricks Foundation, adicione o servidor MCP You.com para habilitar a pesquisa na Web:

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>"

Verifique se o servidor foi adicionado com claude mcp list.

Como alternativa, adicione o servidor diretamente a ~/.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>"
      }
    }
  }
}

Modelos com suporte

Modelos antropáticos (via MCP)

A pesquisa na Web por meio do MCP tem suporte em todos os modelos de base antropica que dão suporte ao uso da ferramenta.

  • 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

Limitações

  • A pesquisa na Web só está disponível em endpoints de modelos baseados em pagamento por token. Os pontos de extremidade de taxa de transferência provisionados não dão suporte à pesquisa na Web.
  • Modelos externos não dão suporte à pesquisa na Web por meio de Azure Databricks.
  • A pesquisa na Web não está disponível para workspaces com conformidade HIPAA/BAA habilitada porque as consultas de pesquisa na Web são enviadas para serviços de pesquisa externos que não são compatíveis com HIPAA.
  • Os resultados da pesquisa na Web dependem da capacidade do modelo de formular consultas de pesquisa e sintetizar resultados. A qualidade da resposta pode variar.

Recursos adicionais

  • Last updated on