Pular para o conteúdo principal
Última atualização em

Genie Code CLI

info

Beta

Esse recurso está em Beta. Trata-se de uma versão preliminar, e seus recursos, comandos e interfaces mudam com frequência.

A CLI do Genie Code é um agente de codificação executado localmente no seu terminal e otimizado para trabalho com dados e AI no Databricks. Ele funciona como outros agentes de codificação de terminal, mas vem pré-configurado para entender o Databricks e trabalhar naturalmente com seus dados, pipelines, modelos e aplicativos.

Como é executada em sua máquina, a CLI do Genie Code pode ler e editar seus arquivos locais, executar comandos e acessar o Databricks em seu nome. Ela usa a CLI do Databricks, incluindo os comandos dodatabricks genie, como databricks genie ask, para descobrir dados e responder a perguntas sobre eles. Durante o Beta, o acesso ao modelo é fornecido e governado por meio do Unity Gateway, portanto, você não precisa trazer sua própria inscrição de modelo.

Requisitos​

A execução do Genie Code CLI ocorre sob sua própria identidade, de modo que ele só pode acessar dados e realizar operações que suas permissões do Databricks permitam.

Instalar e configurar​

  1. Instale o Databricks CLI (versão 1.0.0 ou acima) separadamente, caso ainda não o tenha feito. Consulte Install or update the Databricks CLI.

  2. Instale a CLI do Genie Code com o comando para o seu sistema operacional.

Bash
curl -fsSL https://github.com/databricks/genie-code-cli/releases/latest/download/install.sh | bash

  1. Confirme a instalação:

    Bash
    genie --version

  2. Entre no diretório do seu projeto e comece a CLI do Genie Code:

    Bash
    cd my-project
    genie

  3. Quando solicitado, selecione um perfil da CLI do Databricks ou autentique-se se ainda não tiver configurado um. Consulte Autenticação para a CLI do Databricks. A CLI do Genie Code usa esse perfil para acessar modelos por meio do Unity Gateway. Ainda é possível usar outros perfis da CLI do Databricks para trabalhar com outros Workspace ou trabalhar totalmente fora do Databricks.

  4. Confirme que você confia no conteúdo do diretório e, em seguida, comece a criar prompts.

O que você pode fazer com a CLI do Genie Code​

Genie Code CLI can work directly with local files, discover and query your Unity Catalog data through Genie, and build and implantado Databricks ativos from a single conversation in the terminal. Por exemplo:

  • Ingerir e governar : "Limpe estes CSVs de ventas mensais, carregue-os no Unity Catalog e mostre-me a receita por região ao longo do tempo."
  • Explore seus dados : "Qual dos meus catálogos tem dados de rotatividade de clientes e quais foram os principais drivers do último trimestre?"
  • Estender um pipeline : "Adicionar uma tabela silver refunds ao meu pipeline de pedidos e preencher os últimos 90 dias."
  • Ensinar e servir um modelo : "Faça a execução deste script de treinamento no Databricks e coloque o modelo atrás de um Endpoint de serviço."
  • Criar e entregar um aplicativo : "Criar um protótipo de aplicativo local para minha tabela customers e implantá-lo como um Databricks App."

Como a CLI do Genie Code difere do Genie Code no workspace​

Genie Code CLI é uma experiência separada criada para o trabalho local baseado em terminal. Ele tem suas próprias ferramentas, habilidades e instruções e, no momento, não as compartilha com o Genie Code no workspace do Databricks. Ele também ainda não inclui todos os recursos disponíveis na IU do workspace.

Use a CLI do Genie Code como um componente nativo de terminal ao trabalhar localmente com arquivos, scripts e protótipos. Continue a usar o Genie Code no workspace para obter uma experiência mais rica e completa.

Configurar habilidades e servidores MCP​

Você pode estender a CLI do Genie Code com habilidades, servidores MCP e instruções de projeto. Se você já usa o Claude Code ou o Cursor, faça a execução de /import na CLI do Genie Code para importar sua configuração deles.

Adicionar habilidades​

O Genie Code CLI já vem instalado com habilidades de agente do Databricks para que o agente funcione de forma mais eficaz com dados e recursos do Databricks, como jobs, pipelines, modelos e aplicativos. Essas habilidades estão em ~/.genie/skills/.system/.

Para adicionar sua própria habilidade, crie uma pasta que contenha um arquivo SKILL.md no formato de Habilidades do Agente padrão e salve-a em ~/.genie/skills/. Para compartilhar uma habilidade com sua equipe, salve-a em .agents/skills/ no seu repository. A CLI do Genie Code também carrega habilidades de outras pastas locais, como pastas pai do seu diretório de trabalho e a raiz do seu repository.

Você também pode pedir à CLI do Genie Code para criar uma habilidade ou converter uma habilidade existente de outro agente de codificação.

A CLI do Genie Code carrega habilidades apenas de pastas locais. Para usar uma habilidade do seu workspace do Databricks, como uma habilidade em .assistant/skills/, faça download dela para uma destas pastas.

Conectar servidores MCP​

Use genie mcp add para conectar a CLI do Genie Code a qualquer servidor MCP, incluindo servidores MCP que não estejam hospedados no Databricks.

Para se conectar a um servidor MCP remoto, passe o URL dele e o nome de uma variável de ambiente que contenha um access token para ele:

Bash
genie mcp add <server-name> --url <server-url> --bearer-token-env-var <env-var-name>

Para conectar um servidor MCP executado na sua máquina, passe o comando que o começa:

Bash
genie mcp add <server-name> -- <command> <args>

Para conectar um servidor MCP gerenciado no Databricks, como o servidor MCP Genie One:

  1. Armazene um access token do Databricks em uma variável de ambiente:

    Bash
    export DATABRICKS_MCP_TOKEN=$(databricks auth token --profile <profile-name> | jq -r .access_token)

  2. Adicione o servidor MCP e passe o nome da variável de ambiente. Se a URL do seu workspace incluir um ID de workspace, como ?o=<workspace-id>, adicione-o ao final da URL do servidor MCP.

    Bash
    genie mcp add genie_one \
      --url "https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp" \
      --bearer-token-env-var DATABRICKS_MCP_TOKEN

  3. No mesmo terminal, comece a CLI do Genie Code:

    Bash
    genie

  4. Execução /mcp para confirmar que o servidor está conectado.

Adicionar instruções do projeto​

Para dar instruções à CLI do Genie Code que se aplicam a todas as conversas em um projeto, como convenções de codificação, nomes de catálogo e esquema ou como execução testes, adicione um arquivo AGENTS.md à raiz do diretório do projeto. A CLI do Genie Code lê esse arquivo quando você a começa nesse diretório.

Cobrança​

O uso da CLI do Genie Code é cobrado da mesma forma que o uso do modelo diretamente pelo Unity Gateway e aparece no seu uso do Unity Gateway. Ele não é cobrado de acordo com os preços do Genie.

Para controlar os gastos, os administradores do Workspace podem definir orçamentos para o Unity Gateway. Consulte Gerenciar orçamentos para o Unity Gateway.

Perguntas frequentes​

Quando devo usar a CLI do Genie Code em vez do Unity Gateway com meu próprio agente de codificação?​

Use outro agente de codificação através da ug CLI, por exemplo, ug claude, se você já tiver configurado esse agente para usar habilidades de agente do Databricks e servidores MCP gerenciados pelo Databricks, como o Genie One.

Use a CLI do Genie Code se você ainda não tiver configurado isso ou se também quiser os ajustes adicionais que a Databricks aplica ao harness do agente para que ele funcione melhor com a Databricks.

Como a CLI do Genie Code é diferente de outros agentes de codificação?​

A CLI do Genie Code funciona como outros agentes de codificação de terminal, com estas diferenças:

  • Pré-configurado para Databricks : Inclui habilidades de Databricks, usa a CLI de Databricks e o Genie para descobrir e fazer query de seus dados, e é ajustado com instruções para trabalho de dados e AI. Você não instala ou configura isso sozinho.
  • Sem inscrição de modelo separada : O acesso ao modelo é fornecido e regido pelo Unity Gateway, e o uso é cobrado na sua account Databricks.
  • As operações do Workspace são regidas pelo Databricks : as operações em seu workspace do Databricks estão em execução sob sua identidade do Databricks, portanto, as permissões do Unity Catalog se aplicam. As operações locais, como editar arquivos e executar comandos em sua máquina, não são regidas pelo Databricks.

Para usar outro agente de codificação com Databricks, consulte Começar a usar agentes de codificação.

Quais sistemas operacionais são compatíveis com a CLI do Genie Code?​

O Genie Code CLI é compatível com macOS, Linux e Windows. Consulte Instalar e configurar.

Posso usar a CLI do Genie Code em meu IDE?​

Sim. Comece o Genie Code CLI no terminal integrado de qualquer IDE, como Visual Studio Code, Cursor ou IntelliJ IDEA. A CLI do Genie Code funciona com os arquivos no diretório onde você a começa.

Como faço para retomar uma conversa anterior?​

Toda vez que você executa o genie, a CLI do Genie Code começa uma nova conversa. Para retomar uma conversa anterior, use uma das seguintes opções:

  • genie resume: Escolha uma conversa em uma lista.
  • genie resume --last: retome sua conversa mais recente.
  • /resume: Escolha uma conversa de uma lista enquanto a CLI do Genie Code estiver em execução.

Como faço para atualizar a CLI do Genie Code?​

A CLI do Genie Code verifica se há uma nova versão quando começa e solicita que você a atualize. Para atualizar manualmente, execução genie update ou execução novamente o comando de instalação do seu sistema operacional.

Como os administradores governam a CLI do Genie Code?​

Os administradores governam a CLI do Genie Code por meio do Unity Gateway, da mesma forma que outros agentes de codificação. O uso da CLI do Genie Code aparece no uso do Unity Gateway, e os orçamentos do Unity Gateway se aplicam a ela. Consulte Configurar agentes de codificação e Gerenciar orçamentos do Unity Gateway.

Limitações​

  • A seleção de modelos é gerenciada pelo Databricks. Não é possível escolher um modelo específico. Durante a versão Beta, o Genie Code CLI usa o GPT 5.6. A seleção pode diferir de outras superfícies do Genie e pode mudar ao longo do tempo.
  • A CLI do Genie Code não é cobrada pelo uso do Genie e não é afetada pelos orçamentos do Genie. Para controlar os gastos, defina orçamentos para o Unity Gateway. Consulte Gerenciar orçamentos para o Unity Gateway.
  • A CLI do Genie Code só é compatível com a autenticação OAuth machine-to-machine (M2M).
  • A CLI do Genie Code não é compatível com sessões de túnel SSH. Para usar a CLI do Genie Code, execute-a na sua máquina local.
  • A CLI do Genie Code carrega habilidades apenas de pastas locais. Ele não carrega habilidades ou instruções do seu workspace ou do Unity Catalog.
  • Se você conectar um servidor MCP no Databricks com um access token, as chamadas MCP falharão com um erro 401 após a expiração do token. Para reconectar, saia da CLI do Genie Code, defina a variável de ambiente para um novo token e execute genie.
Nesta página