View a markdown version of this page

Personalize uma estratégia integrada ou crie sua própria estratégia - Amazon Bedrock AgentCore

Personalize uma estratégia integrada ou crie sua própria estratégia

Para casos de uso avançados ou específicos de domínio, você pode criar uma estratégia integrada com substituições para obter um controle refinado sobre o processo de memória de longo prazo. Built-in com substituições, as estratégias permitem que você substitua o comportamento padrão das estratégias integradas fornecendo suas próprias instruções e selecionando um modelo básico específico para as etapas de extração e consolidação.

Quando usar uma estratégia integrada com substituições

Escolha uma estratégia integrada com substituições quando precisar adaptar a lógica de memória aos seus requisitos específicos. Entre os casos de uso comuns estão:

  • Domain-specific extração: restringindo a estratégia para extrair somente certos tipos de informações. Por exemplo, capturar as preferências alimentares e dietéticas de um usuário enquanto ignora suas preferências por roupas.

  • Controle da granularidade: ajuste do nível de detalhes na memória extraída. Por exemplo, instruir a estratégia resumida a salvar apenas pontos-chave de alto nível, em vez de uma narrativa detalhada.

  • Seleção de modelo: usar um modelo básico específico que seja mais adequado para seu domínio ou tarefa específica, como um modelo ajustado para texto financeiro ou jurídico.

Como personalizar uma estratégia

Para substituir uma estratégia integrada por uma configuração personalizada, você especifica a configuração ao usar a CreateMemoryoperação ou a UpdateMemoryoperação. Você pode substituir o seguinte:

A tabela a seguir mostra as etapas que você pode substituir para cada estratégia de memória:

Estratégia Etapas que você pode substituir

Semântica

Consolidação de extração

Resumo

Consolidação

Preferência do usuário

Consolidação de extração

Episódico

Reflexão de consolidação de extração

nota

Você também pode substituir por uma estratégia autogerenciada. Para obter mais informações, consulte Self-managed estratégia.

Como personalizar uma estratégia

Por exemplo, você pode modificar a instrução de extração da estratégia de memória semântica para adicionar novas instruções ao personalizá-la.

Built-in instruções de estratégia de memória semântica

A seguir, são mostradas as instruções integradas para a estratégia de memória semântica:

You are a long-term memory extraction agent supporting a lifelong learning system. Your task is to identify and extract meaningful information about the users from a given list of messages. Analyze the conversation and extract structured information about the user according to the schema below. Only include details that are explicitly stated or can be logically inferred from the conversation. - Extract information ONLY from the user messages. You should use assistant messages only as supporting context. - If the conversation contains no relevant or noteworthy information, return an empty list. - Do NOT extract anything from prior conversation history, even if provided. Use it solely for context. - Do NOT incorporate external knowledge. - Avoid duplicate extractions. IMPORTANT: Maintain the original language of the user's conversation. If the user communicates in a specific language, extract and format the extracted information in that same language.

Você pode acrescentar uma nova regra a essas instruções, como:

- Focus exclusively on extracting facts related to travel and booking preferences.

ou edite uma regra existente, como:

IMPORTANT: Always extract memories in English irrespective of the original language of the user's conversation.

Práticas recomendadas para personalização

  • Baseie-se nas instruções existentes: é altamente recomendável que você use as instruções de estratégias integradas como ponto de partida. A estrutura básica e as instruções são essenciais para a funcionalidade da memória. Você deve adicionar a orientação específica da tarefa às instruções existentes, em vez de escrever outras totalmente novas do zero.

  • Forneça instruções claras: o conteúdo do appendToPrompt substitui as instruções padrão no prompt do sistema. Certifique-se de que suas instruções sejam lógicas e completas, pois instruções vazias ou mal formadas podem levar a resultados indesejáveis.

Considerações importantes

Para manter a confiabilidade do pipeline de memória, siga as seguintes diretrizes:

  • Não modifique esquemas em prompts: você só deve adicionar ou modificar instruções que orientem como as memórias são extraídas ou consolidadas. Não tente alterar a conversação ou as definições do esquema de memória no próprio prompt, pois isso pode causar falhas inesperadas.

  • Não renomeie as operações de consolidação: ao personalizar um prompt de consolidação, não altere os nomes das operações (por exemplo,,). AddMemory UpdateMemory A alteração desses nomes fará com que o pipeline de memória de longo prazo falhe.

  • O esquema de saída não é editável: estratégias integradas com substituições não permitem que você altere o esquema de saída final da memória extraída ou consolidada. O esquema de saída que será adicionado ao prompt do sistema para a estratégia integrada com substituições será o mesmo das estratégias integradas. Para obter informações sobre os esquemas de saída, consulte o seguinte:

Para controle total sobre o processo de memória de ponta a ponta, incluindo o esquema de saída, consulte estratégia. Self-managed

Perfil de execução

Ao usar estratégias integradas com substituições, você também precisa fornecer uma memoryExecutionRoleArn na CreateMemory API. Bedrock A Amazon Bedrock AgentCore assumirá essa função para chamar os modelos fundamentais em sua AWS conta para extração e consolidação.

nota

Ao usar estratégias integradas com substituições, o uso do LLM para extração e consolidação será cobrado separadamente em sua AWS conta, e cobranças adicionais podem ser aplicadas.