diff --git a/libs/core/langchain_core/messages/ai.py b/libs/core/langchain_core/messages/ai.py index 774fab46113..207ab6c1133 100644 --- a/libs/core/langchain_core/messages/ai.py +++ b/libs/core/langchain_core/messages/ai.py @@ -201,7 +201,7 @@ class AIMessage(BaseMessage): content_blocks: Optional[list[types.ContentBlock]] = None, **kwargs: Any, ) -> None: - """Specify content as a positional arg or content_blocks for typing support.""" + """Specify ``content`` as positional arg or ``content_blocks`` for typing.""" if content_blocks is not None: # If there are tool calls in content_blocks, but not in tool_calls, add them content_tool_calls = [ diff --git a/libs/core/langchain_core/messages/base.py b/libs/core/langchain_core/messages/base.py index 13b12f764d1..871f687d35c 100644 --- a/libs/core/langchain_core/messages/base.py +++ b/libs/core/langchain_core/messages/base.py @@ -83,7 +83,7 @@ class BaseMessage(Serializable): content_blocks: Optional[list[types.ContentBlock]] = None, **kwargs: Any, ) -> None: - """Specify content as a positional arg or content_blocks for typing support.""" + """Specify ``content`` as positional arg or ``content_blocks`` for typing.""" if content_blocks is not None: super().__init__(content=content_blocks, **kwargs) else: @@ -108,17 +108,18 @@ class BaseMessage(Serializable): @property def content_blocks(self) -> list[types.ContentBlock]: - """Return the content as a list of standard ContentBlocks. + """Return the content as a list of standard ``ContentBlock``s. To use this property, the corresponding chat model must support - ``message_version="v1"`` or higher: + ``message_version='v1'`` or higher: .. code-block:: python from langchain.chat_models import init_chat_model llm = init_chat_model("...", message_version="v1") - otherwise, does best-effort parsing to standard types. + Otherwise, does best-effort parsing to standard types. + """ blocks: list[types.ContentBlock] = [] content = ( diff --git a/libs/core/langchain_core/messages/human.py b/libs/core/langchain_core/messages/human.py index 041db0cdb97..954f05f037e 100644 --- a/libs/core/langchain_core/messages/human.py +++ b/libs/core/langchain_core/messages/human.py @@ -63,7 +63,7 @@ class HumanMessage(BaseMessage): content_blocks: Optional[list[types.ContentBlock]] = None, **kwargs: Any, ) -> None: - """Specify content as a positional arg or content_blocks for typing support.""" + """Specify ``content`` as positional arg or ``content_blocks`` for typing.""" if content_blocks is not None: super().__init__( content=cast("Union[str, list[Union[str, dict]]]", content_blocks), diff --git a/libs/core/langchain_core/messages/system.py b/libs/core/langchain_core/messages/system.py index c8a5bbae5c8..a3f399b88c1 100644 --- a/libs/core/langchain_core/messages/system.py +++ b/libs/core/langchain_core/messages/system.py @@ -56,7 +56,7 @@ class SystemMessage(BaseMessage): content_blocks: Optional[list[types.ContentBlock]] = None, **kwargs: Any, ) -> None: - """Specify content as a positional arg or content_blocks for typing support.""" + """Specify ``content`` as positional arg or ``content_blocks`` for typing.""" if content_blocks is not None: super().__init__( content=cast("Union[str, list[Union[str, dict]]]", content_blocks), diff --git a/libs/core/langchain_core/messages/tool.py b/libs/core/langchain_core/messages/tool.py index 14177181480..efb714bb585 100644 --- a/libs/core/langchain_core/messages/tool.py +++ b/libs/core/langchain_core/messages/tool.py @@ -157,7 +157,7 @@ class ToolMessage(BaseMessage, ToolOutputMixin): content_blocks: Optional[list[types.ContentBlock]] = None, **kwargs: Any, ) -> None: - """Specify content as a positional arg or content_blocks for typing support.""" + """Specify ``content`` as positional arg or ``content_blocks`` for typing.""" if content_blocks is not None: super().__init__( content=cast("Union[str, list[Union[str, dict]]]", content_blocks),