Pesquisa na web no Azure Databricks

Esta página descreve a pesquisa na web no Azure Databricks e como usá-la para fundamentar as respostas do modelo com informações em tempo real da web. A pesquisa na web está disponível para modelos antrópicos através do Model Context Protocol (MCP).

Tip

O Código Génio (modo Agente) pode fazer isto por ti. 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 fundamentais recuperem informação atualizada da internet enquanto geram respostas. Quando a pesquisa na web está ativada, o modelo pode pesquisar na web para encontrar informação relevante e incorporá-la na sua resposta. Isto é útil para perguntas sobre eventos atuais, dados recentes ou qualquer tema onde a informação em tempo real melhore a resposta.

Permita a pesquisa na web para modelos Anthropic utilizando um servidor MCP de pesquisa web, como You.com do Azure Databricks Marketplace.

Modelos antrópicos com MCP

A ferramenta nativa de pesquisa web da Anthropic não está disponível através das APIs do Azure Databricks Foundation Model. Em vez disso, pode adicionar pesquisa web a modelos antrópicos usando o Model Context Protocol (MCP) com um fornecedor de pesquisa como You.com.

Configurar o servidor MCP You.com

  1. Navegue até Marketplace > Agentes > MCP Servers no seu espaço de trabalho Azure Databricks.
  2. Procure You.com e clique em 'Instalar'.
  3. Configure a conexão:
  • Nome da ligação: Insira um nome (por exemplo, youcom_web_search).
  • Token Bearer: Insira a sua chave de API do You.com.
  1. Clique em Instalar.
  2. Conceda privilégios de USAR CONEXÃO a utilizadores ou grupos apropriados sob Catálogo > de Ligações > [a sua ligação] > Permissões.

Após a configuração, o servidor MCP está disponível como ferramenta no AI Playground, agentes e outros clientes compatíveis com MCP. A URL do endpoint proxy para a sua ligação é:

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

Utilização com Código Claude

Se usar o Claude Code com as APIs do Model Foundation do Azure Databricks, adicione o servidor You.com MCP para ativar a pesquisa 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.

Em 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 suportados

Modelos antrópicos (via MCP)

A pesquisa web via MCP é suportada em todos os modelos de fundação Anthropic que suportam o uso de ferramentas.

  • 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 nos endpoints do modelo de fundação pay-per-token. Os endpoints de largura de banda provisionada não suportam pesquisa web.
  • Modelos externos não suportam pesquisa web através do Azure Databricks.
  • A pesquisa na web não está disponível para espaços de trabalho com conformidade com HIPAA/BAA ativada porque as consultas de pesquisa web são enviadas para serviços externos de pesquisa que não cumprem a HIPAA.
  • Os resultados da pesquisa na web dependem da capacidade do modelo para formular consultas de pesquisa e sintetizar resultados. A qualidade da resposta pode variar.

Recursos adicionais

  • Last updated on