エージェント型AI > Agent Assist > Prerequisites and installation

Prerequisites and installation¶

This page covers system requirements, prerequisite tools, installation, and configuration for DataRobot Agent Assist.

システム要件¶

Ensure your system meets the minimum requirements for running DataRobot Agent Assist.

Operating system: macOS or Linux (Windows requires WSL or another supported environment)
Python: 3.10 or higher

オペレーティングシステムの互換性

Agent AssistはmacOSおよびLinuxで動作します。 On Windows, use a DataRobot codespace, Windows Subsystem for Linux (WSL), or a virtual machine running a supported OS. Agentic Starterテンプレート自体は、Windowsをネイティブでサポートしています。これらのオプションを使用せずにWindowsで作業を行う場合は、Agentic Starterの使用を開始するを参照してください。

Prerequisite tools¶

At startup, DataRobot Agent Assist runs a dependency check via the DataRobot CLI and a .datarobot/cli/versions.yaml file. The following tools must be installed at the versions indicated. これらの最小要件は、Agentic Starterテンプレートのversions.yamlに基づいています。このファイルが信頼できる情報源であり、頻繁に更新されます。

ツールをシステム全体にインストールする

ツールをシステム全体にインストールすることで、すべてのターミナルセッション、およびDataRobot CLIでdr dependencies checkを実行した際に利用できるようになります。

ツール	バージョン	説明	インストール
dr-cli	>= 0.5.1	DataRobot CLI。	dr-cli installation
XPプラグイン	>= 2.0.0	ローカルでのエクスペリメントのトレースを行うためのDataRobot CLIプラグイン。	`dr plugin install xp`
git	>= 2.30.0	Version control.	git installation
uv	>= 0.10.3	Python package manager.	uv installation
Pulumi	>= 3.262.0	Infrastructure as Code.	Pulumi installation
Taskfile	>= 3.43.3	Task runner.	Taskfile installation
Node.js	>= 24	JavaScript runtime (for example, for template frontend).	Node.js installation

macOS installation

On macOS, several tools can be installed at once:

brew install datarobot-oss/taps/dr-cli uv pulumi/tap/pulumi go-task node git python

Install and run DataRobot Agent Assist¶

DataRobot Agent Assist can be run as a DataRobot CLI plugin. Install the plugin so that dr assist is available wherever the DataRobot CLI is installed. The plugin is discovered when the dr-assist executable is on the PATH and responds to --dr-plugin-manifest.

For the plugin published to the CLI plugin index, run:

dr plugin install assist

To verify the installation, run the following commands:

dr plugin list              # Should show "assist" when installed as plugin
dr assist --help            # Show commands

dr assistを初めて実行すると、DataRobot環境を選択するよう求められます。使用したいDataRobotインスタンスに対応する環境を選択します。

Output: DataRobot URL configuration

dr assist --help                                                           
🔌 Running plugin: assist
WARN  No DataRobot URL configured. Running auth setup...
🌐 DataRobot URL Configuration

Choose your DataRobot environment:

┌────────────────────────────────────────────────────────┐
│  [1] 🇺🇸 US Cloud        https://app.datarobot.com      │
│  [2] 🇪🇺 EU Cloud        https://app.eu.datarobot.com   │
│  [3] 🇯🇵 Japan Cloud     https://app.jp.datarobot.com   │
│      🏢 Custom          Enter your custom URL          │
└────────────────────────────────────────────────────────┘

🔗 Don't know which one? Check your DataRobot login page URL in your browser.

Enter your choice:

APIキーが指定されていない場合、認証フローによってブラウザーウィンドウでDataRobotアプリケーションが開きます。 アクセスリクエスト：DataRobot CLIダイアログボックスで、セッションの継続時間を設定し、続行するをクリックします。

空のディレクトリでdr assistを実行する

dr assistは、専用の空のディレクトリからのみ実行します。コードやその他のファイルが含まれるディレクトリでこのコマンドを実行するのは安全ではありません。エージェントアシストのコーディングワークフローを使用すると、アシスタントはDataRobot Agent Application Templateのクローンを現在のディレクトリに作成します。この操作によって既存のファイルが上書きされたり競合が発生したりする可能性があり、既存のプロジェクトが損なわれ、アシスタントの出力精度が低下する恐れがあります。 dr assistを実行する前に、専用のディレクトリがない場合は、ディレクトリを作成してそこでターミナルを開きます（たとえば、mkdir my-agent && cd my-agentを実行してから、dr assistを実行します）。

Set configuration variables¶

If necessary, set the following variables in the environment, in .env, or in the configuration files. In many cases, this configuration is handled by the DataRobot CLI through dr auth login.

特徴量	必須	説明	Default / notes
`DATAROBOT_API_TOKEN`	はい（DataRobot CLIの設定で指定されている場合を除く）	LLM Gateway（デフォルトプロバイダー）用DataRobot APIキー。	—
`DATAROBOT_ENDPOINT`	いいえ	DataRobot API endpoint.	`https://app.datarobot.com/api/v2`

For the full list of variables (including LLM overrides, logging, and config path overrides), see the Environment and commands reference. Agent AssistによるAGENT_ASSIST_LLM_MODEL_NAMEの解決方法、アシストモデルを制御しないファイル、およびdr assistを再起動する必要がある場合の詳細については、LLMモデルの選択と変更を参照してください。

??? + "Configuration variable priority" DataRobot Agent Assist reads configuration from multiple sources; to do this, it looks for credentials and settings in this order:

1. **環境変数**：`DATAROBOT_API_TOKEN`、`DATAROBOT_ENDPOINT`、および`AGENT_ASSIST_LLM_MODEL_NAME`などのLLM関連の変数
2. **.envファイル**：*現在の作業ディレクトリ*（`dr assist`を実行する場所）。上記と同じ変数名
3. **DataRobot CLIの設定**：`~/.config/datarobot/drconfig.yaml`（トークンとエンドポイント）。 Override path with `DATAROBOT_CLI_CONFIG`
4. **Agent Assistの設定**：`~/.config/datarobot/agent_assist_config.yaml`（オプションのLLM URL、モデル、APIキー）。 Override path with `AGENT_ASSIST_CONFIG`

**`~/.config/datarobot/agent_assist/settings.yaml`**は別のファイルです。これにはCLIの言語などの設定が保存され、**`AGENT_ASSIST_LLM_MODEL_NAME`**は設定されません。 そのファイルを参考にしてアシストLLMを選択しないでください。

For the format and behavior of the DataRobot CLI configuration file (`drconfig.yaml`), including token and endpoint, see the [DataRobot CLI documentation](../cli/configuration.md){ target=_blank }.

Startup behavior¶

Before the chat session starts, DataRobot Agent Assist:

Verifies the DataRobot CLI is available and runs dr dependencies check (using .datarobot/cli/versions.yaml if present).
Checks authentication and can run dr auth login if needed.
Ensures DATAROBOT_API_TOKEN (or equivalent from configuration) is set; if not, it displays an error and exits.