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
| Usage | Fields and validation |
|---|---|
| In requests | View fields |
| In responses | View fields |
In requests
Section ID: DOC-API-MODEL-schema-1hgrvsu34j#request
API JSON uses JSON field names (camelCase).
| Field | Type | Presence | Meaning |
|---|---|---|---|
Section ID: DOC-API-MODEL-schema-1hgrvsu34j#request-field-strategystrategy | string (CONTEXT_STRATEGY_COMPACTION, CONTEXT_STRATEGY_WINDOWING, CONTEXT_STRATEGY_NONE) or integer (int32) | Optional; explicit presence | Context management strategy selected for the conversation. |
Section ID: DOC-API-MODEL-schema-1hgrvsu34j#request-field-compactionconfigcompactionConfig | CompactionConfig | Optional | Configuration applied when summarizing the conversation context. |
Section ID: DOC-API-MODEL-schema-1hgrvsu34j#request-field-windowingconfigwindowingConfig | WindowingConfig | Optional | Rules selecting the message window retained in model context. |
Section ID: DOC-API-MODEL-schema-1hgrvsu34j#request-field-selectiveexclusionconfigselectiveExclusionConfig | SelectiveExclusionConfig | Optional | Rules 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.
| Value | No. | Form | Meaning |
|---|---|---|---|
CONTEXT_STRATEGY_COMPACTION | 0 | Canonical | Use completed compaction summaries and remaining history; fall back to windowing when no completed summary is available. |
CONTEXT_STRATEGY_WINDOWING | 1 | Canonical | Keep a bounded window of recent conversation messages according to the windowing configuration. |
CONTEXT_STRATEGY_NONE | 2 | Canonical | Pass 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).
| Field | Type | Presence | Meaning |
|---|---|---|---|
Section ID: DOC-API-MODEL-schema-1hgrvsu34j#field-strategySection ID: DOC-API-MODEL-schema-1hgrvsu34j#response-field-strategystrategy | string (CONTEXT_STRATEGY_COMPACTION, CONTEXT_STRATEGY_WINDOWING, CONTEXT_STRATEGY_NONE) or integer (int32) | Optional; explicit presence | Context management strategy selected for the conversation. |
Section ID: DOC-API-MODEL-schema-1hgrvsu34j#field-compactionconfigSection ID: DOC-API-MODEL-schema-1hgrvsu34j#response-field-compactionconfigcompactionConfig | CompactionConfig | Optional | Configuration applied when summarizing the conversation context. |
Section ID: DOC-API-MODEL-schema-1hgrvsu34j#field-windowingconfigSection ID: DOC-API-MODEL-schema-1hgrvsu34j#response-field-windowingconfigwindowingConfig | WindowingConfig | Optional | Rules 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-selectiveexclusionconfigselectiveExclusionConfig | SelectiveExclusionConfig | Optional | Rules 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.
| Value | No. | Form | Meaning |
|---|---|---|---|
CONTEXT_STRATEGY_COMPACTION | 0 | Canonical | Use completed compaction summaries and remaining history; fall back to windowing when no completed summary is available. |
CONTEXT_STRATEGY_WINDOWING | 1 | Canonical | Keep a bounded window of recent conversation messages according to the windowing configuration. |
CONTEXT_STRATEGY_NONE | 2 | Canonical | Pass the conversation history without applying compaction or windowing. |
Where used
Section ID: DOC-API-MODEL-schema-1hgrvsu34j#where-used
| Reference | Relationship |
|---|---|
| Get full conversation state | POST /api/v1/llm/conversation-state |
| Update context management settings | POST /api/v1/llm/update-context-management-settings |
| Create a new conversation thread | POST /api/v1/llm/create-thread |
Download the public reference contract.
Document ID: DOC-API-MODEL-schema-1hgrvsu34j