Resolver problemas da Gemini Enterprise Agent Platform

Esta página é o ponto de partida para a solução de problemas da Gemini Enterprise Agent Platform. Use-a 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:

Ler 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 eles estiverem presentes na mensagem de erro.

Encontrar os registros

Para pesquisar e filtrar registros de erros de agentes, use o Logs Explorer, defina o Tipo de recurso como Vertex AI Reasoning Engine e selecione o valor correspondente do Contêiner de recursos (seu número do projeto) e o valor do 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 no seu lado geralmente são causados por cota ou por um incidente em andamento:

Catálogo de erros

Encontre o erro recebido na tabela a seguir. Se o erro não estiver listado, use os guias de solução de problemas da 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 primeira implantação de contêiner personalizado (BYOC) em uma região Erro de criação de BYOC pela primeira vez
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 de VPC-SC
429, RESOURCE_EXHAUSTED Recurso esgotado ou erros de limite de taxa
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
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 atingem um destino de AC autoassinado ou particular Os destinos de AC 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 contêiner personalizado (BYOC) não consegue se conectar
Falhas na criação de sandbox Problemas de criação de sandbox
O tempo limite da 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 memoryou 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 conferir o guia correspondente à sua tarefa:

Tarefa Guia
Instalar o SDK da Agent Platform e configurar o ambiente Configuração do ambiente do Agent Runtime
Criar um agente Criar um agente
Implantar um agente no Agent Runtime Implantação do agente
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 de serviços de machine learning

Receber suporte

Se os guias nesta página não resolverem o problema, consulte Receber ajuda para agentes para conferir pacotes de suporte, fóruns da comunidade e relatórios de bugs. Para perguntas 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, enganosa ou não for acionável.