メインコンテンツまでスキップ
に最終更新

Databricks サンドボックス

注記

ベータ版

この機能はベータ版です。現時点では、Databricks はこの機能のご利用に対して課金を行いません。

Databricks サンドボックスは、人間とエージェント向けで、SSH経由でアクセス可能であり、Databricksのサーバレス コンピュート プレーンで実行されるコンピュート環境です。

サンドボックスでは、次のことが可能です：

  • SSH経由でアクセス可能な永続的な開発用サンドボックスを作成できます。ローカルマシンを稼働させておく必要なく、より長いエージェントタスクを実行します。

  • 安全なサンドボックス環境でコーディングエージェントを実行する：

    • SSH経由でDatabricks CLIからコーディングエージェントを直接操作できます。
    • Cursor、Claude、CodexなどのデスクトップIDEまたはエージェントハーネスに接続します。

  • サブエージェント、エクスペリメント、またはエージェント作成プログラム向けに、短期間の環境を立ち上げます。これをMCPと組み合わせて使用するか、Supervisor APIまたはApps上のカスタムエージェントを使用してカスタムエージェントを構築する際に使用してください。

Databricks サンドボックスはなぜ使用すべきですか？​

  • Databricks ネイティブ ガバナンス

    • Databricks サーバレス コンピュート プレーンで実行されます。Databricks サンドボックス上のデータは、ワークスペースのガバナンス境界内に維持されます。
    • AI Gatewayとのシームレスな統合により、ガバナンスの効いたLLM推論およびMCPコールが実現します。

  • エージェント実行用に構築された

    • 数秒で開始。エクスペリメント、サブエージェント、または独立したタスク用に新規環境を作成し、完了したら破棄します。
    • ストレージはセッションをまたがって保持されます。ツールと設定を一度インストールし、Databricks サンドボックスを停止し、その後、同じファイルシステムと状態に再接続してください。
    • 1つのインスタンスで並列セッションを実行します。共有ファイルシステム経由で、1つのDatabricksサンドボックスに複数のSSHセッションを開きます。同じインスタンス上で、別のセッションでログを追跡したり、ファイルを編集したりする間に、一方のセッションでエージェントがタスクに取り組むことができます。

前提条件 (CLI)​

Databricks CLI を使用して Databricks サンドボックスを作成および使用するには、次の手順を実行します。

  1. ローカルマシンにDatabricks CLIをインストールしてください。

  2. Databricks CLI を databricks auth login を使用して認証します:

Bash
databricks auth login  # authenticate to a Databricks workspace
注記

サンドボックスは、スーパーバイザーAPIなどの他の製品によって自動的に起動できます。

サンドボックスを作成（CLI）​

Databricks CLIを使用してDatabricksサンドボックスを作成するには、以下のコマンドを実行します:

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

サンドボックスに SSH 接続すると、サンドボックスが実行されている Databricks ワークスペースに Databricks CLI がインストールされ、認証されます。Git認証情報を設定することもできます。Git プロバイダーを Databricks に接続するを参照してください。

詳細なコマンド ヘルプについては、databricks sandbox -h を実行するか、sandboxコマンド・グループを参照してください。

コーディングエージェントの実行​

Databricks では、Unity AI Gateway コーディング CLI である ucode を使用して、コーディングエージェントを実行することをお勧めします。ucodeを使用すると、AI Gatewayを使用するためにお好みのエージェントハーネスを設定できます。セットアップのため、ucode configureを実行してください。

  • CLI を直接利用します: ターミナルから SSH で接続します。AI Gateway 統合で、お好みのコーディングエージェントを活用するには、ucode を使用します。
  • SSH 経由でデスクトップアプリを接続する ：Claude、Codex、Visual Studio Code、または Cursor の使用に関する手順を参照してください。
  • Web UI を実行 ：例えば、OpenCode web を実行し、SSHポート転送を使用してローカルマシンから接続します。

データ永続性​

警告

ベータ期間中のストレージは永続的ではなく、削除される可能性があります。

Databricks サンドボックスにはネットワーク接続ストレージが付属しています。パフォーマンスは一般的なクラウドサービスと類似しています。

  • 1つのDatabricksサンドボックスに対して複数の並列SSHセッションを開始でき、すべてのセッションが同じファイルシステムを参照します。
  • ホームディレクトリ (/home/sandbox-agent) 内のデータは、Databricks サンドボックスの有効期間中保持されます。Databricks サンドボックスを停止した後でも、次のセッションを開始したときにホームディレクトリのデータは利用可能です。
  • ホームディレクトリは最大100 GBまで保存できます。これは現時点では変更できません。
  • ホームディレクトリ外のデータは、サンドボックスを停止すると削除されます。ホームディレクトリ以外に、最大10 GBまで保存可能です。

使用状況とコスト​

請求使用状況に関する詳細については、Databricks の価格を参照してください。Databricks では、以下のサンドボックス利用分の課金を見込んでいます。

  • Databricks サンドボックスの実行中に時間単位で課金される Runtime コンピュート 正確な料金は決定されます。

    • ホームディレクトリ外のストレージは、Databricks サンドボックスのランタイム コンピュート コストの一部として含まれています。

  • ホームディレクトリ内の 永続ストレージ を、デフォルトストレージと同等の料金でご利用いただけます。

    • Databricks サンドボックスが削除されるまで、ホームディレクトリに保存されているデータに課金されます。
    • Databricks サンドボックスインスタンスが存在する限り、ストレージに課金が発生します。Databricksサンドボックスを停止しても、ストレージの請求は停止されません。

  • 既存の速度でのデータ転送

制限事項：​

  • まだサーバレス出力制御と統合されていません。Databricks サンドボックスは、（SEG）が有効になっているワークスペースでは使用しないでください。サーバレスエグレス制御の詳細については、サーバレスエグレス制御とは何ですか？を参照してください。

  • 技術仕様：4コア、16 GB RAM、最大100 GBストレージ。これは現在変更できませんが、Databricksは将来的に、より大きなインスタンスタイプを提供する予定です。

  • ユーザーあたり最大40個のサンドボックス。ワークスペースあたり最大100個のサンドボックスです。

  • 次の地域でのみ利用できます。

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

  • Databricks サンドボックスのパブリック IP アドレスはいつでも変更される可能性があります。

  • これはベータ版リリースです。 ホームディレクトリに保存されたデータは、ベータ期間が終了すると削除されます。 失いたくないものは保存しないでください。

  • ホームディレクトリの外部で環境を保持したり、起動時に環境をカスタマイズしたりするネイティブな方法はありません。ただし、必要なパッケージまたは設定はホームディレクトリに保持できます。

このページの見出し