Struct Message 

pub struct Message {
    pub role: Role,
    pub content: String,
    pub content_blocks: Vec<ContentBlock>,
    pub tool_calls: Vec<ToolCall>,
    pub tool_call_id: Option<String>,
    pub tool_error: bool,
}

A single message in a conversation.

Supports text-only and multimodal (text + images) content.

Use the constructors (Message::system, Message::user, Message::assistant, Message::tool, Message::user_multimodal, …) rather than building the struct by hand; they keep the role and the tool-related fields consistent.

Examples

use rai_sdk::Message;

let system = Message::system("Answer in one sentence.");
let user = Message::user("Why is the sky blue?");
assert_eq!(user.text_content(), "Why is the sky blue?");
assert!(!user.is_multimodal());

// Tool results reference the call they answer.
let result = Message::tool(r#"{"temp_c":21}"#, "call_abc123");
assert_eq!(result.tool_call_id.as_deref(), Some("call_abc123"));

Fields

role: Role

Who produced this message.

content: String

Text content (for simple text-only messages).

content_blocks: Vec<ContentBlock>

Multimodal content blocks. When non-empty, content is ignored.

tool_calls: Vec<ToolCall>

Tool calls emitted by an assistant message.

tool_call_id: Option<String>

The tool call ID this tool result corresponds to.

tool_error: bool

Whether a tool result represents an error.

Implementations

impl Message

pub fn system(content: impl Into<String>) -> Self

Create a system message.

pub fn user(content: impl Into<String>) -> Self

Create a user message.

pub fn assistant(content: impl Into<String>) -> Self

Create an assistant message.

pub fn assistant_with_tool_calls( content: impl Into<String>, tool_calls: Vec<ToolCall>, ) -> Self

Create an assistant message that includes tool calls.

pub fn tool(content: impl Into<String>, tool_call_id: impl Into<String>) -> Self

Create a successful tool result message.

pub fn tool_error( content: impl Into<String>, tool_call_id: impl Into<String>, ) -> Self

Create a tool result message that represents an error.

pub fn user_multimodal(content_blocks: Vec<ContentBlock>) -> Self

Create a user message with multimodal content blocks.

pub fn is_multimodal(&self) -> bool

Check if this message has multimodal content.

pub fn has_tool_calls(&self) -> bool

Check whether the assistant message contains tool calls.

pub fn text_content(&self) -> String

Get the text content of this message.

For multimodal messages, this concatenates all text blocks.

Trait Implementations

impl Clone for Message

fn clone(&self) -> Message

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Message

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Message

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<Message> for Prompt

fn from(message: Message) -> Self

Converts to this type from the input type.

impl PartialEq for Message

fn eq(&self, other: &Message) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Message

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Message