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

Databricks Sandbox

nota

Beta

Este recurso está em Beta. No momento, o Databricks não cobra pelo uso deste recurso.

Databricks Sandbox é um ambiente de compute para humanos e agentes, acessível via SSH, executado no plano de compute serverless do Databricks.

A sandbox permite:

  • Crie um sandbox de desenvolvimento persistente que pode ser acessado via SSH. Executar tarefas de agente mais longas sem que a máquina local precise estar ativa.

  • Execute um agente de codificação em um ambiente seguro e em sandbox:

    • Controlar o agente de codificação diretamente da CLI do Databricks via SSH
    • Conecte-se a um IDE de desktop ou harness de agente como Cursor, Claude ou Codex.

  • Crie ambientes de curta duração para subagentes, experimentos ou programas criados por agentes. Use isso com o MCP, ou ao criar agentes personalizados com a API do Supervisor ou em aplicativos.

Por que devo usar o Databricks Sandbox?​

  • Governança nativa do Databricks

    • É executado no plano de compute serverless do Databricks. Os dados em seu Databricks sandbox permanecem dentro do limite de governança do seu workspace.
    • Integração perfeita com o AI Gateway para inferência de LLM governada e chamadas de MCP.

  • Construído para executar agentes

    • Começa em segundos. Crie ambientes novos para experimentos, subagentes ou tarefas isoladas, e elimine-os ao final do uso.
    • O armazenamento persiste entre as sessões. Instale suas ferramentas e configuração uma vez, interrompa o Databricks Sandbox e reconecte-se mais tarde ao mesmo sistema de arquivos e estado.
    • Execute sessões concorrentes em uma instância. Abra múltiplas sessões SSH para um sandbox Databricks por um sistema de arquivos compartilhado. Um agente pode trabalhar em uma tarefa em uma sessão enquanto os logs são monitorados ou os arquivos são editados em outra, tudo na mesma instância.

Pré-requisitos (CLI)​

Para criar e usar um sandbox do Databricks com a CLI do Databricks, é preciso:

  1. Instale o Databricks CLI em sua máquina local.

  2. Autenticar a CLI do Databricks usando databricks auth login:

Bash
databricks auth login  # authenticate to a Databricks workspace
nota

Sandboxes podem ser iniciados automaticamente por outros produtos, incluindo a API do Supervisor.

Criar sandbox (CLI)​

Para criar um sandbox do Databricks usando a CLI do Databricks, execute os seguintes comandos:

Bash
databricks sandbox create      # create your sandbox
databricks sandbox register    # optional: register SSH keys
databricks sandbox ssh         # SSH to your default sandbox

Ao usar SSH em seu sandbox, a CLI do Databricks é instalada e autenticada no workspace do Databricks onde seu sandbox está sendo executado. Convém também configurar as credenciais do Git. Consulte Conectar seu provedor Git ao Databricks.

Para ajuda detalhada do comando, execute databricks sandbox -h, ou consulte grupo de comandossandbox.

Executar um agente de código​

Databricks recomenda usar ucode, a CLI de Codificação do Unity AI Gateway, para executar um agente de codificação. Com ucode, é possível configurar a estrutura de agente de sua preferência para usar o AI Gateway. Execução ucode configure para configuração.

  • Use a CLI diretamente : acesse o seu terminal via SSH. Use ucode para operar o agente de codificação de sua escolha para integração com o AI Gateway.
  • **Conecte aplicativos de desktop via SSH**: Consulte as instruções para usar Claude, Codex, Visual Studio Code ou Cursor.
  • Executar uma interface de usuário da Web : Por exemplo, execute o OpenCode Web e conecte-se a ele de sua máquina local usando o encaminhamento de porta SSH.

Persistência de dados​

atenção

Armazenamento durante a versão Beta não é persistente e pode ser excluído.

Databricks Sandbox vem com armazenamento conectado à rede. O desempenho é semelhante às ofertas típicas em cloud.

  • É possível iniciar muitas sessões SSH concorrentes para uma Sandbox do Databricks, e todas elas veem o mesmo sistema de arquivos.
  • Os dados em seu diretório inicial (/home/sandbox-agent) persistem durante a vida útil do seu sandbox Databricks. Mesmo após interromper seu sandbox Databricks, os dados no seu diretório inicial ficam disponíveis ao começar sua próxima sessão.
  • Seu diretório inicial pode armazenar até 100 GB. Neste momento, esta não pode ser alterada.
  • Dados fora do diretório inicial são excluídos se a sandbox for interrompida. É possível armazenar até 10 GB fora do seu diretório inicial.

Custos de uso​

Para obter informações completas sobre o uso do faturamento, consulte Preços do Databricks. A Databricks prevê cobrança de uso de sandbox para:

  • Runtime Compute, cobrado por hora enquanto seu Databricks Sandbox estiver em execução. As taxas exatas serão determinadas.

    • O armazenamento fora do seu diretório inicial está incluído como parte do custo de compute do tempo de execução do Databricks Sandbox.

  • Armazenamento persistente no seu diretório inicial, a taxas semelhantes ao armazenamento default.

    • Os dados armazenados em seu diretório inicial serão cobrados até que seu Databricks Sandbox seja excluído.
    • O armazenamento é cobrado enquanto a instância do Databricks Sandbox existir. Parar o seu Databricks Sandbox não interrompe a cobrança pelo armazenamento.

  • Transferência de dados nas taxas existentes.

Limitações​

  • Ainda não se integra com controles de saída serverless. Não utilize o Databricks sandbox em um workspace com (SEG) habilitado. Para obter mais informações sobre controles de saída serverless, consulte O que é controle de saída serverless?

  • Especificações técnicas: 4 núcleos, 16 GB de RAM, até 100 GB de armazenamento. Isto atualmente não pode ser alterado, mas a Databricks planeja oferecer tipos de instância maiores no futuro.

  • Máximo de 40 sandboxes por usuário. Máximo de 100 sandboxes por workspace.

  • Disponível apenas nas seguintes regiões:

    • AWS us-east-1
    • AWS us-west-2
    • AWS eu-west-1
    • AWS ap-southeast-1
    • AWS ap-south-1

  • Endereços IP públicos do seu Databricks Sandbox podem mudar a qualquer momento.

  • Esta é uma versão beta. Dados armazenados no seu diretório inicial serão excluídos quando o período beta terminar. Não armazene nada que não se possa dar ao luxo de perder.

  • Não há uma forma nativa para persistir ambientes fora do diretório inicial ou para personalizar o seu ambiente no momento de startup. No entanto, você pode persistir quaisquer pacotes ou configuração necessários em seu diretório inicial.

Nesta página