# トラブルシューティング

> トラブルシューティング - Plugin not discovered, dependency check failed, authentication errors, and related
> fixes.

This Markdown file sits beside the HTML page at the same path (with a `.md` suffix). It summarizes the topic and lists links for tools and LLM context.

Companion generated at `2026-07-23T18:01:59.337081+00:00` (UTC).

## Primary page

- [トラブルシューティング](https://docs.datarobot.com/ja/docs/agentic-ai/agent-assist/troubleshooting.html.md): Full documentation for this topic (Markdown sidecar).

## Sections on this page

- [Plugin not discovered](https://docs.datarobot.com/ja/docs/agentic-ai/agent-assist/troubleshooting.html.md#plugin-not-discovered): In-page section heading.
- [Dependency check failed](https://docs.datarobot.com/ja/docs/agentic-ai/agent-assist/troubleshooting.html.md#dependency-check-failed): In-page section heading.
- [Authentication / API key errors](https://docs.datarobot.com/ja/docs/agentic-ai/agent-assist/troubleshooting.html.md#authentication-api-key-errors): In-page section heading.
- [Template bootstrap failures](https://docs.datarobot.com/ja/docs/agentic-ai/agent-assist/troubleshooting.html.md#template-bootstrap-failures): In-page section heading.
- [LLM API errors](https://docs.datarobot.com/ja/docs/agentic-ai/agent-assist/troubleshooting.html.md#llm-api-errors): In-page section heading.
- [Session interruption](https://docs.datarobot.com/ja/docs/agentic-ai/agent-assist/troubleshooting.html.md#session-interruption): In-page section heading.
- [サポートについて](https://docs.datarobot.com/ja/docs/agentic-ai/agent-assist/troubleshooting.html.md#getting-help): In-page section heading.

## Documentation content

This page describes how to resolve common issues with DataRobot Agent Assist, including plugin discovery, dependency checks, authentication and API keys, template bootstrap failures, LLM API errors, and session interruption. Follow the sections below for step-by-step fixes.

## Plugin not discovered

If `dr assist` does not run or the plugin does not appear in `dr plugin list`:

Check that `dr-assist` is on the PATH

```
which dr-assist 
```

If it is not found, reinstall the plugin and ensure the directory containing `dr-assist` is on the `PATH`.

Check manifest output

The CLI discovers plugins by running the executable with `--dr-plugin-manifest` and reading JSON from stdout.

```
dr-assist --dr-plugin-manifest 
```

This should print valid JSON. If it hangs or errors, the plugin may not start correctly.

Check manifest speed

The manifest must respond within 100 ms for reliable discovery; the CLI uses a 500 ms per-manifest timeout.

```
time dr-assist --dr-plugin-manifest 
```

If it is slow, look for heavy imports or startup work before the manifest is printed.

Debug with the CLI

```
dr --debug plugin list 
```

Use this to see why a plugin might not be listed.

Common causes:

The manifest responds in over 500 ms, the executable lacks execute permission ( `chmod +x`), or the name conflicts with a built-in command.

## Dependency check failed

At startup, DataRobot Agent Assist runs `dr dependencies check`, which uses `.datarobot/cli/versions.yaml`. ファイルが存在しない場合、アプリケーションはデフォルトの最小バージョン（Node 24、git 2.30、task 3.43.3、pulumi 3.163.0）で作成します。

- Error panel:If the check fails, the application shows a "Dependency Check Failed" panel and prints the dependency error output.
- What to do:Install or upgrade the missing tools to at least the versions in the table inPrerequisites and installation. Ensure each tool is on thePATHand reports at least the minimum version (for example,git --version,task --version). Fix any issues reported in the panel (for example, wrong executable name or path).

## Authentication / API key errors

DataRobot Agent Assist requires a valid DataRobot API token. Use the following for missing or invalid credentials.

Missing API key

If `DATAROBOT_API_TOKEN` (or equivalent from configuration) is not set, the application shows a "Configuration Error" panel before starting the chat. Do one of the following:

- Set the environment variable: export DATAROBOT_API_TOKEN='your-api-key-here'
- Create or update a .env file in the current directory with DATAROBOT_API_TOKEN=...
- Get the API key from the URL returned by get_api_key_url() (for example, DataRobot account profile).

Invalid or expired key

On authentication failure (for example, OpenAI `AuthenticationError`), the application shows an "Authentication Error" panel. Verify the key, run `echo $DATAROBOT_API_TOKEN`, update `.env` if needed, and fetch a new key from the provider URL.

Using the DataRobot CLI for authentication

Log in with the DataRobot CLI; the token is stored in the DR CLI configuration and reloaded by DataRobot Agent Assist:

```
dr auth login 
```

If login fails, the application prints "DataRobot CLI authentication failed" and suggests running `dr auth login` manually.

## Template bootstrap failures

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

If you see unexpected files, overwrites, or odd behavior after a clone, you may have started in a non-empty directory.

If a git clone fails during the coding workflow (for example, when cloning the DataRobot agent template):

Verify git is installed and on the PATH:

```
git --version 
```

Check network access to the repository:

```
git ls-remote https://github.com/datarobot-community/datarobot-agent-application.git 
```

If using SSH, verify SSH keys are configured:

```
ssh -T git@github.com 
```

## LLM API errors

For timeouts, rate limiting, or model-not-available errors:

- Check DataRobot service status.
- アカウントにLLM Gatewayへのアクセス権があることを確認します。
- 選択したモデルが使用できない場合は、 Agent Assist LLMの変更 に記載されている手順に従って、 AGENT_ASSIST_LLM_MODEL_NAME （または .env ）を設定し、別のモデルを試します。
- 新しい dr assist セッションを開始して、設定を再読み込みします。
- For timeouts, the assistant prompts you to retry.

## Session interruption

If the session ends unexpectedly:

- セッションの状態は軽量なメタデータとして保存され、アシスタントは実用的なレベルの十分なコンテキストを再構築できます。
- The agent_spec.md file is saved to disk and preserved.
- Template directory contents are preserved.
- Restart the session to continue.

## サポートについて

For more assistance see the following related documentation:

- DataRobot CLI: For CLI installation, configuration file format, and authentication flow: DataRobot CLI documentation .
- Plugin build and CI: See the plugin README in the repository for distribution, build, and troubleshooting.