Esta página é o ponto de partida para resolver problemas da Gemini Enterprise Agent Platform. Use-o para diagnosticar um erro, pesquisar um erro específico, encontrar o guia da sua tarefa ou receber suporte.
Diagnosticar um erro
Antes de procurar uma correção específica, colete as seguintes informações:
Leia o erro
Anote o código de status, como 400 ou 429, e o texto exato da mensagem. Você pode pesquisar os dois no catálogo de erros.
Também é possível identificar a falha específica em um motivo legível por máquina, um link de documentação ou uma visualização de registros pré-filtrada, se eles estiverem presentes na mensagem de erro.
Encontrar os registros
Para pesquisar e filtrar registros de erros do agente, use a Análise de registros, defina Tipo de recurso como Mecanismo de raciocínio da Vertex AI e selecione o valor correspondente de Contêiner de recursos (número do projeto) e ID do mecanismo de raciocínio.
Verificar cotas e integridade do serviço
Erros que aparecem de forma intermitente ou que começaram sem uma mudança da sua parte geralmente são causados por cota ou por um incidente em andamento:
- Compare seu uso com as cotas e limites do sistema.
- Verifique o Google Cloud Service Health para saber se há um incidente em andamento na sua região.
Catálogo de erros
Encontre o erro que você recebeu na tabela a seguir. Se o erro não estiver listado, use os guias de solução de problemas para a tarefa que você estava tentando concluir.
| Código ou mensagem de status | Resolução |
|---|---|
ImportError: cannot import name 'reasoning_engines',
ImportError: cannot import name 'agent_engines' |
Versão desatualizada do SDK da Agent Platform para Python |
401 Context-Aware Access requirements are not met,
401 Request had invalid authentication credentials |
Erros de autorização 401 |
ValueError: Cannot get the Candidate text
|
Erros de geração de conteúdo |
failed to start and cannot serve traffic, na sua
primeira implantação de contêiner personalizado (BYOC) em uma região |
Erro na primeira criação de BYOC |
failed to start and cannot serve traffic ou
Request is prohibited by organization's policy,
dentro de um perímetro do VPC Service Controls |
Erros de violação do VPC-SC |
429, RESOURCE_EXHAUSTED
|
Erros de recurso esgotado ou de limitação de taxa |
429, RESOURCE_EXHAUSTED, at capacity
|
Região temporariamente na capacidade máxima |
429, RESOURCE_EXHAUSTED, max_instances
|
O número máximo de instâncias excede o limite regional |
500 erro interno do servidor de um modelo predefinido |
Erros no modelo predefinido |
Conflitos de versão cloudpickle ou pydantic ao
serializar seu agente |
Erros de serialização |
NotFound: 404 Can not copy from "gs://..."
|
O subdiretório do bucket do Cloud Storage não foi criado |
iam.serviceAccounts.actAs negado, servidor de metadados
indisponível |
Erros personalizados da conta de serviço |
400, INVALID_ARGUMENT,
REASONING_ENGINE_SECRET_ACCESS_DENIED,
referenced by spec.deployment_spec.secret_env |
Erros de acesso do Secret Manager |
InvalidArgument: 400 Provided filter is not valid
|
Erro ao filtrar a lista de agentes |
google.api_core.exceptions.Unknown: None,
Failed to convert project number to project ID,
durante a inicialização |
Erros durante a inicialização do Agent Runtime |
403 Forbidden em uma solicitação de saída |
Erros 403 Forbidden |
| Falhas na verificação de certificado que atingem um destino de CA particular ou autoassinada | Não é possível se conectar a destinos autoassinados ou de CA particular |
| Falhas de handshake de TLS de um agente de contêiner personalizado (BYOC) | O agente implantado com um contêiner personalizado (BYOC) não consegue se conectar |
| Falhas na criação do sandbox | Problemas na criação de sandbox |
| O tempo de execução de código expira, falhas de E/S de arquivo em uma sandbox | Problemas de execução de código |
RuntimeError: Failed to generate memory ou nenhuma
recordação retornada após uma sessão |
Nenhuma recordação foi gerada |
Guias de solução de problemas
Se você não tiver uma mensagem de erro específica ou se o erro não estiver no catálogo de erros, consulte a tabela a seguir para ver o guia correspondente à sua tarefa:
| Tarefa | Guia |
|---|---|
| Como instalar o SDK da Agent Platform e configurar o ambiente | Configuração do ambiente do Agent Runtime |
| Como criar um agente | Criar um agente |
| Implantação de um agente no Agent Runtime | Implantação do agente |
| Como chamar um serviço externo de um agente | Conectividade do Gateway de Agente |
| Listar, atualizar ou excluir um agente implantado | Gerenciar agentes implantados |
| Executar código em um sandbox | Execução de código |
| Gerar ou recuperar recordações | Memory Bank da Agent Platform |
| Veicular um modelo ou atingir uma cota de modelo | Solução de problemas dos serviços de machine learning |
Receber suporte
Se os guias nesta página não resolverem seu problema, consulte Receber ajuda para agentes para pacotes de suporte, fóruns da comunidade e relatórios de bugs. Para dúvidas sobre faturamento, consulte Perguntas sobre faturamento.
Se você enviar um bug, informe o seguinte:
- Código de status
- Mensagem de erro
- (Opcional) Feedback se a mensagem de erro estiver errada, enganosa ou não for útil.