View a markdown version of this page

トラブルシューティング - Amazon Nova
認証とセットアップモデルのアクセス拒否リージョン別の可用性の問題タイムアウト設定API レスポンスの問題推論モードエラーツールの使用に関する問題

トラブルシューティング

このセクションでは、Amazon Nova モデルを使用する際の一般的な問題の解決策を示します。

認証とセットアップ

アクセス許可がない

症状: Nova モデルまたは機能にアクセスできない

解決策:

  • IAM ロールに AmazonBedrockFullAccess または適切なアクセス許可があることを確認します

  • Amazon Bedrock コンソールを使用して特定のモデルアクセスをリクエストします

  • モデルアクセスとツールの使用のアクセス許可を検証します

モデルのアクセス拒否

症状: モデルのアクセスリクエストが失敗する

解決策:

  • Amazon Bedrock コンソールを使用して特定のモデルアクセスをリクエストします

  • リクエストされたモデルへのアクセス権がアカウントに付与されていることを確認します

  • モデルのリージョン別の可用性を確認します

リージョン別の可用性の問題

症状: 機能が選択したリージョンでは使用できない

解決策:

  • ウェブグラウンディングは、US CRIS プロファイルを使用して米国リージョンでのみ使用できます

  • 選択したリージョンでモデルと機能が使用可能であることを確認します

  • 必要に応じて、サポートされているリージョンに切り替えます

タイムアウト設定

症状: 完了前にリクエストがタイムアウトする

原因: 複雑なオペレーションではデフォルトのタイムアウトが短すぎる

解決策: 延長タイムアウト設定を行います

from botocore.config import Config

bedrock = boto3.client(
    'bedrock-runtime',
    region_name='us-east-1',
    config=Config(
        read_timeout=3600      # 60 minutes
    )
)
注記

Amazon Nova 推論リクエストは、複雑なオペレーションに最大 60 分かかる場合があります。

API レスポンスの問題

停止理由について:

end_turn

通常の完了。アクションは不要です。

max_tokens

トークンの上限に達した。

解決策: inferenceConfig で maxTokens パラメータを増やします。

content_filtered

コンテンツが AWS 責任ある AI ポリシーに違反しました。

解決策: コンテンツポリシーに準拠するように入力を確認して変更します。

malformed_model_output

出力形式が無効です。

解決策: 出力スキーマと制約を確認し、JSON スキーマが適切にフォーマットされていることを確認します。

malformed_tool_use

ツール呼び出し形式が無効です。

解決策: ツール定義が予想されるスキーマと一致することを確認します。ツール入力パラメータが正しくフォーマットされていることを確認します。

service_unavailable

組み込みツールサービスが利用できません。

解決策: 少し遅れてリクエストを再試行します。AWS サービスのヘルスダッシュボードを確認します。

invalid_query

組み込みツールへのクエリが無効です。

解決策: クエリの形式とパラメータを確認し、クエリがツール要件を満たしていることを確認します。

max_tool_invocations

ツールの再試行回数を使い切りました。

解決策: タスクを簡素化するか、小さなステップに分割します。特定の問題についてツールのエラーメッセージを確認します。

推論モードエラー

推論の労力が高い切り捨てられたレスポンス

解決策: 推論の労力が大きい場合は、temperature、topP、maxToken のパラメータを設定解除します。これにより、モデルは複雑な推論タスクに最適な設定を使用できます。

推論用のトークンが不十分

エラー:「maxTokens is insufficient」

解決策: 上限を引き上げて自動的に再試行します

token_limits = {
    "low": 15000,
    "medium": 30000,
    "high": 50000
}

try:
    response = client.converse(
        modelId="us.amazon.nova-2-lite-v1:0",
        messages=messages,
        inferenceConfig={
            "maxTokens": token_limits[max_effort]
        },
        additionalModelRequestFields={
            "reasoningConfig": {
                "type": "enabled",
                "maxReasoningEffort": max_effort
            }
        }
    )
except Exception as e:
    if "maxTokens is insufficient" in str(e):
        higher_limit = int(token_limits[max_effort] * 1.5)
        # Retry with higher limit

ツールの使用に関する問題

スキーマ検証の失敗

ツールスキーマ検証エラー

解決策:

  • JSON スキーマを 2 つのネストレイヤーに制限して最高のパフォーマンスを実現します

  • すべての必須フィールドが正しく定義されていることを確認します

  • JSON スキーマ仕様に照らしてスキーマを検証します

モデルがツールを正しく使用していない

解決策:

  • ツール名がその目的を明確に説明していることを確認します

  • ツール機能の詳細な説明を提供します

  • 明確なパラメータの説明を使用して入力スキーマを明示的に定義します

  • 役に立つ場合は、説明に例を含めます

ツール呼び出し動作に一貫性がない

解決策: ツール呼び出しの温度を 0 に設定します。

inferenceConfig={
    "temperature": 0,
    "maxTokens": 10000
}

これにより、貪欲デコードが可能になり、より信頼性の高いツールの使用が可能になります。

ツール選択の競合

問題: ウェブ検索またはコードインタープリタでカスタムツールを使用する場合のエラー

解決策: 名前が nova_grounding のカスタム toolSpec を含めないでください – これはシステムツールと競合します。代わりにシステムツール設定を使用します。

# Correct - use system tool
tool_config = {
    "tools": [{
        "systemTool": {"name": "nova_grounding"}
    }]
}

# Incorrect - don't create custom tool with this name
# tool_config = {
#     "tools": [{
#         "toolSpec": {"name": "nova_grounding", ...}
#     }]
# }

ウェブグラウンディングの問題

アクセスコントロールの問題

問題: ウェブグラウンディングとコードインタープリタが機能しない

解決策: IAM ポリシーに以下が含まれていることを確認します。

{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["bedrock:InvokeTool"],
      "Resource": ["arn:aws:bedrock::{YOUR_ACCOUNT_ID}:system-tool/amazon.nova_grounding"]
    }
  ]
}
サービスコントロールポリシーの問題

問題: ウェブグラウンディングが SCP によってブロックされている

解決策: aws:requestedRegion 条件付きのサービスコントロールポリシーがある場合は、ウェブグラウンディング機能の「未指定」リージョンを許可するように更新します。

メディア処理の制限

画像/動画の多言語コンテンツに対する理解不足

制限: Nova モデルでは、ビジュアルメディアの多言語コンテンツに対する理解が限られています

回避方法:

  • 画像とともにテキスト翻訳を提供します

  • 可能であれば、多言語コンテンツにテキストベースの入力を使用します

人の識別

問題: モデルが画像内の人物の特定を拒否する

期待される動作: モデルは、プライバシーと安全上の理由から、画像、ドキュメント、または動画内の個人を特定または名指しすることを拒否します

回避策: 特定の個人の身元ではなく一般的な特性やコンテキストについて質問します

空間的推論の制限

問題: 不正確なローカリゼーションまたはレイアウト分析

制限: 正確な空間推論を行う際に能力が制限される

回避方法:

  • オブジェクトのローカリゼーションに境界ボックス検出を使用します

  • プロンプトに明確なリファレンスポイントを提供します

  • 複雑な空間クエリをよりシンプルなコンポーネントに分割します

画像/動画内の小さなテキスト

問題: メディアで小さなテキストを読み取れない

解決策:

  • 関連するテキストセクションに焦点を当てて画像をトリミングします

  • ソースメディアの解像度を上げます

  • 利用可能な場合は、テキストを個別に指定します

ドキュメントとファイルの処理

サポートされていないコンテンツ

問題: PDF の処理が失敗する

原因:

  • CMYK カラープロファイルを含む PDF

  • SVG 画像を含む PDF

解決策:

  • PDF を RGB カラープロファイルに変換します

  • PDF に含める前に SVG 画像をラスタライズします

トークンの推定

問題: PDF での予期しないトークンの使用

ガイドライン: 標準の 8.5×11" PDF ページあたり約 2,560 トークンを見積もります

解決策: ドキュメントの長さに基づいて適宜 maxTokens を調整します