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

> トラブルシューティング - DataRobotエージェントテンプレートを使用する際の一般的な問題のトラブルシューティング。

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-15T05:55:44.568151+00:00` (UTC).

## Primary page

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

## Sections on this page

- [前提条件とセットアップの問題](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#prerequisites-and-setup-issues): In-page section heading.
- [Windowsとの互換性](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#windows-compatibility): In-page section heading.
- [前提条件を満たしていない](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#missing-prerequisites): In-page section heading.
- [ビルドツールがない](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#build-tools-missing): In-page section heading.
- [環境設定の問題](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#environment-configuration-issues): In-page section heading.
- [環境変数がない](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#missing-environment-variables): In-page section heading.
- [無効なエンドポイント設定](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#invalid-endpoint-configuration): In-page section heading.
- [認証に関する問題](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#authentication-issues): In-page section heading.
- [APIトークンの認証が失敗した](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#api-token-authentication-failed): In-page section heading.
- [認可コンテキストが設定されていない](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#authorization-context-not-set): In-page section heading.
- [デプロイに関する問題](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#deployment-issues): In-page section heading.
- [Pulumiへのログインが必要](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#pulumi-login-required): In-page section heading.
- [デプロイIDが見つからない](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#deployment-id-not-found): In-page section heading.
- [CLIとテストに関する問題](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#cli-and-testing-issues): In-page section heading.
- [CLIコマンドが見つからない](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#cli-command-not-found): In-page section heading.
- [ローカルテストが失敗](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#local-testing-fails): In-page section heading.
- [インフラストラクチャに関する問題](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#infrastructure-issues): In-page section heading.
- [Dockerの構築が失敗する](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#docker-build-fails): In-page section heading.
- [Pulumiの状態に関する問題](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#pulumi-state-issues): In-page section heading.
- [myagent.pyでのインポートの問題](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#import-issues-in-myagent-py): In-page section heading.
- [LLM Gatewayに関する問題](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#llm-gateway-issues): In-page section heading.
- [モデルアクセスエラー](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#model-access-error): In-page section heading.
- [LLM Gatewayの設定](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#llm-gateway-configuration): In-page section heading.
- [Gateway以外のモデルのデプロイ](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#non-gateway-model-deployment): In-page section heading.
- [リクエストヘッダーへのアクセス](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#accessing-request-headers): In-page section heading.
- [X-Untrusted-*ヘッダーの抽出](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#extracting-x-untrusted-headers): In-page section heading.
- [一般的なユースケース](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#common-use-cases-for-headers): In-page section heading.
- [重要な注意事項](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#header-considerations): In-page section heading.
- [デバッグのヒント](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#debugging-tips): In-page section heading.
- [冗長ログを有効にする](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#enable-verbose-logging): In-page section heading.
- [認証のテスト](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#test-authentication): In-page section heading.
- [環境変数のチェック](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#check-environment-variables): In-page section heading.
- [デバッグのためリクエストヘッダーのログを取る](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#log-request-headers): In-page section heading.
- [サポートについて](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#getting-help): In-page section heading.

## Documentation content

このガイドは、DataRobotエージェントテンプレートを使用する際によくある問題の診断と解決に役立ちます。

## 前提条件とセットアップの問題

DataRobotエージェントテンプレートのシステム要件と初期設定に関する一般的な問題。

### Windowsとの互換性

問題 ：DataRobotエージェントテンプレートでは、Windowsはサポートされていません。

解決方法 ：開発にはmacOSまたはLinuxを使用します。

### 前提条件を満たしていない

問題 ：必要なツールがインストールされていません。

解決方法 ： [前提条件ガイド](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-install.html.md) に従って、不足しているツールをインストールします。

### ビルドツールがない

問題 ：使用中のシステムにビルドツールがありません。

解決方法 ：Xcode Command Line Tools（macOS）または build-essential（Linux）をインストールします。

## 環境設定の問題

環境変数とDataRobotエンドポイント設定の問題。

### 環境変数がない

問題 ：必要な環境変数が設定されていません。

解決方法 ： `DATAROBOT_API_TOKEN` と `DATAROBOT_ENDPOINT` を含む `.env` ファイルを作成します。

### 無効なエンドポイント設定

問題 ：DataRobotエンドポイントの設定が正しくありません。

解決方法 ：リージョンに合った正しいエンドポイントを使用するか（クラウドの場合）、サポート（オンプレミス）にお問い合わせください（オンプレミスの場合）。

## 認証に関する問題

API認証と認可コンテキストの設定に関する問題。

### APIトークンの認証が失敗した

問題 ：APIトークンが無効か、適切な権限がありません。

解決方法 ：APIトークンが有効で、適切な権限があるか確認します。

### 認可コンテキストが設定されていない

問題 ：認可コンテキストがエージェントで初期化されていません。

解決方法 ： `initialize_authorization_context()` がエージェントで呼び出されるようにします。

## デプロイに関する問題

デプロイプロセスやインフラストラクチャの管理で発生した問題。

### Pulumiへのログインが必要

問題 ：Pulumiの認証が設定されていません。

解決方法 ：pulumi login --local `または` pulumi login`を実行します。

### デプロイIDが見つからない

問題 ：デプロイ後にデプロイIDが見つかりません。

解決方法 ：ターミナル出力または DataRobot UI → コンソール → デプロイを確認します。

## CLIとテストに関する問題

コマンドラインインターフェイスの使用とエージェントのローカルテストに関する問題。

### CLIコマンドが見つからない

問題 ：CLIコマンドがありません。

解決方法 ：DataRobot CLIがインストールされ、PATHに設定されていることを確認します。 インストールについては [DataRobot CLIの開始方法](https://docs.datarobot.com/ja/docs/agentic-ai/cli/getting-started.html.md) を参照し、 `dr start` を実行してフレームワークを選択します。 CLI固有の問題については、 [CLIのトラブルシューティング](https://docs.datarobot.com/ja/docs/agentic-ai/cli/troubleshooting.html.md) を参照してください。

### ローカルテストが失敗

問題 ：開発中にエージェントを実行しようとすると、ローカルテストでエラーが発生します。

解決方法 ：CLIコマンドを使用して、エージェントをローカルでテストします。 これにより、DataRobotにデプロイすることなく、エージェントコードを実行してデバッグすることができます。 `execute` コマンドを実行するには、開発サーバーが稼働している必要があります。 `task agent:dev` を使用して手動で起動したり（継続的に実行されるため、別のターミナルを使用してください）、 `START_DEV=1` を使用して自動的に起動および停止したりできます。

- 基本的なテキストクエリーでテストする： task agent:cli START_DEV=1 -- execute --user_prompt "Hello" （または、最初に task agent:dev を起動してから、 task agent:cli--execute--user_prompt"Hello" を実行）
- JSON入力でテストする： task agent:cli START_DEV=1 -- execute --user_prompt '{"topic": "Artificial Intelligence"}'
- 出力JSONファイルでテストする： task agent:cli START_DEV=1 -- execute --completion_json example-completion.json
- 冗長ログを有効にする：補完JSONの extra_body フィールドに "verbose": true を追加します。

よくある問題としては、環境変数（ `DATAROBOT_API_TOKEN` 、 `DATAROBOT_ENDPOINT` ）の欠落、 `myagent.py` でのインポートの問題（ [インポートの問題](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md#import-issues-in-myagent-py) を参照）、 `pyproject.toml` での依存関係の欠落などがあります。

## インフラストラクチャに関する問題

コンテナ化、構築プロセス、インフラストラクチャの状態管理に関する問題。

### Dockerの構築が失敗する

問題 ：Dockerコンテナの構築でエラーが発生します。

解決方法 ：ローカルでテストし、 `pyproject.toml` の依存関係をチェックします。

### Pulumiの状態に関する問題

問題 ：Pulumiの状態が同期していません。

解決方法 ： `task infra:refresh` を実行して状態を同期します。

### myagent.pyでのインポートの問題

問題 ： `myagent.py` で、同じフォルダーのファイルにインポートすると、DRUMでサイレントエラーが発生します。

解決方法 ：パッケージインポートではなく、相対インポート利用します。

## LLM Gatewayに関する問題

LLM Gatewayの接続、モデルへのアクセス、および設定に関する問題。

### モデルアクセスエラー

問題 ：LLM Gatewayがモデルに接続できないか、「モデルへのアクセス権がない」というエラーで失敗します。

解決方法 ：モデルにアクセスできるようにします。 アクセス権のないモデル（またはサポートが終了したモデル）を指定した場合、ゲートウェイへの接続は可能ですが、アクションは「モデルにアクセスできない」エラーで失敗します。

### LLM Gatewayの設定

問題 ：LLM Gatewayが正しく設定されていません。

解決方法 ：所属する組織が [LLM Gateway](https://docs.datarobot.com/ja/docs/reference/gen-ai-ref/llm-availability.html.md) にアクセスできることと、 `model-metadata.yaml` ファイルに `ENABLE_LLM_GATEWAY_INFERENCE` ランタイムパラメーターを指定し、 `true` に設定していることを確認します。

### Gateway以外のモデルのデプロイ

問題 ：Gateway以外のモデルのデプロイが失敗します。

解決方法 ：Gatewayモデルを使用していない場合は、LLMデプロイの実行に失敗しても、 `task deploy` を1回実行します。

## リクエストヘッダーへのアクセス

エージェントがデプロイされると、認証、追跡、またはカスタムメタデータのために、HTTPリクエストヘッダーにアクセスする必要があるかもしれません。 DataRobot は `chat()` 関数の `**kwargs` パラメーターを通して、エージェントコードからヘッダーを利用できるようにします。

### X-Untrusted-*ヘッダーの抽出

`X-Untrusted-*` プレフィックスを持つヘッダーは、元のリクエストから渡され、 `kwargs` ディクショナリで使用できます。

```
import asyncio
from concurrent.futures import ThreadPoolExecutor
from typing import Any, Iterator, Union
from openai.types.chat import CompletionCreateParams
from openai.types.chat.completion_create_params import (
    CompletionCreateParamsNonStreaming,
    CompletionCreateParamsStreaming,
)

def chat(
    completion_create_params: CompletionCreateParams
    | CompletionCreateParamsNonStreaming
    | CompletionCreateParamsStreaming,
    load_model_result: tuple[ThreadPoolExecutor, asyncio.AbstractEventLoop],
    **kwargs: Any,
) -> Union[CustomModelChatResponse, Iterator[CustomModelStreamingResponse]]:
    # Extract all headers from kwargs
    headers = kwargs.get("headers", {})

    # Access specific X-Untrusted-* headers
    authorization_header = headers.get("X-Untrusted-Authorization")
    custom_header = headers.get("X-Untrusted-Custom-Metadata")

    # Use headers in your agent logic
    if authorization_header:
        # Pass to downstream services, tools, etc.
        print(f"Authorization header: {authorization_header}") 
```

### 一般的なユースケース

外部サービスに認証を渡す ：

```
headers = kwargs.get("headers", {})
auth_token = headers.get("X-Untrusted-Authorization")

# Use the token to authenticate with external APIs
tool_client = MyTool(auth_token=auth_token) 
```

リクエストメタデータの追跡 ：

```
headers = kwargs.get("headers", {})
request_id = headers.get("X-Untrusted-Request-ID")
user_id = headers.get("X-Untrusted-User-ID")

# Log metadata for debugging or analytics
logging.info(f"Processing request {request_id} for user {user_id}") 
```

条件付きのエージェントの動作 ：

```
headers = kwargs.get("headers", {})
region = headers.get("X-Untrusted-Region")

# Adjust agent behavior based on request context
if region == "EU":
    agent = MyAgent(enable_gdpr_mode=True) 
```

### 重要な注意事項

- X-Untrusted-* プレフィックスを持つヘッダーのみが、エージェントコードに渡されます。
- ディクショナリからヘッダーにアクセスする場合、英大文字と英小文字は区別されます。
- 存在しない可能性のあるヘッダーにアクセスする場合、常にデフォルト値を指定するか、「なし」をチェックします。
- ヘッダーは、ストリーミングと非ストリーミングの両方のチャット回答で使用できます。

## デバッグのヒント

エージェントの問題のトラブルシューティングとデバッグに役立つテクニックとコマンド。

### 冗長ログを有効にする

```
agent = MyAgent(verbose=True) 
```

### 認証のテスト

```
from datarobot_genai.core.cli import AgentEnvironment

env = AgentEnvironment() 
```

### 環境変数のチェック

```
echo $DATAROBOT_API_TOKEN
echo $DATAROBOT_ENDPOINT 
```

### デバッグのためリクエストヘッダーのログを取る

```
import asyncio
import logging
from concurrent.futures import ThreadPoolExecutor
from typing import Any

def chat(completion_create_params, load_model_result: tuple[ThreadPoolExecutor, asyncio.AbstractEventLoop], **kwargs: Any):
    headers = kwargs.get("headers", {})

    # Log all headers to inspect what's available
    if headers:
        logging.warning(f"All headers: {dict(headers)}")

    # Continue with agent logic... 
```

## サポートについて

追加のサポートが必要な場合は：

- 選択したエージェントフレームワークのドキュメントを確認します。
- DataRobotに問い合わせ ます。
- GitHubリポジトリで案件を公開 します。
- フレームワークについてのドキュメント：