Struct ConversationMessage 

pub struct ConversationMessage {
    pub role: MessageRole,
    pub content: String,
    pub tool_calls: Vec<ToolCallRequest>,
    pub tool_call_id: Option<String>,
}

A single message in a tool-calling conversation.

Covers all four roles in MessageRole. For Assistant messages, tool_calls may be populated with the requests the model wants executed. For Tool messages, tool_call_id carries the ID of the request being responded to and content holds the JSON-serialized result.

Fields

role: MessageRole

Who sent this message.

content: String

Text content. For Tool messages this is a JSON-serialized result.

tool_calls: Vec<ToolCallRequest>

Tool calls requested by the assistant. Empty for non-assistant messages.

tool_call_id: Option<String>

ID of the tool call this message is responding to. Present only on Tool role messages.

Implementations

impl ConversationMessage

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>, tool_calls: Vec<ToolCallRequest>, ) -> Self

Create an assistant message, optionally carrying tool calls.

pub fn tool_result(tool_call_id: impl Into<String>, result: &Value) -> Self

Create a tool-result message. The result value is JSON-serialized into content; if serialization fails the message falls back to "{}".

Trait Implementations

impl Clone for ConversationMessage

fn clone(&self) -> ConversationMessage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConversationMessage

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ConversationMessage

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ConversationMessage

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

where __S: Serializer,

Serialize this value into the given Serde serializer.