Skip to main content
Section ID: DOC-API-MODEL-schema-1hgrvsu34j#overview

ContextManagementSettings

Configuration for context management

Meaning and usage​

Section ID: DOC-API-MODEL-schema-1hgrvsu34j#meaning

See the definition above.

Usage profiles​

Section ID: DOC-API-MODEL-schema-1hgrvsu34j#fields

UsageFields and validation
In requestsView fields
In responsesView fields

In requests​

Section ID: DOC-API-MODEL-schema-1hgrvsu34j#request

API JSON uses JSON field names (camelCase).

FieldTypePresenceMeaning
Section ID: DOC-API-MODEL-schema-1hgrvsu34j#request-field-strategystrategystring (CONTEXT_STRATEGY_COMPACTION, CONTEXT_STRATEGY_WINDOWING, CONTEXT_STRATEGY_NONE) or integer (int32)Optional; explicit presenceContext management strategy selected for the conversation.
Section ID: DOC-API-MODEL-schema-1hgrvsu34j#request-field-compactionconfigcompactionConfigCompactionConfigOptionalConfiguration applied when summarizing the conversation context.
Section ID: DOC-API-MODEL-schema-1hgrvsu34j#request-field-windowingconfigwindowingConfigWindowingConfigOptionalRules selecting the message window retained in model context.
Section ID: DOC-API-MODEL-schema-1hgrvsu34j#request-field-selectiveexclusionconfigselectiveExclusionConfigSelectiveExclusionConfigOptionalRules selecting content to omit from the model context.

Values of strategy​

Section ID: DOC-API-MODEL-schema-1hgrvsu34j#request-values-strategy

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

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

In responses​

Section ID: DOC-API-MODEL-schema-1hgrvsu34j#response

API JSON uses JSON field names (camelCase).

FieldTypePresenceMeaning
Section ID: DOC-API-MODEL-schema-1hgrvsu34j#field-strategySection ID: DOC-API-MODEL-schema-1hgrvsu34j#response-field-strategystrategystring (CONTEXT_STRATEGY_COMPACTION, CONTEXT_STRATEGY_WINDOWING, CONTEXT_STRATEGY_NONE) or integer (int32)Optional; explicit presenceContext management strategy selected for the conversation.
Section ID: DOC-API-MODEL-schema-1hgrvsu34j#field-compactionconfigSection ID: DOC-API-MODEL-schema-1hgrvsu34j#response-field-compactionconfigcompactionConfigCompactionConfigOptionalConfiguration applied when summarizing the conversation context.
Section ID: DOC-API-MODEL-schema-1hgrvsu34j#field-windowingconfigSection ID: DOC-API-MODEL-schema-1hgrvsu34j#response-field-windowingconfigwindowingConfigWindowingConfigOptionalRules selecting the message window retained in model context.
Section ID: DOC-API-MODEL-schema-1hgrvsu34j#field-selectiveexclusionconfigSection ID: DOC-API-MODEL-schema-1hgrvsu34j#response-field-selectiveexclusionconfigselectiveExclusionConfigSelectiveExclusionConfigOptionalRules selecting content to omit from the model context.

Values of strategy​

Section ID: DOC-API-MODEL-schema-1hgrvsu34j#response-values-strategy

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

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

Where used​

Section ID: DOC-API-MODEL-schema-1hgrvsu34j#where-used

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

Download the public reference contract.

Document ID: DOC-API-MODEL-schema-1hgrvsu34j