Integração com Databricks

Conecte agentes CrewAI ao Databricks Genie, SQL, Unity Catalog Functions e Vector Search por meio dos servidores MCP gerenciados do Databricks.

​

Visão geral

Conecte seus agentes CrewAI diretamente ao seu workspace do Databricks por meio dos servidores MCP gerenciados do Databricks. A integração com o Databricks permite que seus agentes façam perguntas em linguagem natural com o Genie, executem SQL governado, chamem Unity Catalog Functions e recuperem documentos com o Vector Search — tudo sem escrever ou hospedar qualquer código de conector, e com as permissões do Unity Catalog aplicadas em cada chamada.

Nos bastidores, a integração com o Databricks é um wrapper gerenciado sobre o suporte a Servidores MCP personalizados do CrewAI. O Databricks expõe cada recurso como seu próprio endpoint do Model Context Protocol, e o CrewAI se conecta a eles com segurança em seu nome. Como cada servidor é adicionado separadamente, você pode habilitar exatamente os recursos de que suas crews precisam.

​

Principais recursos

Genie

Faça perguntas em linguagem natural e obtenha respostas fundamentadas em seus dados com o Genie, que consulta Genie Spaces e o Unity Catalog e fornece links de volta para a interface do Databricks.

Databricks SQL

Execute SQL governado nos seus warehouses do Databricks para consultar, transformar e criar pipelines de dados diretamente a partir dos seus agentes.

Unity Catalog Functions

Invoque funções do Unity Catalog para executar SQL predefinido e lógica de negócio personalizada como ferramentas governadas e reutilizáveis.

Vector Search

Recupere documentos relevantes para fluxos de RAG e de conhecimento a partir de índices do Mosaic AI Vector Search usando similaridade semântica.

Todos os servidores são executados por trás do Unity AI Gateway e aplicam os controles de acesso do Unity Catalog, de modo que seus agentes só enxergam os dados e as ferramentas que têm permissão para usar.

​

Pré-requisitos

Antes de usar a integração com o Databricks, certifique-se de ter:

• Uma conta CrewAI AMP com assinatura ativa
• Um workspace do Databricks com os recursos que você deseja expor (Genie Spaces, warehouses SQL, funções do Unity Catalog ou índices do Vector Search)
• Privilégios apropriados do Unity Catalog nos objetos subjacentes
• O hostname do seu workspace do Databricks (ex.: your-workspace.cloud.databricks.com)

​

Servidores MCP gerenciados do Databricks

O Databricks publica um servidor MCP gerenciado separado para cada recurso. O CrewAI os expõe como conexões individuais, cada uma configurada com o host do seu workspace e os identificadores relevantes do Unity Catalog. Os endpoints seguem estes padrões:

Servidor	O que faz	Padrão de URL MCP
Genie	Perguntas e respostas em linguagem natural sobre um Genie Space	https://<workspace-hostname>/api/2.0/mcp/genie/{genie_space_id}
Databricks SQL	Executa SQL nos seus warehouses	https://<workspace-hostname>/api/2.0/mcp/sql
Unity Catalog Functions	Executa funções UC registradas	https://<workspace-hostname>/api/2.0/mcp/functions/{catalog}/{schema}
Vector Search	Consulta um índice do Vector Search	https://<workspace-hostname>/api/2.0/mcp/vector-search/{catalog}/{schema}

Você não precisa construir essas URLs manualmente — o CrewAI cria cada endpoint a partir do host do workspace e dos identificadores (Genie Space ID, ou catalog/schema) que você fornece ao configurar a conexão. Para a especificação completa e os detalhes mais recentes dos endpoints, consulte a documentação de MCP gerenciado do Databricks.

​

Conectando o Databricks no CrewAI AMP

Cada recurso do Databricks — Databricks Genie, Databricks SQL, Databricks Unity Catalog Functions e Databricks Vector Search — aparece como seu próprio servidor MCP no grupo Databricks da página Tools & Integrations. Configure os que você precisar:

1. Abra Tools & Integrations

   Navegue até Tools & Integrations na barra lateral esquerda do CrewAI AMP e localize o grupo Databricks na lista de Connections. Você verá os servidores Genie, SQL, Unity Catalog Functions e Vector Search listados abaixo dele.

2. Configure um servidor

   Clique em Configure ao lado do recurso que deseja habilitar e forneça os detalhes da conexão:

   • Workspace Host — o hostname do seu workspace do Databricks (ex.: my-workspace.cloud.databricks.com).
   • Genie — o Genie Space ID a ser consultado.
   • Unity Catalog Functions — o catalog e o schema que contêm suas funções.
   • Vector Search — o catalog e o schema que contêm seu índice.
   • Databricks SQL — sem identificadores adicionais; as consultas são executadas nos warehouses SQL do seu workspace.
3. Escolha um método de autenticação

   Selecione como o CrewAI se autentica no Databricks. OAuth é recomendado.

   • Use OAuth — Conecte-se com segurança usando OAuth 2.0. Cada usuário se autentica individualmente, e o Databricks emite tokens com escopo para o recurso (genie, sql, unity-catalog ou vector-search). O CrewAI gerencia o fluxo de autorização e renova os tokens automaticamente.
   • Use personal access token — Autentique-se com um token de acesso pessoal do Databricks. Use uma identidade com privilégios mínimos para limitar a exposição.
4. Autentique

   Conclua a autenticação. Uma vez conectado, as ferramentas do servidor ficam disponíveis para suas crews. Repita para qualquer outro recurso do Databricks que você queira habilitar.

Como cada recurso é uma conexão separada, você pode combiná-los livremente — por exemplo, habilitar Genie e Vector Search para uma crew de pesquisa e reservar SQL e Unity Catalog Functions para uma crew de engenharia de dados. As configurações de visibilidade permitem controlar quais membros da equipe podem usar cada um.

​

Usando as ferramentas do Databricks nas suas crews

Uma vez conectado, as ferramentas que cada servidor MCP expõe aparecem junto às conexões integradas na página Tools & Integrations. Você pode:

• Atribuir ferramentas aos agentes nas suas crews, como qualquer outra ferramenta do CrewAI.
• Gerenciar a visibilidade para controlar quais membros da equipe podem usar cada conexão.
• Editar ou remover qualquer conexão a qualquer momento na lista de Connections.

Seus agentes agora podem pedir respostas fundamentadas ao Genie, executar SQL nos seus warehouses, chamar funções do Unity Catalog e pesquisar índices do Vector Search — com os resultados retornando automaticamente ao raciocínio deles.

O Databricks aplica governança por meio do Unity Catalog e do Unity AI Gateway: um usuário só pode descobrir e invocar ferramentas que a identidade do seu workspace tem permissão para usar. Se uma chamada de ferramenta falhar, confirme se o usuário (ou a identidade do token) que está conectando tem os privilégios necessários do Unity Catalog no Genie Space, warehouse, função ou índice. Algumas consultas do Genie e do SQL são executadas de forma assíncrona e podem levar um momento para retornar resultados.

​

Saiba mais

Servidores MCP gerenciados do Databricks

Documentação oficial do Databricks para os servidores MCP gerenciados Genie, SQL, Unity Catalog Functions e Vector Search.

Servidores MCP personalizados no CrewAI

Saiba como o CrewAI se conecta a qualquer servidor MCP, a base sobre a qual a integração com o Databricks é construída.

Precisa de ajuda?

Entre em contato com nossa equipe de suporte para obter ajuda com a configuração da integração com o Databricks ou com a solução de problemas.