Skip to content

The agent engineering platform.

chore(langchain): update docs on error handling for json schema (#39632)

ccurmea2f02abedb27
diff --git a/libs/langchain_v1/langchain/agents/structured_output.py b/libs/langchain_v1/langchain/agents/structured_output.py
index a482951b9d..d4a6bb3f89 100644
--- a/libs/langchain_v1/langchain/agents/structured_output.py
+++ b/libs/langchain_v1/langchain/agents/structured_output.py
@@ -219,6 +219,15 @@ class ToolStrategy(Generic[SchemaT]):
message
- `Callable[[Exception], str]`: Custom function that returns error message
- `False`: No retry, let exceptions propagate
+
+ !!! warning "Raw JSON schema dicts are not validated"
+ When `schema` is a raw JSON schema `dict` (as opposed to a Pydantic model,
+ `dataclass`, or `TypedDict`), the model's tool-call arguments are returned
+ **as-is without validation** against the schema.
+
+ As a result, `handle_errors` is effectively inert for dict schemas. To get
+ validation and automatic retries, express the schema as a Pydantic model,
+ `dataclass`, or `TypedDict` instead.
"""
def __init__(