agents-features-longterm-memory/ai.koog.agents.longtermmemory.retrieval.augmentation/SystemPromptAugmenter

SystemPromptAugmenter

class SystemPromptAugmenter(template: String = DEFAULT_SYSTEM_PROMPT_TEMPLATE, contextPrefix: String = PromptAugmenter.DEFAULT_CONTEXT_PREFIX) : PromptAugmenter(source)

A PromptAugmenter that injects retrieved context into the first Message.System of the prompt.

The retrieved context is rendered through template and added as an additional MessagePart.Text appended to the existing parts of the first system message, separated by PromptAugmenter.SECTION_SEPARATOR. The original system message is replaced with a copy that:

preserves its Message.metaInfo and Message.id,
preserves all existing parts (text, attachments, etc.),
gains two extra MessagePart.Text entries at the end: a separator and the formatted context.

If the prompt contains no Message.System, or the formatted context is blank, or the relevant context list is empty, the original prompt is returned unchanged.