Resolver problemas da Gemini Enterprise Agent Platform

Esta página é o ponto de partida para solucionar problemas da Gemini Enterprise Agent Platform. Use-o para diagnosticar um erro, procurar um erro específico, encontrar o guia para 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 registro pré-filtrada, se 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 (o número do projeto) e o valor de ID do mecanismo de raciocínio.

Verificar cotas e Service Health

Os 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:

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 de status ou mensagem 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 limite de taxa
429, RESOURCE_EXHAUSTED, at capacity Região temporariamente sem capacidade
429, RESOURCE_EXHAUSTED, max_instances O máximo de instâncias excede o limite regional
Erro interno do servidor 500 de um modelo predefinido Erros no modelo predefinido
Conflitos de versão cloudpickle ou pydantic ao serializar o 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 de conta de serviço personalizada
400, INVALID_ARGUMENT, REASONING_ENGINE_SECRET_ACCESS_DENIED, referenced by spec.deployment_spec.secret_env Erros de acesso do Secret Manager
504, DEADLINE_EXCEEDED, REASONING_ENGINE_BUILD_TIMEOUT O tempo limite da criação da imagem do contêiner foi atingido
504, DEADLINE_EXCEEDED, REASONING_ENGINE_CONTAINER_START_TIMEOUT O contêiner não foi iniciado a tempo
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 certificados que chegam a um destino de CA particular ou autoassinado Os destinos de CA autoassinados ou particulares não conseguem se conectar
Falhas de handshake de TLS de um agente de contêiner personalizado (BYOC) O agente implantado com o contêiner personalizado (BYOC) não consegue se conectar
Falhas na criação de sandbox Problemas na criação de sandbox
A execução de código expira, falhas de E/S de arquivo em um sandbox Problemas de execução de código
RuntimeError: Failed to generate memory ou nenhuma memória 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
Instalar o SDK da Agent Platform e configurar o ambiente Configuração do ambiente do Agent Runtime
Como criar um agente Criar um agente
Implantar um agente no Agent Runtime Implantação de agentes
Como chamar um serviço externo de um agente Conectividade do Gateway de Agente
Como listar, atualizar ou excluir um agente implantado Gerenciar agentes implantados
Como executar código em um sandbox Execução de código
Gerar ou recuperar memórias Memory Bank da Agent Platform
Disponibilizar um modelo ou atingir uma cota de modelo Solução de problemas de serviços de machine learning

Receber suporte

Se os guias desta página não resolverem o problema, consulte Como 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ê registrar um bug, forneça as seguintes informações:

  • Código de status
  • Mensagem de erro
  • (Opcional) Feedback se a mensagem de erro estiver errada, for enganosa ou não for útil.