Request

@Serializable
sealed interface Request : Content

Content that can be sent to a model in a request.

Samples

// Work with request content.
val chat = listOf<Message>(
    Message(
        role = Role.User,
        content = Content.Text("Ping!")
    ),
    Message(
        role = Role.Assistant,
        content = Content.Text("Pong!")
    ),
    Message(
        role = Role.User,
        content = Content.Text("How are you?")
    ),
    //If you try to use Content.Reasoning inside a Message, you'll get a compiler error:
    // Argument type mismatch: actual type is ‘Content.Reasoning’, but ‘Content.Request’ was expected.
    //
    //This happens because these classes do not inherit from Request.
).asChat(model = modelName)

for (message in chat.messages) {
    when (val content = message.content) { // Content is Content.Request
        is Content.Parts -> println("Parts: ${content.parts}")
        is Content.Text -> println("Text: ${content.text}")
        is Content.ToolCall -> println("ToolCall: ${content.name} with ${content.argumentsJson}")
        is Content.ToolResult -> println("ToolResult: ${content.name} with ${content.content}")
    }
}
// responseContents is List<Content.Response>
// Transform from List<Content.Response> to List<Content.Request> using .asRequestContents() extension-function.
val requestContents = responseContents.asRequestContents()

// Since .asRequestContents() discards all content that cannot be converted to a Content.Request,
// we check to see if at least one Content.Response was successfully converted
if (requestContents.isNotEmpty()) {
    for (content in requestContents) {
        when (content) { // Now content is List<Content.Request>
            is Content.Parts -> println("Parts: ${content.parts}")
            is Content.Text -> println("Text: ${content.text}")
            is Content.ToolCall -> println("ToolCall: ${content.name} with ${content.argumentsJson}")
            is Content.ToolResult -> println("ToolResult: ${content.name} with ${content.content}")
        }
    }
}

Inheritors

Functions

Link copied to clipboard

Wraps this request content as an assistant Message.