Skip to content

The agent engineering platform.

feat(langchain): `ls_agent_type` tag on `create_agent` calls (#36774)

Jacob Leeee95ad6907f5
diff --git a/libs/langchain_v1/langchain/agents/factory.py b/libs/langchain_v1/langchain/agents/factory.py
index a72ea8d549..ba4a1dc8f8 100644
--- a/libs/langchain_v1/langchain/agents/factory.py
+++ b/libs/langchain_v1/langchain/agents/factory.py
@@ -1647,7 +1647,12 @@ def create_agent(
# Set recursion limit to 9_999
# https://github.com/langchain-ai/langgraph/issues/7313
- config: RunnableConfig = {"recursion_limit": 9_999}
+ config: RunnableConfig = {
+ "recursion_limit": 9_999,
+ "configurable": {
+ "ls_agent_type": "root",
+ },
+ }
config["metadata"] = {"ls_integration": "langchain_create_agent"}
if name:
config["metadata"]["lc_agent_name"] = name
diff --git a/libs/langchain_v1/tests/unit_tests/agents/test_injected_runtime_create_agent.py b/libs/langchain_v1/tests/unit_tests/agents/test_injected_runtime_create_agent.py
index ff8c88788c..c56aa5e95a 100644
--- a/libs/langchain_v1/tests/unit_tests/agents/test_injected_runtime_create_agent.py
+++ b/libs/langchain_v1/tests/unit_tests/agents/test_injected_runtime_create_agent.py
@@ -16,12 +16,17 @@ configurations.
from __future__ import annotations
+import json
from typing import TYPE_CHECKING, Annotated, Any
+from unittest.mock import MagicMock
+from langchain_core.callbacks import BaseCallbackHandler
from langchain_core.messages import HumanMessage, ToolMessage
from langchain_core.tools import tool
from langgraph.prebuilt import InjectedStore
from langgraph.store.memory import InMemoryStore
+from langsmith import Client
+from langsmith.run_helpers import tracing_context
from langchain.agents import create_agent
from langchain.agents.middleware.types import AgentMiddleware, AgentState
@@ -842,3 +847,109 @@ async def test_combined_injected_state_runtime_store_async() -> None:
# Verify store was injected and writable
assert injected_data["store"] is not None
assert injected_data["store_write_success"] is True
+
+
+def test_ls_agent_type_is_trace_only_metadata() -> None:
+ """Test that ls_agent_type is added to metadata on tracing only, not in streamed chunks."""
+ # Capture metadata from regular callback handler (simulates streamed metadata)
+ captured_callback_metadata: list[dict[str, Any]] = []
+
+ class CaptureHandler(BaseCallbackHandler):
+ def on_chain_start(
+ self,
+ serialized: dict[str, Any],
+ inputs: dict[str, Any],
+ *,
+ run_id: str,
+ parent_run_id: str | None = None,
+ tags: list[str] | None = None,
+ metadata: dict[str, Any] | None = None,
+ **kwargs: Any,
+ ) -> None:
+ captured_callback_metadata.append({"tags": tags, "metadata": metadata})
+
+ # Create a mock client to capture what gets sent to LangSmith
+ mock_session = MagicMock()
+ mock_client = Client(session=mock_session, api_key="test", auto_batch_tracing=False)
+
+ agent = create_agent(
+ model=FakeToolCallingModel(tool_calls=[[], []]),
+ tools=[],
+ system_prompt="You are a helpful assistant.",
+ )
+
+ # Use tracing_context to enable tracing with the mock client
+ with tracing_context(client=mock_client, enabled=True):
+ agent.invoke(
+ {"messages": [HumanMessage("hi?")]},
+ config={"callbacks": [CaptureHandler()]},
+ )
+
+ # Verify that ls_agent_type is NOT in the regular callback metadata
+ # (it should only go to the tracer via langsmith_inheritable_metadata)
+ assert len(captured_callback_metadata) > 0
+ for captured in captured_callback_metadata:
+ metadata = captured.get("metadata") or {}
+ assert metadata.get("ls_agent_type") is None, (
+ f"ls_agent_type should not be in callback metadata, but got: {metadata}"
+ )
+
+ # Verify that ls_agent_type IS in the tracer metadata (sent to LangSmith)
+ # Get the POST requests to the LangSmith API
+ posts = []
+ for call in mock_session.request.mock_calls:
+ if call.args and call.args[0] == "POST":
+ body = json.loads(call.kwargs["data"])
+ if "post" in body:
+ posts.extend(body["post"])
+ else:
+ posts.append(body)
+
+ assert len(posts) >= 1
+ # Find the root run (the agent execution)
+ root_post = posts[0]
+ metadata = root_post.get("extra", {}).get("metadata", {})
+ assert metadata.get("ls_agent_type") == "root", (
+ f"ls_agent_type should be 'root' in tracer metadata, but got: {metadata}"
+ )
+
+
+def test_ls_agent_type_is_overridable() -> None:
+ """Test that ls_agent_type can be overridden via configurable in invoke config."""
+ # Create a mock client to capture what gets sent to LangSmith
+ mock_session = MagicMock()
+ mock_client = Client(session=mock_session, api_key="test", auto_batch_tracing=False)
+
+ agent = create_agent(
+ model=FakeToolCallingModel(tool_calls=[[], []]),
+ tools=[],
+ system_prompt="You are a helpful assistant.",
+ )
+
+ # Use tracing_context to enable tracing with the mock client
+ with tracing_context(client=mock_client, enabled=True):
+ agent.invoke(
+ {"messages": [HumanMessage("hi?")]},
+ config={"configurable": {"ls_agent_type": "subagent", "custom_key": "custom_value"}},
+ )
+
+ # Verify that ls_agent_type is overridden and configurable is merged in the tracer metadata
+ posts = []
+ for call in mock_session.request.mock_calls:
+ if call.args and call.args[0] == "POST":
+ body = json.loads(call.kwargs["data"])
+ if "post" in body:
+ posts.extend(body["post"])
+ else:
+ posts.append(body)
+
+ assert len(posts) >= 1
+ root_post = posts[0]
+ metadata = root_post.get("extra", {}).get("metadata", {})
+ assert metadata.get("ls_agent_type") == "subagent", (
+ f"ls_agent_type should be 'subagent' in tracer metadata, but got: {metadata}"
+ )
+ # Verify that the additional configurable key is merged into metadata
+ assert metadata.get("custom_key") == "custom_value", (
+ f"custom_key should be 'custom_value' in tracer metadata, but got: {metadata}"
+ )
diff --git a/libs/langchain_v1/uv.lock b/libs/langchain_v1/uv.lock
index 14c260ae7e..7fe9065f6d 100644
--- a/libs/langchain_v1/uv.lock
+++ b/libs/langchain_v1/uv.lock
@@ -2589,7 +2589,7 @@ wheels = [
[[package]]
name = "langgraph"
-version = "1.1.5"
+version = "1.1.7"
source = { registry = "https://pypi.org/simple" }
dependencies = [
{ name = "langchain-core" },
@@ -2599,9 +2599,9 @@ dependencies = [
{ name = "pydantic" },
{ name = "xxhash" },
]
-sdist = { url = "https://files.pythonhosted.org/packages/a4/8a/47b983e33d3afc8c2c2385d2d8f3731ddfb5cb08e88f307f75105252a94c/langgraph-1.1.5.tar.gz", hash = "sha256:24b85d2d40cd002766d489e76f18027f947e4151366ac7ed97bab030ce50e494", size = 548492, upload-time = "2026-04-03T14:12:33.14Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/ce/ab/3398c9e564a5037a3b657b87af5ffa48af7704143e225d4c2a5b0cc3617e/langgraph-1.1.7.tar.gz", hash = "sha256:92e0d26c2b05972fce8a9a604dcf9b4e2348300e953e24bd6c3188e91da6ceca", size = 559971, upload-time = "2026-04-17T15:24:46.994Z" }
wheels = [
- { url = "https://files.pythonhosted.org/packages/bd/6a/542bb56c8270d3df858285be138aec5e292b4e43dadb6b0b6fe051f535c1/langgraph-1.1.5-py3-none-any.whl", hash = "sha256:cb25c20d135167837951906c0feeb26c91c733bd5001a920c4cb1ffb92a1097c", size = 169354, upload-time = "2026-04-03T14:12:31.879Z" },
+ { url = "https://files.pythonhosted.org/packages/a8/0a/d742418bad268b122fbc9536e07f039f930d59f9c65acad07f2e25275ef9/langgraph-1.1.7-py3-none-any.whl", hash = "sha256:37fe5357508080fe0cda4dcf49735d32439eb211ef48ad09a097ee489d78d43b", size = 173768, upload-time = "2026-04-17T15:24:45.287Z" },
]
[[package]]