エージェント型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`	いいえ	Base URL for the assist session Completions API. See Change the Agent Assist LLM.	Derived from `DATAROBOT_ENDPOINT` (for example, `…/genai/llmgw`)
`AGENT_ASSIST_LLM_MODEL_NAME`	いいえ	Model for the assist session. See Change the Agent Assist LLM.	`anthropic/claude-sonnet-4-5-20250929`
`AGENT_ASSIST_LLM_API_KEY`	いいえ	API key for an external Completions API provider.	Falls back to `DATAROBOT_API_TOKEN` if unset—even for an external provider. See the warning below.
`AGENT_ASSIST_DISABLE_LLM_GATEWAY`	いいえ	Skip the LLM gateway catalog fetch and route the assist session directly to the model named by `AGENT_ASSIST_LLM_MODEL_NAME` (for example, a DataRobot deployment). Requires `AGENT_ASSIST_LLM_BASE_URL` and a non-default `AGENT_ASSIST_LLM_MODEL_NAME` to also be set.	Unset (LLM gateway catalog used)
`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は自動的にその同じ外部モデルへルーティングします。再設定は必要ありません。

Set AGENT_ASSIST_LLM_API_KEY explicitly for external providers

The fallback to DATAROBOT_API_TOKEN applies regardless of what AGENT_ASSIST_LLM_BASE_URL is set to. If you configure an external LLM (a non-DataRobot AGENT_ASSIST_LLM_BASE_URL) and leave AGENT_ASSIST_LLM_API_KEY unset, Agent Assist sends your DATAROBOT_API_TOKEN to that external endpoint as the API key instead of failing. Always set AGENT_ASSIST_LLM_API_KEY explicitly whenever AGENT_ASSIST_LLM_BASE_URL is not the default.

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設定や利用権限によって異なります。 Which model the session uses is determined as described in Change the Agent Assist LLM.

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

Slash commands¶

$プロンプトにおいて/で始まる組み込みセッションコマンド。単に/と入力するだけで、これらのコマンドの一覧が表示され、詳細については/helpと入力するよう提案されます。 Simulation session commands apply only inside simulation, not at the main $ prompt.

Command	エイリアス	説明
Core commands
`/help`	`/?`	List commands or show help for a command: `/help [command]`.
`/quit`	`/exit`	Exit the session (with confirmation).
Session commands
`/reset`	`/new`	Clear session state and start fresh (removes `agent_spec.md` and template directory, clears conversation).
`/checkpoint`	-	セッションのチェックポイントを一覧表示または復元します。
`/compact`	-	会話履歴を圧縮してトークンの使用量を減らします。
`/resume`	-	現在のセッションに挿入された再開コンテキストを表示します。
`/save`	-	セッションの状態をディスクに保存します。
Simulation session commands
`/quit`	`/exit`	Exit the simulation and return to the main session (no confirmation prompt).
`/f`	-	Record feedback about the design: `/f <text>`. Compiled into a summary when the simulation ends, which the assistant uses to help refine `agent_spec.md`.

Agent Assist LLMの変更¶

Agent Assist uses two LLMs:

Assist session: For design, simulation, and coding conversations. Set AGENT_ASSIST_LLM_* variables to use the DataRobot LLM gateway or an external Completions API.
Coded agent: For the application Agent Assist generates. Set the model field in agent_spec.md to an LLM gateway model ID on your deployment. External AGENT_ASSIST_LLM_* settings do not apply to the coded agent.

Assist session¶

Set AGENT_ASSIST_LLM_MODEL_NAME in the environment or in a .env file in the directory where you run dr assist. When more than one value is set, Agent Assist uses the first match in this order:

Environment variable in the shell.
.env in the current working directory.
Built-in default: anthropic/claude-sonnet-4-5-20250929.

LLM gateway (default). Leave AGENT_ASSIST_LLM_BASE_URL unset. Set AGENT_ASSIST_LLM_MODEL_NAME to a model ID from list models (for example anthropic/claude-sonnet-4-5-20250929).

If the default model isn't in your gateway catalog

The built-in default (anthropic/claude-sonnet-4-5-20250929) may not be enabled for your organization's LLM gateway. If dr assist can't reach that model, check which models your organization has enabled from a terminal—no running session required—using the DataRobot CLI:

dr llm list

Copy a value from the MODEL column (for example azure/gpt-5-1-2025-11-13), then set it before you start dr assist:

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

dr llm list is a shorthand alias for dr llm-gateway list. It lists the same active gateway catalog as the in-session list models command, plus any DataRobot-deployed LLMs available to your account. See the llm-gateway command reference for the full flag and output reference.

If a model isn't in the catalog at all, an org admin must enable it; see LLM availability.

Use an external LLM for Agent Assist

Set AGENT_ASSIST_LLM_BASE_URL, AGENT_ASSIST_LLM_MODEL_NAME, and AGENT_ASSIST_LLM_API_KEY for any provider that exposes an OpenAI-compatible chat completions endpoint. Set all three—if you omit AGENT_ASSIST_LLM_API_KEY, Agent Assist falls back to sending your DATAROBOT_API_TOKEN to this external endpoint instead of failing. Add the variables to .env or export them before you run dr assist:

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

Use model names and URLs from the provider documentation. The list models command lists gateway models only.

Coded agent¶

The model field in agent_spec.md must be an LLM gateway model ID. Gateway models must be available in your organization's LLM gateway before you run the Code an AI agent workflow. See the Agent specification reference.

Model settings

Consider the following when changing agent assist LLM settings:

~/.config/datarobot/agent_assist/settings.yaml stores CLI preferences (for example language). It does not set AGENT_ASSIST_LLM_MODEL_NAME.
Restart dr assist after you change AGENT_ASSIST_LLM_* variables. There is no in-session /model command.
Credential precedence is described in Set configuration variables.