View a markdown version of this page

Ingestões falhadas do Redrive - Base da Amazônia AgentCore

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Ingestões falhadas do Redrive

A extração da memória de curto prazo para a memória de longo prazo geralmente é automática. Se a extração da memória de curto prazo para a memória de longo prazo não for bem-sucedida por qualquer motivo, a AgentCore Memória tentará resolver o problema. Se os problemas persistirem, a intervenção do desenvolvedor poderá ser necessária e os trabalhos que falharam serão movidos para uma fila dedicada para seu recurso de memória. Um exemplo é se sua conta estiver ingerindo memória de longo prazo a uma taxa maior do que a permitida. Nesse caso, você deve esperar até que o tráfego diminua e redirecione manualmente os trabalhos afetados.

Para identificar e redirecionar trabalhos que falharam:

  1. Ligue ListMemoryExtractionJobs para listar trabalhos que falharam. Cada trabalho na resposta inclui a jobId e a failureReason que indicam por que a extração falhou.

  2. Aborde a causa raiz usando o código do motivo da falha na tabela a seguir.

  3. Ligue StartMemoryExtractionJob, passando o jobId da lista de tarefas que falharam para reinseri-lo na memória de longo prazo.

Recomendamos monitorar a métrica vendida FailedExtraction para ser notificado sobre quaisquer problemas. Essa métrica também tem dimensões em StrategyId, Resource (o ARN da memória) e. StrategyType AgentCore A memória emite uma contagem dessa métrica sempre que uma tarefa de extração falha e é gravada no armazenamento das tarefas de extração.

Para estratégias integradas, o único cenário de falha é atingir o limite de ingestão. No caso de integração com substituição, há cenários de falha adicionais, incluindo problemas com o modelo que você selecionou para usar em sua conta ou com as permissões que você concedeu à AgentCore Memory.

Código do motivo da falha Description Mitigação recomendada

LTM_RATE_EXCEEDED

Essa conta excedeu a cota de tokens por minuto alocada para processamento de memória de longo prazo

Por meio das cotas de serviço, solicite um limite maior para a cota da Bedrock Agentcore “Tokens por minuto para extração de memória de longo prazo”. Em seguida, invoque a StartMemoryExtractionJob API no jobID da extração que falhou.

CUSTOM_MODEL_BEDROCK_ACCESS_DENIED

A memória ExecutionRoleArn fornecida durante CreateMemory não tem permissões adequadas para invocar todos os IDs de modelo fornecidos nas estratégias personalizadas anexadas à memória.

Certifique-se de que a função tenha as permissões e a política de confiança definidas aqui e adicione as permissões ausentes. Ou ligue UpdateMemory para mudar para uma função diferente com as permissões adequadas. Em seguida, invoque a StartMemoryExtractionJob API no jobID da extração que falhou.

CUSTOM_MODEL_BEDROCK_INTERNAL_ERROR

O serviço recebeu um erro interno da Bedrock ao tentar invocar o modelo fornecido na estratégia personalizada.

Isso pode ser um erro de serviço temporário da Bedrock. Tente novamente mais tarde invocando a StartMemoryExtractionJob API no jobID da extração que falhou.

CUSTOM_MODEL_BEDROCK_THROTTLING

O serviço recebeu uma exceção de limitação da Bedrock ao tentar invocar o modelo fornecido na estratégia personalizada.

Certifique-se de que sua conta tenha solicitado a cota adequada de TPM e RPM para esse modelo da Bedrock. Invoque a StartMemoryExtractionJob API no JobID da extração com falha após o aumento da cota ou durante horas de baixo tráfego.

CUSTOM_MODEL_BEDROCK_MODEL_ERROR

O serviço recebeu uma exceção de erro de modelo da Bedrock ao tentar invocar o modelo fornecido na estratégia personalizada.

Isso geralmente é um erro de serviço temporário da Bedrock. Tente novamente mais tarde invocando a StartMemoryExtractionJob API no jobID da extração que falhou.

CUSTOM_MODEL_BEDROCK_MODEL_TIMEOUT

O serviço recebeu uma exceção de tempo limite de modelo da Bedrock ao tentar invocar o modelo fornecido na estratégia personalizada.

Isso ocorre quando o tempo de processamento do modelo excede seu tempo limite. Considere mudar para um modelo mais rápido antes de invocar a StartMemoryExtractionJob API no jobID da extração que falhou.

CUSTOM_MODEL_BEDROCK_RESOURCE_NOT_FOUND

O serviço recebeu um recurso não encontrado da Bedrock ao tentar invocar o modelo fornecido na estratégia personalizada.

Certifique-se de que o modelID fornecido em qualquer estratégia personalizada associada à memória esteja correto. Ligue UpdateMemory para atualizar esses valores, se necessário. Em seguida, invoque a StartMemoryExtractionJob API no jobID da extração que falhou.

CUSTOM_MODEL_BEDROCK_MODEL_NOT_READY

O serviço recebeu um Model Not Ready da Bedrock ao tentar invocar o modelo fornecido na estratégia personalizada.

Aguarde até que o modelo esteja pronto. Consulte a documentação do Bedrock para obter mais detalhes. Em seguida, invoque a StartMemoryExtractionJob API no jobID da extração que falhou.

CUSTOM_MODEL_BEDROCK_SERVICE_UNAVAILABLE

O serviço recebeu Service Unavailable da Bedrock ao tentar invocar o modelo fornecido na estratégia personalizada.

Isso geralmente é um erro de serviço temporário da Bedrock. Tente novamente mais tarde invocando a StartMemoryExtractionJob API no jobID da extração que falhou.

CUSTOM_MODEL_BEDROCK_VALIDATION_EXCEPTION

O serviço recebeu uma exceção de validação da Bedrock ao tentar invocar o modelo fornecido na estratégia personalizada.

Certifique-se de que o modelID fornecido em qualquer estratégia personalizada associada à memória esteja correto. Ligue UpdateMemory para atualizar esses valores, se necessário. Em seguida, invoque a StartMemoryExtractionJob API no jobID da extração que falhou.