strands.agent.conversation_manager.summarizing_conversation_manager

Summarizing conversation history management with configurable options.

SummarizingConversationManager

class SummarizingConversationManager(ConversationManager)

Defined in: src/strands/agent/conversation_manager/summarizing_conversation_manager.py:54

Implements a summarizing window manager.

This manager provides a configurable option to summarize older context instead of simply trimming it, helping preserve important information while staying within context limits.

__init__

def __init__(summary_ratio: float = 0.3,
             preserve_recent_messages: int = 10,
             summarization_agent: Optional["Agent"] = None,
             summarization_system_prompt: str | None = None,
             *,
             proactive_compression: bool | ProactiveCompressionConfig
             | None = None)

Defined in: src/strands/agent/conversation_manager/summarizing_conversation_manager.py:62

Initialize the summarizing conversation manager.

Arguments:

• summary_ratio - Ratio of messages to summarize vs keep when context overflow occurs. Value between 0.1 and 0.8. Defaults to 0.3 (summarize 30% of oldest messages).
• preserve_recent_messages - Minimum number of recent messages to always keep. Defaults to 10 messages.
• summarization_agent - Optional agent to use for summarization instead of the parent agent. If provided, this agent can use tools as part of the summarization process.
• summarization_system_prompt - Optional system prompt override for summarization. If None, uses the default summarization prompt.
• proactive_compression - Enable proactive context compression before the model call.
  • True: compress when 70% of the context window is used (default threshold).
  • \{"compression_threshold": float}: compress at the specified ratio (0, 1].
  • False or None: disabled, only reactive overflow recovery is used.

restore_from_session

@override
def restore_from_session(state: dict[str, Any]) -> list[Message] | None

Defined in: src/strands/agent/conversation_manager/summarizing_conversation_manager.py:101

Restores the Summarizing Conversation manager from its previous state in a session.

Arguments:

• state - The previous state of the Summarizing Conversation Manager.

Returns:

Optionally returns the previous conversation summary if it exists.

get_state

def get_state() -> dict[str, Any]

Defined in: src/strands/agent/conversation_manager/summarizing_conversation_manager.py:114

Returns a dictionary representation of the state for the Summarizing Conversation Manager.

apply_management

def apply_management(agent: "Agent", **kwargs: Any) -> None

Defined in: src/strands/agent/conversation_manager/summarizing_conversation_manager.py:118

Apply management strategy to conversation history.

For the summarizing conversation manager, no proactive management is performed. Summarization only occurs when there’s a context overflow that triggers reduce_context.

Arguments:

• agent - The agent whose conversation history will be managed. The agent’s messages list is modified in-place.
• **kwargs - Additional keyword arguments for future extensibility.

reduce_context

def reduce_context(agent: "Agent",
                   e: Exception | None = None,
                   **kwargs: Any) -> None

Defined in: src/strands/agent/conversation_manager/summarizing_conversation_manager.py:132

Reduce context using summarization.

When e is set (reactive overflow recovery), summarization failure is re-raised — the agent loop must not proceed with an overflow.

When e is None (proactive compression), summarization failure is logged and returns silently — the model call proceeds regardless.

Arguments:

• agent - The agent whose conversation history will be reduced. The agent’s messages list is modified in-place.
• e - The exception that triggered the context reduction, if any. When set, this is a reactive overflow recovery call. When None, this is a proactive compression call (best-effort).
• **kwargs - Additional keyword arguments for future extensibility.

Raises:

• Exception - If summarization fails during reactive overflow recovery (e is set).