Skip to content
masterclass Buddy

LangChain · Function

filter_messages

Filters LangChain messages by name, type, ID, or tool-call ID. It returns the messages that remain after the include and exclude rules are applied.

Last updated

Since
v1.7

Syntax

filter_messages(messages: Iterable[MessageLikeRepresentation] | PromptValue, *, include_names: Sequence[str] | None = None, exclude_names: Sequence[str] | None = None, include_types: Sequence[str | type[BaseMessage]] | None = None, exclude_types: Sequence[str | type[BaseMessage]] | None = None, include_ids: Sequence[str] | None = None, exclude_ids: Sequence[str] | None = None, exclude_tool_calls: Sequence[str] | bool | None = None) -> list[BaseMessage]

In-depth API docs are only for subscribers: parameters, examples, common mistakes and interview practice.

Subscribe
  • BaseMessage
  • AIMessage
  • HumanMessage
  • SystemMessage
  • ToolMessage
  • MessageLikeRepresentation
  • PromptValue

Source: filter_messages | langchain_core | LangChain Reference. Checked 2026-11-03.