Agentes
Memória e histórico de chat
Como controlar o que um agente de IA lembra: o histórico de chat dentro de uma conversa e a memória entre conversas.
Um agente pode lembrar de duas maneiras diferentes. O Histórico de chat é o que ele vê da conversa atual. A Memória é um armazenamento de notas no qual ele pode escrever e do qual pode ler entre conversas. São configurações separadas, e você pode usar uma, ambas ou nenhuma.
Histórico de chat#
O histórico de chat decide quantas das mensagens anteriores de uma conversa o agente recebe junto com cada nova pergunta. Sem ele, o agente responderia a cada mensagem como se fosse a primeira.
Você o encontra na aba Avançado, na seção Histórico de chat. O interruptor no cabeçalho da seção o ativa ou desativa. Ele vem ativado para um novo agente. O cabeçalho da seção resume a configuração, por exemplo “Últimas 10 mensagens · 8000 tokens”.
Com o interruptor ativado, você pode definir:
- Contagem de mensagens do histórico. Quantas mensagens recentes incluir. O padrão é 10, e você pode escolher de 1 a 50.
- Máximo de tokens do histórico. A maior quantidade de texto do histórico a enviar. O padrão é 8000, e você pode escolher de 100 a 8000 em passos de 100.
- Tipos de mensagem. Quais tipos de mensagem contam: Mensagens do usuário, Mensagens da IA e Chamadas de ferramentas. Por padrão, o agente vê as mensagens do usuário e da IA.
Um histórico mais longo dá ao agente mais contexto, e também significa que mais texto vai para o modelo a cada mensagem.
Memória#
A memória permite que o agente guarde informações além de uma única conversa, como as preferências de um cliente ou fatos que ele aprendeu. Ela vem desativada para um novo agente.
Você a encontra na seção Memória da aba Preferências. Ative o interruptor no cabeçalho da seção e depois defina:
- Categoria de memória. O grupo de entradas de memória do qual o agente lê e no qual escreve. Você precisa escolher uma. Enquanto a memória estiver ativada e nenhuma categoria estiver escolhida, o construtor avisa “Escolha uma categoria ou desative a Memória. O agente se recusa a executar enquanto a Memória estiver ativada sem nenhuma categoria escolhida.” Você cria e gerencia categorias em memória.
- Modo de acesso. Somente leitura permite que o agente pesquise na memória. Leitura/Escrita também permite que ele adicione e atualize entradas.
- Prompt de leitura de memória. Instruções que dizem ao agente como e quando usar as ferramentas de leitura.
- Prompt de escrita de memória. Instruções sobre como e quando usar as ferramentas de escrita. Ele importa no modo Leitura/Escrita.
- Descarregar entrada do fluxo. Quando ativado, a entrada da execução é armazenada e o agente pode buscá-la depois com uma ferramenta chamada
get_offloaded_memory. Ele vem desativado por padrão.
Os dois prompts começam com padrões que funcionam para a maioria dos agentes. Edite-os quando o agente escrever demais, de menos ou as coisas erradas.
A memória pertence a uma categoria
O agente armazena e recupera entradas por meio da categoria que você escolher. Agentes que usam a mesma categoria trabalham sobre a mesma memória, então use uma categoria separada quando dois agentes não devem compartilhar notas.
Qual usar#
| Você quer | Use |
|---|---|
| Que o agente acompanhe uma conversa de idas e vindas | Histórico de chat |
| Que o agente saiba algo da conversa de ontem | Memória |
| Respostas baseadas nos seus documentos | Uma ferramenta de recuperação, veja ferramentas do agente |
Se algo der errado#
- Se o agente parar de responder depois que você ativar a memória, verifique se uma categoria está escolhida.
- Se ele esquecer o que você disse duas mensagens atrás, verifique se o interruptor Histórico de chat está ativado e se Mensagens do usuário está selecionado.
- Se ele não escrever nada na memória, verifique se o Modo de acesso é Leitura/Escrita.