エージェント型AI > Agent Assist > Environment and commands reference

Environment and commands reference¶

このページでは、環境変数、アシストLLMの選択方法、重要なファイルとディレクトリ、list models プロンプトコマンド、およびスラッシュコマンドについて、概要をまとめています。

dr assistではなくサードパーティのコーディングエージェントを通じてAgent Assistを使用する場合は、以下のコマンドでスキルをインストールします。

npx ai-agent-skills install datarobot-oss/datarobot-agent-skills

インストール、設定、および使用のガイドラインについては、Agent Assistのスキルに関するページを参照してください。

環境変数¶

The variables that can be set in the environment or in .env.

特徴量	必須	説明	Default / notes
`DATAROBOT_API_TOKEN`	Yes (unless provided by DR CLI configuration)	LLM Gateway（デフォルトプロバイダー）用DataRobot APIキー。	—
`DATAROBOT_ENDPOINT`	いいえ	DataRobot API endpoint.	`https://app.datarobot.com/api/v2`
`AGENT_ASSIST_LLM_BASE_URL`	いいえ	アシストセッションのCompletions APIのベースURL。 Agent Assist LLMの変更を参照してください。	Derived from `DATAROBOT_ENDPOINT` (for example, `…/genai/llmgw`)
`AGENT_ASSIST_LLM_MODEL_NAME`	いいえ	アシストセッションのモデル。 Agent Assist LLMの変更を参照してください。	`anthropic/claude-sonnet-4-5-20250929`
`AGENT_ASSIST_LLM_API_KEY`	いいえ	外部のCompletions APIプロバイダー用のAPIキー。	設定されていない場合は、外部プロバイダーであっても`DATAROBOT_API_TOKEN`にフォールバックします。以下の警告を参照してください。
`AGENT_ASSIST_DISABLE_LLM_GATEWAY`	いいえ	LLM Gatewayによるカタログの取得を省略し、アシストセッションを`AGENT_ASSIST_LLM_MODEL_NAME`で指定されたモデル（たとえば、DataRobotのデプロイなど）に直接ルーティングします。 `AGENT_ASSIST_LLM_BASE_URL`およびデフォルト値以外の`AGENT_ASSIST_LLM_MODEL_NAME`も設定する必要があります。	未設定（LLM Gatewayのカタログを使用）
`LOGFIRE_TOKEN`	いいえ	Logfire token for tracing.	—
`DATAROBOT_CLI_CONFIG`	いいえ	Override path to DR CLI configuration file.	Default: `~/.config/datarobot/drconfig.yaml`
`AGENT_ASSIST_CONFIG`	いいえ	Override path to Agent Assist configuration file.	Default: `~/.config/datarobot/agent_assist_config.yaml`

OpenCodeプラグインでも読み込まれます

上記のAGENT_ASSIST_LLM_*およびAGENT_ASSIST_DISABLE_LLM_GATEWAY変数は、DataRobot OpenCodeプラグイン（dr opencode）によっても読み込まれます。 Agent Assistの設定ですでにこれらの変数が設定されている場合、OpenCodeは自動的にその同じ外部モデルへルーティングします。再設定は必要ありません。

外部プロバイダーにはAGENT_ASSIST_LLM_API_KEYを明示的に設定

DATAROBOT_API_TOKENへのフォールバックは、AGENT_ASSIST_LLM_BASE_URLの設定に関係なく適用されます。外部LLM（DataRobot以外のAGENT_ASSIST_LLM_BASE_URL）を設定し、AGENT_ASSIST_LLM_API_KEYを未設定のままにすると、Agent Assistは失敗せずに、DATAROBOT_API_TOKENをAPIキーとしてその外部エンドポイントに送信します。 AGENT_ASSIST_LLM_BASE_URLがデフォルトでない場合は、常にAGENT_ASSIST_LLM_API_KEYを明示的に設定します。

Files and directories¶

The paths and files used or created by DataRobot Agent Assist. All paths are relative to the current working directory when you start dr assist.

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

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

パス	説明
`agent_spec.md`	現在の作業ディレクトリ内のエージェント仕様ファイル（YAMLコンテンツ）。設計中にアシスタントによって作成されます。フィールドの定義や使用例については、エージェント仕様リファレンスを参照してください。
`.env`	Optional environment file in the current directory; same variable names as above.
`.datarobot/cli/versions.yaml`	Used by dependency check; defines minimum tool versions.
`~/.config/datarobot/drconfig.yaml`	DR CLI configuration (token, endpoint). This path can be overridden with `DATAROBOT_CLI_CONFIG`.
`~/.config/datarobot/agent_assist_config.yaml`	Agent Assist configuration (optional LLM base URL, model name, API key). This path can be overridden with `AGENT_ASSIST_CONFIG`.
`~/.config/datarobot/agent_assist/settings.yaml`	DataRobot CLI / Agent Assistのグローバル設定（言語など）。アシストLLMモデルは設定されません。環境または`.env`で`AGENT_ASSIST_LLM_MODEL_NAME`を使用してください。詳細については、Agent Assist LLMの変更を参照してください。
`config.yaml`	Optional repository-level configuration; can set `repository` (`url`, `branch`, `target_dir`, `tag`) for the template clone.

`list models`コマンド¶

$プロンプトで、list models（2つの単語で、先頭のスラッシュは不要）と入力すると、DataRobot LLM Gatewayから使用可能なLLM Gatewayモデルの一覧が表示されます。 Agent Assistは、行インデックス、モデル名（例：azure/gpt-5-1-2025-11-13またはbedrock/anthropic.claude-sonnet-4-5-20250929-v1:0）、プロバイダー（Anthropic、Azure OpenAI、Amazon Bedrock、Google Vertex AI、Together AIなど）、および簡単な説明が記載されたテーブルを表示します。表の後に、リストされているモデルの数、そのセッションで使用するように設定されているモデルの確認、モデルを変更するか会話を続けるかの選択を求めるプロンプトなどが出力されます。

具体的なモデルやプロバイダーは、組織のGateway設定や利用権限によって異なります。セッションで使用されるモデルは、Agent Assist LLMの変更で説明されているように決定されます。

list modelsや以下のスラッシュコマンド以外にも、$プロンプトで自然言語を使用して、設計、コーディング、デプロイのタスクを行ってください。

Slash commands¶

$プロンプトにおいて/で始まる組み込みセッションコマンド。単に/と入力するだけで、これらのコマンドの一覧が表示され、詳細については/helpと入力するよう提案されます。 シミュレーションセッションのコマンドはシミュレーション内でのみ適用され、メインの$プロンプトでは適用されません。

Command	エイリアス	説明
コアコマンド
`/help`	`/?`	List commands or show help for a command: `/help [command]`.
`/quit`	`/exit`	Exit the session (with confirmation).
セッションコマンド
`/reset`	`/new`	Clear session state and start fresh (removes `agent_spec.md` and template directory, clears conversation).
`/checkpoint`	-	セッションのチェックポイントを一覧表示または復元します。
`/compact`	-	会話履歴を圧縮してトークンの使用量を減らします。
`/resume`	-	現在のセッションに挿入された再開コンテキストを表示します。
`/save`	-	セッションの状態をディスクに保存します。
シミュレーションセッションのコマンド
`/quit`	`/exit`	シミュレーションを終了し、メインセッションに戻ります（確認のプロンプトは表示されません）。
`/f`	-	設計に関するフィードバックを記録します：`/f <text>`。シミュレーション終了時にサマリーにまとめられ、アシスタントはこれを使用して`agent_spec.md`を調整します。

Agent Assist LLMの変更¶

Agent Assistでは、次の2つのLLMを使用します。

アシストセッション：設計、シミュレーション、コーディングに関する会話に使用します。 AGENT_ASSIST_LLM_*変数を設定することで、DataRobot LLM Gatewayまたは外部のCompletions APIを利用できます。
コード化されたエージェント：Agent Assistが生成するアプリケーションに使用します。 agent_spec.md内のmodelフィールドを、自身のデプロイ環境にあるLLM GatewayモデルのIDに設定します。外部のAGENT_ASSIST_LLM_*設定は、コード化されたエージェントには適用されません。

アシストセッション¶

環境またはdr assistを実行するディレクトリの.envファイルにAGENT_ASSIST_LLM_MODEL_NAMEを設定します。複数の値が設定されている場合、Agent Assistはこの順序で最初に一致する値を使用します。

シェル内の環境変数。
現在の作業ディレクトリにある.env。
組み込みのデフォルト値：anthropic/claude-sonnet-4-5-20250929。

LLM Gateway（デフォルト）。AGENT_ASSIST_LLM_BASE_URLは未設定のままにします。 AGENT_ASSIST_LLM_MODEL_NAMEをlist modelsのモデルIDに設定します（例：anthropic/claude-sonnet-4-5-20250929）。

デフォルトのモデルがゲートウェイカタログにない場合

組織のLLM Gatewayでは、組み込みのデフォルトモデル（anthropic/claude-sonnet-4-5-20250929）が有効になっていない可能性があります。 dr assistがそのモデルにアクセスできない場合は、ターミナルからDataRobot CLIを使用して（実行中のセッションは不要です）、所属組織で有効にされているモデルを確認します。

dr llm list

MODEL列の値（例：azure/gpt-5-1-2025-11-13）をコピーし、dr assistを起動する前に設定します。

export AGENT_ASSIST_LLM_MODEL_NAME=azure/gpt-5-1-2025-11-13

dr llm listは、dr llm-gateway listの省略形です。セッション内のlist modelsコマンドと同様に、アクティブなGatewayカタログを一覧表示するほか、DataRobotにデプロイされ、このアカウントで利用可能なLLMも表示します。フラグと出力の詳細については、llm-gatewayコマンドリファレンスを参照してください。

モデルがカタログにまったく含まれていない場合は、組織管理者がそのモデルを有効にする必要があります。利用可能なLLMを参照してください。

Agent Assistでの外部LLMの使用

OpenAI互換のチャット補完エンドポイントを公開しているプロバイダーについては、AGENT_ASSIST_LLM_BASE_URL、AGENT_ASSIST_LLM_MODEL_NAME、およびAGENT_ASSIST_LLM_API_KEYを設定します。 3つすべてを設定します。AGENT_ASSIST_LLM_API_KEYを省略すると、Agent Assistは失敗するのではなく、この外部エンドポイントにDATAROBOT_API_TOKENを送信するようにフォールバックします。 dr assistを実行する前に、変数を.envに追加するか、エクスポートします。

Example: Anthropic

AGENT_ASSIST_LLM_MODEL_NAME=claude-sonnet-4-5
AGENT_ASSIST_LLM_BASE_URL=https://api.anthropic.com/v1
AGENT_ASSIST_LLM_API_KEY=YOUR_ANTHROPIC_API_KEY

プロバイダーのドキュメントに記載されているモデル名とURLを使用します。 list modelsコマンドは、Gatewayモデルのみを一覧表示します。

コード化されたエージェント¶

agent_spec.md内のmodelフィールドには、LLM GatewayのモデルIDを指定する必要があります。 AIエージェントのコーディングワークフローを実行する前に、組織のLLM Gatewayにゲートウェイモデルが用意されている必要があります。エージェント仕様リファレンスを参照してください。

モデルの設定

Agent AssistのLLM設定を変更する際には、以下の点に注意してください。

~/.config/datarobot/agent_assist/settings.yamlには、CLIの設定（言語など）が保存されています。ただし、AGENT_ASSIST_LLM_MODEL_NAMEは設定されません。
AGENT_ASSIST_LLM_*変数を変更したら、dr assistを再起動します。セッション内に/modelコマンドがありません。
資格情報の優先順位については、構成変数の設定に記載されています。