Struct HumanMessage 

pub struct HumanMessage { /* private fields */ }

A human message in the conversation.

Human messages support both simple text content and multimodal content with images. Use HumanMessage::new for simple text messages and HumanMessage::with_content for multimodal messages.

This corresponds to HumanMessage in LangChain Python.

Implementations

impl HumanMessage

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

Create a new human message with simple text content.

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

Create a new human message with simple text content and an explicit ID.

Use this when deserializing or reconstructing messages where the ID must be preserved.

pub fn with_content(parts: Vec<ContentPart>) -> Self

Create a new human message with multipart content.

Example

use agent_chain_core::messages::{HumanMessage, ContentPart, ImageSource};

let msg = HumanMessage::with_content(vec![
    ContentPart::Text { text: "What's in this image?".into() },
    ContentPart::Image {
        source: ImageSource::Url {
            url: "https://example.com/image.jpg".into(),
        },
        detail: None,
    },
]);

pub fn with_id_and_content( id: impl Into<String>, parts: Vec<ContentPart>, ) -> Self

Create a new human message with multipart content and an explicit ID.

Use this when deserializing or reconstructing messages where the ID must be preserved.

pub fn with_image_url(text: impl Into<String>, url: impl Into<String>) -> Self

Create a human message with text and a single image from a URL.

pub fn with_image_base64( text: impl Into<String>, media_type: impl Into<String>, data: impl Into<String>, ) -> Self

Create a human message with text and a single base64-encoded image.

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

Set the name for this message.

pub fn content(&self) -> &str

Get the message content as text.

For multipart messages, this returns an empty string. Use message_content() to access the full content.

pub fn message_content(&self) -> &MessageContent

Get the full message content (text or multipart).

pub fn has_images(&self) -> bool

Check if this message contains images.

pub fn id(&self) -> Option<&str>

Get the message ID.

pub fn name(&self) -> Option<&str>

Get the message name.

pub fn additional_kwargs(&self) -> &HashMap<String, Value>

Get additional kwargs.

Trait Implementations

impl Clone for HumanMessage

fn clone(&self) -> HumanMessage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HumanMessage

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for HumanMessage

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<HumanMessage> for BaseMessage

fn from(msg: HumanMessage) -> Self

Converts to this type from the input type.

impl From<HumanMessage> for HumanMessageInput

fn from(message: HumanMessage) -> Self

Converts to this type from the input type.

impl PartialEq for HumanMessage

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for HumanMessage

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 HumanMessage