Struct ConversationSummaryMemory 

pub struct ConversationSummaryMemory<M: BaseChatModel> { /* private fields */ }

Conversation Summary Memory

Uses LLM to automatically summarize conversation history, avoiding overly long context.

Example

use lc_memory::ConversationSummaryMemory;
use lc_providers::OpenAIChat;

let llm = OpenAIChat::new(config);
let memory = ConversationSummaryMemory::new(llm);

// Automatically generates summary after each conversation round
memory.save_context(&inputs, &outputs).await?;

// Returns summary instead of full history when loading
let vars = memory.load_memory_variables(&HashMap::new()).await?;

Implementations

impl<M: BaseChatModel> ConversationSummaryMemory<M>

pub fn new(llm: M) -> Self

Create a new summary memory

pub fn from_messages(llm: M, messages: Vec<Message>) -> Self

Create from existing messages

pub fn with_input_key(self, key: impl Into<String>) -> Self

Set input key name

pub fn with_output_key(self, key: impl Into<String>) -> Self

Set output key name

pub fn with_memory_key(self, key: impl Into<String>) -> Self

Set memory variable name

pub fn with_summary_prompt(self, prompt: impl Into<String>) -> Self

Set summary prompt

pub fn with_return_messages(self, return_messages: bool) -> Self

Set whether to return message objects

pub fn with_max_recent_turns(self, max: usize) -> Self

H29: Set maximum recent turns to keep in chat_memory after summarization

pub fn chat_memory(&self) -> &ChatMessageHistory

Get chat history

pub async fn buffer(&self) -> String

Get current summary

pub fn last_summary_error(&self) -> Option<&str>

P2-4: 最近一次摘要失败的原因(无失败则 None)。

pub fn pending_lines(&self) -> &str

P2-4: 摘要失败后累计的待总结增量行。

Trait Implementations

impl<M: BaseChatModel + Send + Sync + 'static> BaseChatMemory for ConversationSummaryMemory<M>

where <M as Runnable<Vec<Message>, LLMResult>>::Error: Display,

P0-1: ConversationSummaryMemory 实现 BaseChatMemory。

fn messages(&self) -> &[Message]

Get chat message list

fn add_message(&mut self, message: Message)

Add message

fn add_user_message(&mut self, content: &str)

Add user message

fn add_ai_message(&mut self, content: &str)

Add AI message

impl<M: BaseChatModel + Send + Sync + 'static> BaseMemory for ConversationSummaryMemory<M>

where <M as Runnable<Vec<Message>, LLMResult>>::Error: Display,

fn memory_variables(&self) -> Vec<&str>

Get memory variable names

fn load_memory_variables<'life0, 'life1, 'async_trait>( &'life0 self, _inputs: &'life1 HashMap<String, String>, ) -> Pin<Box<dyn Future<Output = Result<HashMap<String, Value>, MemoryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Load memory variables

fn save_context<'life0, 'life1, 'life2, 'async_trait>( &'life0 mut self, inputs: &'life1 HashMap<String, String>, outputs: &'life2 HashMap<String, String>, ) -> Pin<Box<dyn Future<Output = Result<(), MemoryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Save context

fn clear<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<(), MemoryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Clear memory