このページでは、Model Armor に関する問題を解決する方法について説明します。
このセクションでは、Model Armor の使用中に問題が発生した場合に役立つトラブルシューティングの手順について説明します。
Model Armor に対するすべての API 呼び出しが「404 見つかりません」エラーを返す
Model Armor API と Private Service Connect を確立します。このエラーは通常、プライベート Google アクセスを使用している場合、または Private Service Connect を使用せずに Model Armor リージョン エンドポイント(REP)にアクセスしている場合に発生します。詳細については、Private Service Connect エンドポイントを介したリージョン エンドポイントへのアクセスについてをご覧ください。
Sensitive Data Protection フィルタでエラーが発生するか、スキップされる
以下を確認してください。
- Sensitive Data Protection テンプレートが、呼び出される Model Armor エンドポイントと同じリージョンにある。
- Sensitive Data Protection テンプレートを含むプロジェクトで、Model Armor リクエストを行うサービス エージェントに
dlp.Userロールとdlp.Readerロールが付与されている。
このエラーは、SanitizeUserPrompt リクエストまたは SanitizeModelResponse リクエストのクライアント エラー、または Sensitive Data Protection テンプレートの問題が原因で発生します。
Model Armor グローバル エンドポイント エラー
API リクエストがグローバル エンドポイントではなく、適切なリージョン エンドポイントに送信されていることを確認します。
Model Armor は、リージョン エンドポイントでのみ次のオペレーションをサポートしています。
- テンプレートに対する作成、読み取り、更新、削除、一覧取得のオペレーション。
SanitizeUserPromptとSanitizeModelResponseAPI リクエスト。
これらのオペレーションの API リクエストをグローバル エンドポイントに送信すると、次のエラーが発生します。
{
"error": {
"code": 403,
"message": "Write access to project '<PROJECT_ID>' was denied",
"status": "PERMISSION_DENIED"
}
}
Model Armor リージョン エンドポイントにアクセスする際の証明書エラー
このエラーは通常、プライベート Google アクセスまたは VPC Service Controls を使用して VPC ネットワーク内から Model Armor リージョン エンドポイントにアクセスし、証明書の検証に失敗した場合に発生します。
たとえば、次のようなエラー メッセージが表示されることがあります。
curl: (60) SSL: no alternative certificate subject name matches target host name 'modelarmor.europe-west4.rep.googleapis.com'
この問題を解決するには、Model Armor API への Private Service Connect エンドポイントを作成します。詳細については、Private Service Connect エンドポイントを介したリージョン エンドポイントへのアクセスについてをご覧ください。
リージョンがリクエストされた機能をサポートしていない
次のようなエラー メッセージが表示されることがあります。
Region '<var>REGION</var>' does not support the requested capabilities: '<var>CAPABILITIES</var>'
このエラーは、機能制限のあるリージョンでテンプレートを作成または更新しようとしたときに、そのリージョンでサポートされていない機能がリクエストで有効になっている場合に発生します。
テンプレート構成には、悪意のある URL や児童性的虐待のコンテンツ(CSAM)などの検出機能が含まれています。これらの検出機能は、サポートされていない機能がある一部のリージョンでは使用できません。
この問題を解決するには:
- エラー メッセージに表示されている、サポートされていない機能を特定します。
- リージョン別の機能の可用性を確認して、ターゲット リージョンで利用できない機能を確認します。
- 作成または更新するテンプレートから、サポートされていない機能を削除するか、その適用を
DISABLEDに明示的に設定します(例:"csamFilterSettings": { "filterEnforcement": "DISABLED" })。
または、データ所在地の要件で許可されている場合は、この機能をサポートする別の Model Armor リージョンを使用します。
テンプレートのデータ所在地に関するコンプライアンスは必須です
次のような 400(FAILED_PRECONDITION)エラー メッセージが表示されることがあります。
Template data residency compliance is required. The 'Enforce data residency' field must not be set to false.
このエラーは、Model Armor テンプレートのデータ所在地のコンプライアンスを必須にする(constraints/modelarmor.managed.requireTemplateDataResidencyCompliance)マネージド組織ポリシー サービスの制約が適用され、データ所在地のコンプライアンスが無効になっている Model Armor テンプレートを作成または更新した場合に発生します。data_residency_compliant を false に設定するか、[データ所在地を適用する] オプションをオフにすると、データ所在地のコンプライアンスが無効になります。この制約はデフォルトで適用されるため、data_residency_compliant が false に設定されている既存のテンプレートでフィルタなどの設定を編集すると、このエラーが発生します。テンプレートを更新しない限り、既存のテンプレートとプロンプトとレスポンスをサニタイズするリクエストは影響を受けません。
この問題を解決するには、以下のいずれかを行います。
data_residency_compliantをtrueに設定するか、[データ所在地を適用する] オプションを選択して、テンプレートでデータ所在地のコンプライアンスを有効にします。- テンプレートでデータ所在地のコンプライアンスを無効にする必要がある場合は、データ所在地の組織ポリシーの制約を無効にするの手順に沿って、組織ポリシー管理者に制約を無効にしてもらいます。
大規模なプロンプトまたはペイロードに対してポリシー制御またはフィルタがスキップされる
検索拡張生成(RAG)ペイロードやマルチステップ エージェントの会話履歴など、大規模なプロンプトやレスポンスをスクリーニングする場合、個々のフィルタが実行されないことがあります。また、サニタイズ結果が EXECUTION_SKIPPED を返し、messageItems フィールドに次のいずれかの警告メッセージが表示されることがあります。
Detection skipped as token limit exceeded.
Input size exceeded the limit of 4194304 bytes.
この問題は、単項サニタイズ リクエストまたはバッファリングされたストリーミング リクエストが、フィルタのトークン システムの上限または 4 MB の入力サイズの上限を超えた場合に発生します。プロンプト インジェクションとジェイルブレイクの検出、責任ある AI、CSAM フィルタの場合、上限は単項リクエストで 65,536 トークン、バッファリングされたストリーミング リクエストで 10,000 トークンです。Sensitive Data Protection の場合、上限は 130,000 トークンです。入力がフィルタのトークン上限を超え、一致が検出されない場合、フィルタは EXECUTION_SKIPPED と NO_MATCH_FOUND を返します。これにより、インライン統合でリクエストを続行できます。
トークンまたは入力サイズの制限によりフィルタがスキップされたかどうかを確認するには、Cloud Logging で SanitizeOperation ログをクエリします。
jsonPayload.@type="type.googleapis.com/google.cloud.modelarmor.logging.v1.SanitizeOperationLogEntry"
"EXECUTION_SKIPPED"
この問題を解決するには:
- ストリーミング ワークロードや長時間実行されるエージェントのやり取りには、リアルタイム ストリーミング サニタイズ(
StreamSanitizeUserPromptとStreamSanitizeModelResponse)を使用します。Agent Gateway を使用する Agent Development Kit エージェントにはstreamQueryを使用します。Agent Gateway は入力をチャンクで処理し、無制限のトークンをサポートします。 - 単項リクエストの場合は、大きな RAG ペイロードをチャンクするか、マルチステップ エージェントの会話履歴をトリミングしてから Model Armor に送信します。これにより、各リクエストがトークン システムの上限と 4 MB の入力サイズの上限内に収まるようにします。