メインコンテンツまでスキップ

エージェント ランタイム

Agent Runtime は、Databricks がホストする Serverless コンピュート上でエージェントを実行します。DurableAgentServer などのエージェントサーバーを Databricks Apps 上で実行するため、サーバーのプロビジョニングを行わずにコードをデプロイできます。Agent ランタイム がお使いのフレームワークやエージェントサーバーとどのように連携するかについては、Databricks でのエージェントのデプロイを参照してください。

エージェントランタイムが提供するもの​

  • 安定した認証済みのEndpoint :各デプロイメントは、独自のURLを持つagent-bricks-<name>という名前のアプリです。クライアントはDatabricks OAuthトークンを使用して認証します。Databricksにデプロイされたエージェントをクエリーするを参照してください。
  • Agent identity : エージェントはアプリのService Principalのランとして実行されます。「Agent identity」を参照してください。
  • 耐久性のある実行 : DurableAgentServer を使用するエージェントの場合、デプロイによってランタイム ストアがプロビジョニングされ、ワーカーの再起動後もランの状態が維持され、中断されたランを回復できるようになります。
  • トレーシング :デプロイにより、プロジェクトがバインドするエクスペリメントへのMLflowトレーシングが設定されます。トレーシングの概要を参照してください。
  • スケーリング : 複数のインスタンスにわたってエージェントをスケールしてランします。Databricks Appsの水平スケーリングを参照してください。

エージェントのID​

エージェントのIDは、それがデプロイされるアプリの Service Principal です。エージェントはこのIDを使用してDatabricks APIを呼び出し、--auth appで追加したツールを実行します。

  • デプロイすると、agentbricks deploy は Service Principal に、エージェントが使用するメモリ、セッション、およびランの状態ストアへのアクセス権を付与します。
  • エージェントに他のデータおよびリソースへのアクセス権を付与するには、他のアプリの場合と同様に、アプリのService Principalに必要な権限を付与します。Databricks アプリでの承認の構成を参照してください。
  • auth = "user"を使用するツールは、Service Principalではなく、リクエストを送信したユーザーの権限でランを実行します。リクエスト側ユーザーの承認を参照してください。

前提条件​

  • Databricks CLI、Python 3.11以降、および uvをインストールします。

  • Agent Bricks CLIをインストールします:

    Bash
    uv tool install databricks-agentbricks
  • ワークスペースにサインインします。agentbricks loginはプロファイルをdefaultとして保存するため、以降のコマンドは--profileを省略できます。

    Bash
    databricks auth login --host <workspace-url> --profile <profile>
    agentbricks login --profile <profile>
  • エージェントプロジェクトを作成し、そのディレクトリに変更します:

    Bash
    agentbricks init my-agent
    cd my-agent

エージェントをデプロイする​

Agent Bricks CLIを使用してエージェントプロジェクトをデプロイします。

プロジェクトディレクトリからデプロイ​

エージェントをデプロイするには、プロジェクトディレクトリから次のコマンドを実行します。

Bash
agentbricks deploy my-agent

default以外のワークスペースにデプロイするには、--profile <profile>を渡します。

プロジェクトディレクトリには agent.toml と app.yaml が格納されます。他のディレクトリから agentbricks deploy をランすると、そのディレクトリがuploadされます。他のディレクトリからプロジェクトをデプロイするには、 --source <dir> を渡します。

agentbricks deploy の引数は、最大17文字のデプロイ名です。アプリの名前は agent-bricks-<name> なので、この例では agent-bricks-my-agent が作成されます。最初のデプロイは agent.toml に名前を記録するため、プロジェクトからの以降のデプロイでは名前を省略できます。

最初のデプロイには数分かかります。エージェントがリクエストに応答すると、コマンドは終了します。

agentbricks deploy は、次の処理を行います:

  1. agent.toml で宣言されたメモリおよびセッションストアを作成または再利用し、アプリの Service Principal にそれらへのアクセス権を付与します。
  2. DurableAgentServer を使用するエージェントの場合、デプロイの ランタイム Store を作成するか再利用します。
  3. トレースを構成します。
  4. アプリをデプロイします。

複数のインスタンスでエージェントを実行するには、--instancesを渡します:

Bash
agentbricks deploy my-agent --instances 2

エージェントが複数のインスタンスでランを実行する場合、クライアントは X-Routing-Key ヘッダーにセッションIDを送信することで、セッション内のすべてのリクエストを同じインスタンスにルーティングできます。

待機せずにデプロイ​

スクリプトまたはコーディングエージェントのコマンドタイムアウトが短い場合は、待機せずにデプロイし、別のコマンドでデプロイを待機します。

Bash
agentbricks deploy my-agent --no-wait
agentbricks deployments wait agent-bricks-my-agent

--no-wait クイックチェックをランし、バックグラウンドプロセスでデプロイを完了します。agentbricks deployments wait は default で最大100秒待機します。制限を変更するには、 --timeout を渡します。コマンドは以下のコードのいずれかで終了します:

  • 0:エージェントがデプロイされ、リクエストに応答します。
  • 1: デプロイに失敗しました。
  • 75:エージェントはまだデプロイ中です。コマンドを再度ランしてください。

プロジェクトディレクトリから agentbricks deployments wait をランするか、 --source <dir> を渡します。

デプロイメントの管理​

コマンド

説明

agentbricks deployments list

エージェントのデプロイを一覧表示します。

agentbricks deployments get <app-name>

デプロイメントのURL、ステータス、説明を表示します。

agentbricks deployments wait [<app-name>]

デプロイメントが完了するのを待ちます。defaultはagent.tomlに記録されたデプロイメントです。

agentbricks deployments logs <app-name>

デプロイメントの Logs を表示します。

agentbricks deployments start <app-name>

デプロイメントを起動します。

agentbricks deployments stop <app-name>

デプロイメントを停止します。--yesが渡されない限り、確認を求めます。

agentbricks deployments delete <app-name>

デプロイメントを削除します。--yes を渡さない限り、確認を求めます。

コマンド

説明

agentbricks deployments list

エージェントのデプロイを一覧表示します。

agentbricks deployments get <app-name>

デプロイメントのURL、ステータス、説明を表示します。

agentbricks deployments wait [<app-name>]

デプロイメントが完了するのを待ちます。defaultはagent.tomlに記録されたデプロイメントです。

agentbricks deployments logs <app-name>

デプロイメントの Logs を表示します。

agentbricks deployments start <app-name>

デプロイメントを起動します。

agentbricks deployments stop <app-name>

デプロイメントを停止します。--yesが渡されない限り、確認を求めます。

agentbricks deployments delete <app-name>

デプロイメントを削除します。--yes を渡さない限り、確認を求めます。

各デプロイメントは1つのアプリであるため、Databricks Appsで表示およびモニタリングすることもできます。「Logging and モニタリング for Databricks Apps」を参照してください。

制限事項​

既存のデプロイメントのエージェントサーバーは変更できません。サーバーを切り替えるには、必要な agentbricks init --server オプションを使用して新しいプロジェクトを作成し、新しい名前でデプロイします。

その他のリソース​