Struct ChatMessage 

pub struct ChatMessage {
    pub role: Role,
    pub content: Option<String>,
    pub reasoning_content: Option<String>,
    pub refusal: Option<String>,
    pub name: Option<String>,
    pub tool_calls: Option<Vec<ToolCall>>,
    pub tool_call_id: Option<String>,
}

A message in a chat conversation.

Fields

role: Role

Role of the message author.

content: Option<String>

Text contents of the message. Optional when assistant returns tool calls.

reasoning_content: Option<String>

Reasoning or chain-of-thought tokens from reasoning models (e.g. DeepSeek-R1, o1/o3).

refusal: Option<String>

Refusal message if the model refused to respond.

name: Option<String>

Optional participant name.

tool_calls: Option<Vec<ToolCall>>

Tool calls made by the assistant, if any.

tool_call_id: Option<String>

ID of the tool call this message is responding to (for role = Role::Tool).

Implementations

impl ChatMessage

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

Construct a new system message.

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

Construct a new developer instruction message for reasoning models.

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

Construct a new user message.

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

Construct a new assistant message.

pub fn assistant_with_reasoning( content: impl Into<String>, reasoning: impl Into<String>, ) -> Self

Construct a new assistant message containing reasoning content.

pub fn assistant_tool_calls(tool_calls: Vec<ToolCall>) -> Self

Construct a new assistant message containing tool calls.

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

Construct a new tool reply message for a given tool call ID.

pub fn function(name: impl Into<String>, content: impl Into<String>) -> Self

Construct a new legacy function reply message.

pub fn name(self, name: impl Into<String>) -> Self

Set an optional participant name for the message.

pub fn refusal(self, refusal: impl Into<String>) -> Self

Set an optional refusal message for an assistant reply.

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

Set the text content for the message.

pub fn reasoning_content(self, reasoning: impl Into<String>) -> Self

Set reasoning content (thinking tokens) for the message.

pub fn tool_calls(self, tool_calls: Vec<ToolCall>) -> Self

Attach tool calls to the message.

Trait Implementations

impl Clone for ChatMessage

fn clone(&self) -> ChatMessage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ChatMessage

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ChatMessage

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ChatMessage

impl PartialEq for ChatMessage

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ChatMessage

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 ChatMessage