grupo de comandoaitools
O uso da CLI do Databricks está sujeito à Licença do Databricks e ao aviso de privacidade do Databricks, incluindo quaisquer disposições de Dados de Uso.
O grupo de comandos aitools dentro da CLI do Databricks instala habilidades e plugins para que seu agente de codificação possa trabalhar de forma eficaz com recursos do Databricks, como bundles, jobs e SQL. Para mais detalhes, consulte o GitHub repository de habilidades do agente Databricks.
Para obter uma visão geral das ferramentas de AI, incluindo como elas se relacionam com servidores MCP gerenciados, consulte Habilidades de agente para assistentes de codificação de AI.
Instalar aitools do Databricks
Instale habilidades e plugins do Databricks para agentes de codificação detectados.
Por default, isso instala o plugin do Databricks por meio da CLI própria de cada agente (Claude Code, Codex, GitHub Copilot). Agentes sem uma instalação de plugin headless (Cursor, OpenCode, Antigravity, Pi, Gemini CLI) recebem arquivos de skill brutos. Para forçar arquivos de skill brutos para cada agente, use --skills-only.
databricks aitools install [flags]
Opções
--agents string
Agentes para instalar habilidades para (delimitado por vírgulas, Ex.: claude-code,cursor). Quando não configurado em uma sessão interativa, uma solicitação de multisseleção é exibida sobre os agentes detectados. Quando não configurado em uma sessão não interativa, ele é instalado para cada agente detectado.
São suportados agentes para as seguintes ferramentas:
- Claude Code (
claude-code) - Cursor (
cursor) - Codex CLI (
codex) - OpenCode (
opencode) - GitHub Copilot (
copilot) - Antigravidade (
antigravity) - Pi (
pi) - Gemini CLI (
gemini)
--experimental
Habilidades experimentais devem ser incluídas.
--path string
Gravar arquivos de habilidade resolvidos neste diretório. Nenhum agente é modificado e nenhum estado é gravado.
--scope string
O escopo da instalação, que pode ser project (diretório do projeto atual) ou global. default é global, ou um prompt ao executar interativamente.
--skills string
Habilidades específicas a serem instaladas (delimitadas por vírgulas), para uso com --skills-only ou --path. Para obter uma lista completa das habilidades com suporte, consulte o repository do GitHub de habilidades de agente do Databricks.
--skills-only
Forçar arquivos de skill brutos para cada agente em vez do plugin.
Exemplos
O seguinte exemplo instala todas as habilidades para todos os agentes detectados:
databricks aitools install
O exemplo a seguir instala habilidades somente para o Claude Code:
databricks aitools install --agents claude-code
O exemplo a seguir instala habilidades no diretório do projeto atual em vez de globalmente:
databricks aitools install --scope project
O exemplo a seguir instala habilidades específicas para todos os agentes detectados:
databricks aitools install --skills bundles,sql
lista de ferramentas de IA do Databricks
Listar componentes de ferramentas de AI instalados.
databricks aitools list [flags]
Opções
--scope string
Escopo para mostrar: project, global ou both (padrão: both).
Exemplos
Este exemplo lista todos os componentes instalados em ambos os escopos de projeto e globais.
databricks aitools list
O exemplo a seguir lista apenas os componentes instalados globalmente:
databricks aitools list --scope global
databricks aitools desinstalar
Remova as habilidades de AI da Databricks instaladas de todos os agentes de codificação.
Por default, remove todas as habilidades. Use --skills para remover apenas habilidades específicas.
databricks aitools uninstall [flags]
Opções
--scope string
Escopo de desinstalação: project ou global.
--skills string
Habilidades específicas para desinstalar (separadas por vírgulas). Para obter uma lista completa de habilidades compatíveis, consulte o repositório GitHub de habilidades do agente Databricks.
Exemplos
O seguinte exemplo desinstala todas as habilidades de todos os agentes.
databricks aitools uninstall
O exemplo a seguir desinstala apenas habilidades específicas.
databricks aitools uninstall --skills bundles,sql
Atualização do Databricks aitools
Atualizar as habilidades de IA do Databricks instaladas para a versão mais recente.
Por default, atualiza todas as habilidades instaladas e instala automaticamente novas habilidades a partir do manifesto. Use --no-new para pular novas habilidades, ou --check para pré-visualizar o que mudaria sem baixar.
databricks aitools update [flags]
Opções
--check
Mostrar o que seria atualizado sem fazer o download.
--force
Faça o download novamente, mesmo que as versões correspondam.
--no-new
Não instale automaticamente novas habilidades a partir do manifesto.
--scope string
Atualizar escopo: project, global ou both.
--skills string
Habilidades específicas para atualizar (separadas por vírgula). Para obter uma lista completa de habilidades compatíveis, consulte o repositório GitHub de habilidades do agente Databricks.
Exemplos
O exemplo a seguir atualiza todas as habilidades instaladas.
databricks aitools update
O seguinte exemplo pré-visualiza as atualizações disponíveis sem fazer download delas:
databricks aitools update --check
O exemplo a seguir atualiza todas as habilidades instaladas, mas não instala automaticamente nenhuma nova habilidade do manifesto.
databricks aitools update --no-new
Versão do Databricks aitools
Exibir a versão instalada das habilidades de IA.
databricks aitools version [flags]
Opções
Exemplos
databricks aitools version
Sinalizadores globais
--debug
Ativar log de depuração.
-h ou --help
Exibir ajuda para a CLI do Databricks ou o grupo de comandos relacionado ou o comando relacionado.
--log-file string
Uma string que representa o arquivo no qual gravar o log de saída. Se este sinalizador não for especificado, o default é gravar logs de saída no stderr.
--log-format Formato
O tipo de formato de log, text ou json. O valor padrão é text.
--log-level string
Uma string que representa o nível do formato do log. Caso não seja especificado, o nível de formato do log é desativado.
-o, --output Tipo
O tipo de saída do comando, text ou json. O valor padrão é text.
-p, --profile string
O nome do perfil no arquivo ~/.databrickscfg a ser usado para executar o comando. Se este sinalizador não for especificado, o perfil chamado DEFAULT é usado, se ele existir.
--progress-format Formato
O formato para exibir logs de progresso: default, append, inplace, ou json
-t, --target string
Se aplicável, o destino do pacote a ser usado