kotlin-sdk-core/io.modelcontextprotocol.kotlin.sdk.types/SamplingMessageBuilder

SamplingMessageBuilder

class SamplingMessageBuilder(source)

DSL builder for constructing lists of SamplingMessage instances.

This builder creates a conversation history for LLM sampling requests.

Example:

messages {
    user { "Hello!" }
    assistant { "Hi! How can I help?" }
    user { "What's 2+2?" }
}

See also

SamplingMessage

CreateMessageRequestBuilder.messages

Functions

fun assistant(content: MediaContent)

Adds an assistant message with the specified content.

@ExperimentalMcpApi

fun SamplingMessageBuilder.assistant(block: () -> String)

Adds an assistant message with simple text content.

@ExperimentalMcpApi

fun SamplingMessageBuilder.assistantAudio(block: AudioContentBuilder.() -> Unit)

Adds an assistant message with audio content.

@ExperimentalMcpApi

fun SamplingMessageBuilder.assistantImage(block: ImageContentBuilder.() -> Unit)

Adds an assistant message with image content.

@ExperimentalMcpApi

fun SamplingMessageBuilder.assistantText(block: TextContentBuilder.() -> Unit)

Adds an assistant message with text content using a DSL builder.

fun user(content: MediaContent)

Adds a user message with the specified content.

@ExperimentalMcpApi

fun SamplingMessageBuilder.user(block: () -> String)

Adds a user message with simple text content.

@ExperimentalMcpApi

fun SamplingMessageBuilder.userAudio(block: AudioContentBuilder.() -> Unit)

Adds a user message with audio content.

@ExperimentalMcpApi

fun SamplingMessageBuilder.userImage(block: ImageContentBuilder.() -> Unit)

Adds a user message with image content.

@ExperimentalMcpApi

fun SamplingMessageBuilder.userText(block: TextContentBuilder.() -> Unit)

Adds a user message with text content using a DSL builder.