View Source LangChain.Message (LangChain v0.3.3)

Models a complete Message for a chat LLM.

Roles

:system - a system message. Typically just one and it occurs first as a primer for how the LLM should behave.
:user - The user or application responses. Typically represents the "human" element of the exchange.
:assistant - Responses coming back from the LLM. This includes one or more "tool calls", requesting that the system execute a tool on behalf of the LLM and return the response.
:tool - A message for returning the result of executing a tool request.

Tools

A tool_call comes from the :assistant role. The tool_id identifies which of the available tool's to execute.

Create a message of role :tool to provide the system responses for one or more tool requests. A ToolResult handles the response back to the LLM.

User Content Parts

Some LLMs support multi-modal messages. This means the user's message content can be text and/or image data. Within the LLMs, these are often referred to as "Vision", meaning you can provide text like "Please identify the what this is an image of" and provide an image.

User Content Parts are implemented through LangChain.Message.ContentPart. A list of them can be supplied as the "content" for a message. Only a few LLMs support it, and they may require using specific models trained for it. See the documentation for the LLM or service for details on their level of support.

Processed Content

The processed_content field is a handy place to store the results of processing a message and needing to hold on to the processed value and store it with the message.

This is particularly helpful for a LangChain.MessageProcessors.JsonProcessor that can process an assistant message and store the processed value on the message itself.

It is intended for assistant messages when a message processor is applied. This contains the results of the processing. This allows the content to reflect what was actually returned from the LLM so it can easily be sent back to the LLM as a part of the entire conversation.

Examples

A basic system message example:

alias LangChain.Message

Message.new_system!("You are a helpful assistant.")

A basic user message:

Message.new_user!("Who is Prime Minister of the moon?")

A multi-part user message: alias LangChain.Message.ContentPart

Message.new_user!([
  ContentPart.text!("What is in this picture?"),
  ContentPart.image_url!("https://upload.wikimedia.org/wikipedia/commons/thumb/d/dd/Gfp-wisconsin-madison-the-nature-boardwalk.jpg/2560px-Gfp-wisconsin-madison-the-nature-boardwalk.jpg")
]

Summary

Types

status()

t()

Functions

append_tool_result(message, result)

Append a ToolResult to a message. A result can only be added to a :tool role message.

is_tool_call?(message)

Return if a Message is a tool_call.

is_tool_related?(message)

Return if a Message is tool related. It may be a tool call or a tool result.

new(attrs \\ %{})

Build a new message and return an :ok/:error tuple with the result.

new!(attrs \\ %{})

Build a new message and return it or raise an error if invalid.

new_assistant(attrs \\ %{})

Create a new assistant message which represents a response from the AI or LLM.

new_assistant!(content)

Create a new assistant message which represents a response from the AI or LLM.

new_system(content \\ "You are a helpful assistant.")

Create a new system message which can prime the AI/Assistant for how to respond.

new_system!(content \\ "You are a helpful assistant.")

Create a new system message which can prime the AI/Assistant for how to respond.

new_tool_result(attrs \\ %{})

Create a new tool message to represent the result of a tool's execution.

new_tool_result!(attrs \\ %{})

Create a new tool response message to return the result of an executed tool.

new_user(content)

Create a new user message which represents a human message or a message from the application.

new_user!(content)

Create a new user message which represents a human message or a message from the application.

tool_had_errors?(message)

Return true if the message is a tool response and any of the ToolResults ended in an error. Returns false if not a tool response or all ToolResults succeeded.

validate_tool_results_list_type(changeset)

validate_tool_results_required(changeset)

Types

status()

@type status() :: :complete | :cancelled | :length

t()

@type t() :: %LangChain.Message{
  content: term(),
  index: term(),
  metadata: term(),
  name: term(),
  processed_content: term(),
  role: term(),
  status: term(),
  tool_calls: term(),
  tool_results: term()
}

Functions

append_tool_result(message, result)

@spec append_tool_result(t(), LangChain.Message.ToolResult.t()) :: t() | no_return()

Append a ToolResult to a message. A result can only be added to a :tool role message.

is_tool_call?(message)

Return if a Message is a tool_call.

is_tool_related?(message)

Return if a Message is tool related. It may be a tool call or a tool result.

new(attrs \\ %{})

@spec new(attrs :: map()) :: {:ok, t()} | {:error, Ecto.Changeset.t()}

Build a new message and return an :ok/:error tuple with the result.

new!(attrs \\ %{})

@spec new!(attrs :: map()) :: t() | no_return()

Build a new message and return it or raise an error if invalid.

new_assistant(attrs \\ %{})

@spec new_assistant(attrs :: map()) :: {:ok, t()} | {:error, Ecto.Changeset.t()}

Create a new assistant message which represents a response from the AI or LLM.

new_assistant!(content)

@spec new_assistant!(String.t() | map()) :: t() | no_return()

Create a new assistant message which represents a response from the AI or LLM.

new_system(content \\ "You are a helpful assistant.")

@spec new_system(content :: String.t()) :: {:ok, t()} | {:error, Ecto.Changeset.t()}

Create a new system message which can prime the AI/Assistant for how to respond.

new_system!(content \\ "You are a helpful assistant.")

@spec new_system!(content :: String.t()) :: t() | no_return()

Create a new system message which can prime the AI/Assistant for how to respond.

new_tool_result(attrs \\ %{})

@spec new_tool_result(attrs :: map()) :: {:ok, t()} | {:error, Ecto.Changeset.t()}

Create a new tool message to represent the result of a tool's execution.

Attributes

:tool_results - a list of tool ToolResult structs.
:content - Text content returned from the LLM.

new_tool_result!(attrs \\ %{})

@spec new_tool_result!(attrs :: map()) :: t() | no_return()

Create a new tool response message to return the result of an executed tool.

Attributes

:tool_results - a list of tool ToolResult structs.
:content - Text content returned from the LLM.

new_user(content)

@spec new_user(
  content ::
    String.t()
    | [LangChain.Message.ContentPart.t() | LangChain.PromptTemplate.t()]
) :: {:ok, t()} | {:error, Ecto.Changeset.t()}

Create a new user message which represents a human message or a message from the application.

new_user!(content)

@spec new_user!(
  content ::
    String.t()
    | [LangChain.Message.ContentPart.t() | LangChain.PromptTemplate.t()]
) :: t() | no_return()

Create a new user message which represents a human message or a message from the application.

tool_had_errors?(message)

@spec tool_had_errors?(t()) :: boolean()

Return true if the message is a tool response and any of the ToolResults ended in an error. Returns false if not a tool response or all ToolResults succeeded.

validate_tool_results_list_type(changeset)

validate_tool_results_required(changeset)