Enum ChatMessage 

pub enum ChatMessage {
    System {
        content: String,
        ephemeral: bool,
    },
    User {
        content: String,
        images: Vec<ImageAttachment>,
        ephemeral: bool,
    },
    Assistant {
        content: Option<String>,
        reasoning_content: Option<String>,
        tool_calls: Option<Vec<ToolCallMessage>>,
    },
    Tool {
        tool_call_id: String,
        content: String,
    },
    Custom {
        role: String,
        data: Value,
    },
}

Variants

System

Fields

content: String

ephemeral: bool

临时消息：turn 结束后从内存清理，持久化时跳过。

User

Fields

content: String

images: Vec<ImageAttachment>

ephemeral: bool

临时消息：turn 结束后从内存清理，持久化时跳过。

Assistant

Fields

content: Option<String>

reasoning_content: Option<String>

tool_calls: Option<Vec<ToolCallMessage>>

Tool

Fields

tool_call_id: String

content: String

Custom

Application-defined message type for extensibility.

Consumers can inject custom message types (e.g., artifacts, notifications) into the conversation transcript. Custom messages are preserved in the transcript but filtered out by the default [convert_to_llm] callback before being sent to the LLM provider.

Fields

role: String

data: Value

Implementations

impl ChatMessage

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

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

创建临时 system 消息：turn 结束后自动清理，不持久化。

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

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

创建临时 user 消息：turn 结束后自动清理，不持久化。

pub fn user_with_images( content: impl Into<String>, images: Vec<ImageAttachment>, ) -> Self

pub fn is_ephemeral(&self) -> bool

是否为临时消息（turn 结束后自动清理，不持久化）。

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

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

pub fn assistant_tool_call( tool_call_id: impl Into<String>, tool_name: impl Into<String>, arguments: impl Into<String>, ) -> Self

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

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 From<&ChatMessage> for Message

fn from(cm: &ChatMessage) -> Self

Converts to this type from the input type.

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.