Struct Message 

pub struct Message {
    pub content: String,
    pub images: Vec<ImageContent>,
    pub audio: Vec<AudioContent>,
    pub files: Vec<FileContent>,
    pub message_type: MessageType,
    pub name: Option<String>,
    pub additional_kwargs: HashMap<String, Value>,
    pub id: Option<String>,
    pub tool_calls: Option<Vec<ToolCall>>,
}

Complete message structure for chat interactions.

Fields

content: String

images: Vec<ImageContent>

图片内容(多模态 vision)

audio: Vec<AudioContent>

音频内容(多模态 audio)

files: Vec<FileContent>

文件内容(多模态 document)

message_type: MessageType

name: Option<String>

additional_kwargs: HashMap<String, Value>

id: Option<String>

tool_calls: Option<Vec<ToolCall>>

Implementations

impl Message

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

Creates a system message.

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

Creates a human (user) message.

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

Creates a human message with an image (vision).

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

Creates a human message with multiple images.

pub fn human_with_audio(content: impl Into<String>, audio: AudioContent) -> Self

Creates a human message with audio content.

pub fn human_with_file(content: impl Into<String>, file: FileContent) -> Self

Creates a human message with file content.

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

Creates an AI (assistant) message.

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

Creates an AI message with tool calls.

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

Creates a tool result message.

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

Sets the message name.

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

Sets the message ID.

pub fn with_additional_kwarg(self, key: impl Into<String>, value: Value) -> Self

Adds an additional keyword argument.

pub fn with_image(self, image: ImageContent) -> Self

Adds an image to the message (vision).

pub fn with_audio(self, audio: AudioContent) -> Self

Adds audio content to the message.

pub fn with_file(self, file: FileContent) -> Self

Adds file content to the message.

pub fn has_images(&self) -> bool

Returns whether the message has images.

pub fn has_audio(&self) -> bool

Returns whether the message has audio content.

pub fn has_files(&self) -> bool

Returns whether the message has file content.

pub fn is_multimodal(&self) -> bool

Returns whether the message has any multimodal content (images, audio, or files).

pub fn type_str(&self) -> String

Returns the message type as a string.

Tool messages include their tool_call_id (e.g. "tool:call_123") so the type string is unambiguous about which tool result the message holds.

pub fn has_tool_calls(&self) -> bool

Returns whether the message has tool calls.

pub fn get_tool_calls(&self) -> Option<&[ToolCall]>

Returns the tool calls if present.

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 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.