Documentation Index
Fetch the complete documentation index at: https://docs.crewai.com/llms.txt
Use this file to discover all available pages before exploring further.
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.
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
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.
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.
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-catalogouvector-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.
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.
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.