_ensure_message_copy() — langchain Function Reference

Architecture documentation for the _ensure_message_copy() function in _utils.py from the langchain codebase.

Function python CoreAbstractions MessageSchema called by 1

Entity Profile

CoreAbstractions→ MessageSchema→ _ensure_message_copy() — langchain Function Reference

Dependency Diagram

graph TD
  efa972f5_646a_e032_9352_31040573999c["_ensure_message_copy()"]
  52504dd3_f4d4_21a4_b28c_0c152227d20d["_utils.py"]
  efa972f5_646a_e032_9352_31040573999c -->|defined in| 52504dd3_f4d4_21a4_b28c_0c152227d20d
  030ac02c_2931_4d20_1689_430fac9b6609["_normalize_messages()"]
  030ac02c_2931_4d20_1689_430fac9b6609 -->|calls| efa972f5_646a_e032_9352_31040573999c
  style efa972f5_646a_e032_9352_31040573999c fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

libs/core/langchain_core/language_models/_utils.py lines 295–301

def _ensure_message_copy(message: T, formatted_message: T) -> T:
    """Create a copy of the message if it hasn't been copied yet."""
    if formatted_message is message:
        formatted_message = message.model_copy()
        # Shallow-copy content list to allow modifications
        formatted_message.content = list(formatted_message.content)
    return formatted_message