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

Privacidade e retenção de dados

Quando ativa a pesquisa web através das APIs do Azure Databricks Foundation Model, a pesquisa corre num endpoint de foundation model hospedado no Azure Databricks. A consulta e os resultados da pesquisa são processados pelo modelo alojado, independentemente do modelo que a sua aplicação chame. Os mesmos termos de proteção e retenção de dados que regem o Model Serving aplicam-se a estes pedidos:

  • O Azure Databricks não utiliza entradas enviadas para o Model Serving, nem saídas desta, para treinar modelos. Consulte Proteção de dados Model Serveing.
  • Qualquer armazenamento temporário para deteção de abuso é mantido na mesma região do seu espaço de trabalho e tem um limite temporal. Veja Retenção de Dados.

O modelo formula consultas de pesquisa a partir do seu prompt e envia-as para um fornecedor externo de pesquisa para obter resultados. Trate o conteúdo de prompts que chega à pesquisa web como dados que saem do Azure Databricks para o fornecedor de pesquisa, e defina o que a sua aplicação envia em conformidade.

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.
  • 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