トラブルシューティング

このページでは、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 と SanitizeModelResponse API リクエスト。

これらのオペレーションの 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>'

このエラーは、機能制限のあるリージョンでテンプレートを作成または更新しようとしたときに、そのリージョンでサポートされていない機能をリクエストで有効にした場合に発生します。

この問題を解決するには:

  1. エラー メッセージに表示されている、サポートされていない機能を特定します。
  2. リージョン別の機能の可用性を確認して、ターゲット リージョンで利用できない機能を確認します。
  3. 作成または更新するテンプレートから、サポートされていない機能を削除します。

または、データ所在地の要件で許可されている場合は、これらの機能をサポートする別の 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 に設定するか、[データ所在地を適用する] オプションを選択して、テンプレートでデータ所在地のコンプライアンスを有効にします。
  • テンプレートでデータ所在地のコンプライアンスを無効にする必要がある場合は、データ所在地の組織のポリシーの制約を無効にするの手順に沿って、組織のポリシー管理者に制約を無効にしてもらいます。