github/langchain
1
0
Fork 0
mirror of https://github.com/hwchase17/langchain.git synced 2025-08-10 21:35:08 +00:00
Code Issues Packages Projects Releases Wiki Activity

feat(docs): add link to artifact usage in ToolMessage

Browse Source
This commit is contained in:
Mason Daugherty 2025-08-08 12:51:15 -04:00
parent 2f0c6421a1
commit b7968c2b7d
No known key found for this signature in database
1 changed files with 13 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
libs/core/langchain_core/v1/messages.py
View File

@ -57,12 +57,9 @@ class TextAccessor(str):
def __call__(self) -> str:
"""Enable method-style text access for backward compatibility.
This method exists solely to support legacy code that calls ``.text()``
as a method. New code should use property access (``.text``) instead.
.. deprecated:: 0.4.0
Calling .text() as a method is deprecated. Use .text as a property instead.
This method will be removed in 2.0.0.
Calling ``.text()`` as a method is deprecated. Use ``.text`` as a property
instead. This method will be removed in 2.0.0.
Returns:
The string content, identical to property access.
@ -270,8 +267,8 @@ class AIMessage:
Can be used as both property (``message.text``) and method (``message.text()``).
.. deprecated:: 0.4.0
Calling .text() as a method is deprecated. Use .text as a property instead.
This method will be removed in 2.0.0.
Calling ``.text()`` as a method is deprecated. Use ``.text`` as a property
instead. This method will be removed in 2.0.0.
"""
text_value = "".join(
@ -667,8 +664,8 @@ class HumanMessage:
Can be used as both property (``message.text``) and method (``message.text()``).
.. deprecated:: 0.4.0
Calling .text() as a method is deprecated. Use .text as a property instead.
This method will be removed in 2.0.0.
Calling ``.text()`` as a method is deprecated. Use ``.text`` as a property
instead. This method will be removed in 2.0.0.
"""
text_value = "".join(
@ -762,8 +759,8 @@ class SystemMessage:
Can be used as both property (``message.text``) and method (``message.text()``).
.. deprecated:: 0.4.0
Calling .text() as a method is deprecated. Use .text as a property instead.
This method will be removed in 2.0.0.
Calling ``.text()`` as a method is deprecated. Use ``.text`` as a property
instead. This method will be removed in 2.0.0.
"""
text_value = "".join(
@ -811,15 +808,10 @@ class ToolMessage(ToolOutputMixin):
"""
artifact: Optional[Any] = None
"""App-side payload not intended for the model.
"""App-side payload not intended for model consumption.
Artifacts contain data that your application needs but should not be sent
to the AI model. Example use cases:
- File handles or database connections used by the tool
- Raw binary data (images, documents) alongside text summaries
- Internal debugging information or execution traces
- Computed results that supplement the text content
Additonal info and usage examples are available
`in the LangChain documentation <https://python.langchain.com/docs/concepts/tools/#tool-artifacts>`__.
"""
@ -879,8 +871,8 @@ class ToolMessage(ToolOutputMixin):
Can be used as both property (``message.text``) and method (``message.text()``).
.. deprecated:: 0.4.0
Calling .text() as a method is deprecated. Use .text as a property instead.
This method will be removed in 2.0.0.
Calling ``.text()`` as a method is deprecated. Use ``.text`` as a property
instead. This method will be removed in 2.0.0.
"""
text_value = "".join(