Skip to main content

ContextManagementSettings

Configuration for context management

Usage profiles​

UsageFields and validation
In requestsView fields
In responsesView fields

In requests​

API JSON uses JSON field names (camelCase).

FieldTypePresenceMeaning
strategystring (CONTEXT_STRATEGY_COMPACTION, CONTEXT_STRATEGY_WINDOWING, CONTEXT_STRATEGY_NONE) or integer (int32)OptionalContext management strategy selected for the conversation.
compactionConfigCompactionConfigOptionalConfiguration applied when summarizing the conversation context.
windowingConfigWindowingConfigOptionalRules selecting the message window retained in model context.
selectiveExclusionConfigSelectiveExclusionConfigOptionalRules selecting content to omit from the model context.

Values of strategy​

How stored conversation history is selected or summarized for model context.

ValueNo.FormMeaning
CONTEXT_STRATEGY_COMPACTION1CanonicalUse completed compaction summaries and remaining history; fall back to windowing when no completed summary is available.
CONTEXT_STRATEGY_WINDOWING2CanonicalKeep a bounded window of recent conversation messages according to the windowing configuration.
CONTEXT_STRATEGY_NONE3CanonicalPass the conversation history without applying compaction or windowing.

In responses​

API JSON uses JSON field names (camelCase).

FieldTypePresenceMeaning
strategystring (CONTEXT_STRATEGY_COMPACTION, CONTEXT_STRATEGY_WINDOWING, CONTEXT_STRATEGY_NONE) or integer (int32)OptionalContext management strategy selected for the conversation.
compactionConfigCompactionConfigOptionalConfiguration applied when summarizing the conversation context.
windowingConfigWindowingConfigOptionalRules selecting the message window retained in model context.
selectiveExclusionConfigSelectiveExclusionConfigOptionalRules selecting content to omit from the model context.

Values of strategy​

How stored conversation history is selected or summarized for model context.

ValueNo.FormMeaning
CONTEXT_STRATEGY_COMPACTION1CanonicalUse completed compaction summaries and remaining history; fall back to windowing when no completed summary is available.
CONTEXT_STRATEGY_WINDOWING2CanonicalKeep a bounded window of recent conversation messages according to the windowing configuration.
CONTEXT_STRATEGY_NONE3CanonicalPass the conversation history without applying compaction or windowing.

Where used​

ReferenceRelationship
Create a new conversation threadPOST /api/v1/llm/create-thread
Update context management settingsPOST /api/v1/llm/update-context-management-settings
Get full conversation statePOST /api/v1/llm/conversation-state

Download the public reference contract.

Document: DOC-API-MODEL-context-management-settings.