The agent engineering platform.
Python agentsaiai-agentsanthropicchatgptdeepagentsenterpriseframeworkgeminigenerative-ailangchainlanggraphllmmultiagentopen-sourceopenaipydanticpythonragtypescript
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.pyindex 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"] = namediff --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.pyindex 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 jsonfrom typing import TYPE_CHECKING, Annotated, Any+from unittest.mock import MagicMock+from langchain_core.callbacks import BaseCallbackHandlerfrom langchain_core.messages import HumanMessage, ToolMessagefrom langchain_core.tools import toolfrom langgraph.prebuilt import InjectedStorefrom langgraph.store.memory import InMemoryStore+from langsmith import Client+from langsmith.run_helpers import tracing_contextfrom langchain.agents import create_agentfrom 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 writableassert injected_data["store"] is not Noneassert 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.lockindex 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]]