Resolver problemas

Nesta página, mostramos como resolver problemas com o Model Armor.

Nesta seção, descrevemos as etapas de solução de problemas que podem ser úteis se você tiver problemas ao usar o Model Armor.

Todas as chamadas de API para o Model Armor retornam um erro 404 Não encontrado

Estabeleça um Private Service Connect com as APIs do Model Armor. Esse erro geralmente ocorre quando os endpoints regionais (REPs) do Model Armor são acessados usando o Acesso privado do Google ou sem um Private Service Connect. Para mais informações, consulte Sobre o acesso de endpoints regionais por meio de endpoints do Private Service Connect.

O filtro da Proteção de Dados Sensíveis apresenta um erro ou é ignorado

Confirme o seguinte:

  • O modelo da Proteção de Dados Sensíveis está na mesma região que o endpoint do Model Armor que está sendo chamado.
  • O agente de serviço que faz a solicitação do Model Armor tem os papéis dlp.User e dlp.Reader no projeto que contém o modelo da Proteção de Dados Sensíveis.

Esse erro ocorre devido a erros do cliente nas solicitações SanitizeUserPrompt ou SanitizeModelResponse ou problemas com o modelo de Proteção de Dados Sensíveis.

Erros de endpoint global do Model Armor

Verifique se você está fazendo as solicitações de API para o endpoint regional apropriado, em vez do endpoint global.

O Model Armor só aceita as seguintes operações nos endpoints regionais:

  • Operações de criação, leitura, atualização, exclusão e listagem em modelos.
  • Solicitações de API SanitizeUserPrompt e SanitizeModelResponse.

Se você fizer as solicitações de API para essas operações no endpoint global, o seguinte erro será exibido:

{
  "error": {
    "code": 403,
    "message": "Write access to project '<PROJECT_ID>' was denied",
    "status": "PERMISSION_DENIED"
  }
}

Erros de certificado ao acessar endpoints regionais do Model Armor

Esse erro geralmente ocorre quando os endpoints regionais do Model Armor são acessados de uma rede VPC usando o Acesso Privado do Google ou o VPC Service Controls, e a verificação do certificado falha.

Por exemplo, você pode ver uma mensagem de erro semelhante a esta:

curl: (60) SSL: no alternative certificate subject name matches target host name 'modelarmor.europe-west4.rep.googleapis.com'

Para resolver esse problema, crie um endpoint do Private Service Connect para as APIs do Model Armor. Para mais informações, consulte Sobre o acesso de endpoints regionais por meio de endpoints do Private Service Connect.

A região não é compatível com os recursos solicitados

Talvez você veja uma mensagem de erro semelhante a esta:

Region '<var>REGION</var>' does not support the requested capabilities: '<var>CAPABILITIES</var>'

Esse erro ocorre quando você tenta criar ou atualizar um modelo em uma região com restrições de recursos, e a solicitação ativa recursos que não são compatíveis com essa região.

Para resolver o problema:

  1. Identifique os recursos não compatíveis listados na mensagem de erro.
  2. Confira a disponibilidade de recursos por região para confirmar quais recursos não estão disponíveis na sua região de destino.
  3. Remova os recursos incompatíveis do modelo que você está criando ou atualizando.

Como alternativa, use uma região diferente do Model Armor que ofereça suporte aos recursos, se os requisitos de residência de dados permitirem.

A conformidade com a residência de dados do modelo é obrigatória

Talvez você veja uma mensagem de erro 400 (FAILED_PRECONDITION) semelhante a esta:

Template data residency compliance is required. The 'Enforce data residency' field must not be set to false.

Esse erro ocorre quando a restrição de serviço gerenciado do Serviço de Política da Organização Exigir conformidade com a residência de dados do modelo do Model Armor (constraints/modelarmor.managed.requireTemplateDataResidencyCompliance) é aplicada e você cria ou atualiza um modelo do Model Armor com a conformidade com a residência de dados desativada. A conformidade com a residência de dados é desativada quando você define data_residency_compliant como false ou desmarca a opção Aplicar residência de dados. Como essa restrição é aplicada por padrão, a edição de qualquer configuração, como um filtro, em um modelo que já tenha data_residency_compliant definido como false também aciona esse erro. Os modelos e as solicitações atuais para limpar comandos e respostas não são afetados, a menos que você atualize o modelo.

Para resolver o problema, siga um destes procedimentos:

  • Ative a conformidade com a residência de dados no modelo definindo data_residency_compliant como true ou selecionando a opção Aplicar residência de dados.
  • Se você precisar manter a conformidade com a residência de dados desativada para o modelo, siga as etapas em Desativar a restrição da política da organização para residência de dados para que o administrador da política da organização desative a restrição.