Instalar a CLI do AI Runtime
Beta
O AI Runtime CLI está em Beta.
Esta página descreve como instalar a CLI air e configurar a autenticação para um workspace do Databricks.
Requisitos
- Python 3.10 ou mais recente.
- Um workspace do Databricks com o AI Runtime habilitado. Consulte Requisitos.
- A CLI do Databricks, que gerencia perfis de autenticação em
~/.databrickscfg.
Instale a CLI
O Databricks recomenda instalar a CLI com uv:
uv tool install --force databricks-air --python 3.12
uv tool install coloca air em seu próprio ambiente isolado e o expõe em seu PATH, para que não haja conflito com o interpretador Python que você usa para seu código de treinamento.
--python 3.12 É recomendado, mas opcional. Se você não especificar a versão do Python, uv utiliza a versão mais recente disponível que satisfaz a restrição de Python do pacote.
Se você ainda não tiver uv, instale-o primeiro:
curl -LsSf https://astral.sh/uv/install.sh | sh
Verificar a instalação:
air --version
air --help
Autenticar
A AI Runtime CLI reusa os perfis de autenticação da CLI do Databricks. Log in no seu workspace e nomeie o perfil quando solicitado:
databricks auth login --host https://<your-workspace>.cloud.databricks.com
Passe o nome do perfil para qualquer comando air com -p. Por exemplo:
air list runs -p my-workspace
Alternativamente, defina DATABRICKS_CONFIG_PROFILE no shell para definir um perfil como default:
export DATABRICKS_CONFIG_PROFILE=my-workspace
Para todas as opções de autenticação, consulte Autenticação para a CLI do Databricks.