Mensagens de erro

Aprenda a resolver alguns erros relacionados à Agent Platform Vision. Neste tópico, falamos sobre erros com resoluções que exigem etapas além do que pode ser facilmente descrito em uma mensagem de erro.

Consulte a documentação da API Cloud para conferir as práticas recomendadas de tratamento de erros.

Permissões

O Application Default Credentials não está disponível

Se você recebeu esta mensagem:

The Application Default Credentials are not available. They are
available if running in Google Compute Engine. Otherwise, the
environment variable GOOGLE_APPLICATION_CREDENTIALS must be defined
pointing to a file defining the credentials.
See https://developers.google.com/accounts/docs/application-default-credentials
for more information.

Permissão negada

Se você recebeu esta mensagem:

ERROR: (gcloud.auth.application-default.print-access-token) File /path/to/key.json
(pointed by GOOGLE_APPLICATION_CREDENTIALS environment variable) does not exist!
{
  "error": {
    "code": 403,
    "message": "The request is missing a valid API key.",
    "status": "PERMISSION_DENIED"
  }
}

Verifique se você tem um arquivo JSON de chave de conta de serviço válido no local armazenado na variável de ambiente GOOGLE_APPLICATION_CREDENTIALS e se a variável aponta para o local correto.

Para diagnosticar esse erro, tente abrir o arquivo de chave da conta de serviço na pasta que você quer chamar a API Gemini Enterprise Agent Platform Vision.

cat $GOOGLE_APPLICATION_CREDENTIALS

Proibido: a API 403 POST não foi usada ou está desativada

Se você receber a mensagem:

Forbidden: 403 POST Gemini Enterprise Agent Platform Vision API has not been used in
project # before or it is disabled.
Enable it by visitng [url] then retry.
If you enabled this API recently, wait a few minutes for the action to
propagate and retry.

1. Acesse o link especificado na mensagem de erro e ative a API Agent Platform Vision. Aguarde alguns minutos e tente novamente.
2. Verifique se você tem um arquivo JSON de chave de conta de serviço válido armazenado na variável de ambiente GOOGLE_APPLICATION_CREDENTIALS. Para diagnosticar esse erro, tente abrir o arquivo de chave da conta de serviço na pasta que você quer chamar a API Gemini Enterprise Agent Platform Vision.

   cat $GOOGLE_APPLICATION_CREDENTIALS
   

Argumentos inválidos

Versão da API não aceita

Exemplo: quando uma solicitação é feita para uma versão da API que não oferece suporte à operação.

message: "The requested operation is unsupported for the API version."

Bad Request (Solicitação inválida)

Quando uma solicitação de API é feita, mas os campos dela têm uma ou mais violações. Cada violação é capturada como um field_violations nos detalhes de google.rpc.BadRequest.

message: "Request contains an invalid argument."
details {
  [type.googleapis.com/google.rpc.BadRequest] {
    field_violations { field: "foo" description: "bar" }
  }
}

Número de projeto inválido

Quando um número de projeto inválido é fornecido. Exemplo de número de projeto: 848757893952147483648.

message: "Invalid project number used: 848757893952147483648."
details {
    [type.googleapis.com/google.rpc.ErrorInfo] {
      reason: "INVALID_PROJECT_NUMBER"
      domain: "visionai.googleapis.com"
    }
}

Formato de recurso inválido

Quando um formato de recurso é inválido. Exemplo de número de projeto: 1234 e exemplo de ID do local: us-central1.

message: "Invalid Resource Used: project/1234/location/us-central1. Valid format should be "
"projects/{project_number}/locations/{location_id}."
details {
    [type.googleapis.com/google.rpc.ErrorInfo] {
      reason: "INVALID_RESOURCE_FORMAT"
      domain: "visionai.googleapis.com"
    }
}

Falha na condição prévia

Dados de vídeo ausentes

Algumas APIs (como CreateAnnotation para uma anotação de nível de partição) exigem que o recurso já tenha dados de vídeo transmitidos para inferir o horário de início do recurso. Caso contrário, o erro a seguir será acionado.

message: "Asset doesn't have start time inferred yet. Should ingest asset and retry."
details {
    [type.googleapis.com/google.rpc.ErrorInfo] {
      reason: "FAILED_PRECONDITION"
      domain: "visionai.googleapis.com"
    }
}

Cotas e limites

Cota excedida

Se você recebeu esta mensagem:

RESOURCE_EXHAUSTED: Quota exceeded.

Você atingiu o limite de sua cota diária ou por minuto. Leia as cotas e limites para usar a Agent Platform Vision.

Solicite um aumento das suas cotas pelo Google Cloud console.