Instale a CLI do Python antiga para o AI Runtime
This documentation has been retired and might not be updated.
A CLI air baseada em Python, instalada com o pacote databricks-air, agora é obsoleta e não é mais mantida ativamente.
Use a CLI do Databricks para novas cargas de trabalho. Consulte Usar a CLI do Databricks com o AI Runtime.
Instale a CLI de air com uv e faça a autenticação em um Workspace do Databricks usando um perfil da CLI do Databricks. A CLI requer Python 3.10 ou mais recente.
Requirements
- Python 3.10 ou mais recente.
- Um workspace do Databricks com o AI Runtime habilitado. Consulte Requisitos.
- A CLI do Databricks, que gerencia os perfis de autenticação em
~/.databrickscfg.
Instalar a CLI
O Databricks recomenda instalar a CLI com uv:
uv tool install --force databricks-air --python 3.12
uv tool install coloca o air em seu próprio ambiente isolado e o expõe no seu PATH, para que ele não entre em conflito com o interpretador Python usado para o seu código de treinamento.
--python 3.12 é recomendado, mas opcional. Se você não especificar a versão do Python, o uv usará a versão mais recente disponível que atenda à 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
Verifique a instalação:
air --version
air --help
Autenticar
A CLI do AI Runtime reutiliza os perfis de autenticação da CLI do Databricks. Faça log in no seu workspace e dê um nome ao perfil quando solicitado:
databricks auth login --host https://<your-workspace>.cloud.databricks.com
Pass the profile name to any air comando with -p. Por exemplo:
air list runs -p my-workspace
Alternatively, set DATABRICKS_CONFIG_PROFILE in your shell to make a profile the default:
export DATABRICKS_CONFIG_PROFILE=my-workspace
For all authentication options, see Authentication for the Databricks CLI.
Outros recursos
Após a instalação, defina as cargas de trabalho em uma configuração train.yaml com dependências embutidas. Comece com o início rápido e, em seguida, use a referência do YAML ao criar sua configuração: