The agent engineering platform.
Python agentsaiai-agentsanthropicchatgptdeepagentsenterpriseframeworkgeminigenerative-ailangchainlanggraphllmmultiagentopen-sourceopenaipydanticpythonragtypescript
feat: add agent name to `AIMessage` (#34254)
Sydney Runkled18cdc6f3259
diff --git a/libs/langchain_v1/langchain/agents/factory.py b/libs/langchain_v1/langchain/agents/factory.pyindex bc1bf632ca..43f7c3aba0 100644--- a/libs/langchain_v1/langchain/agents/factory.py+++ b/libs/langchain_v1/langchain/agents/factory.py@@ -1100,6 +1100,8 @@ def create_agent( # noqa: PLR0915messages = [request.system_message, *messages]output = model_.invoke(messages)+ if name:+ output.name = name# Handle model output to get messages and structured_responsehandled_output = _handle_model_output(output, effective_response_format)@@ -1153,6 +1155,8 @@ def create_agent( # noqa: PLR0915messages = [request.system_message, *messages]output = await model_.ainvoke(messages)+ if name:+ output.name = name# Handle model output to get messages and structured_responsehandled_output = _handle_model_output(output, effective_response_format)diff --git a/libs/langchain_v1/tests/unit_tests/agents/test_agent_name.py b/libs/langchain_v1/tests/unit_tests/agents/test_agent_name.pynew file mode 100644index 0000000000..07ebdbbf6a--- /dev/null+++ b/libs/langchain_v1/tests/unit_tests/agents/test_agent_name.py@@ -0,0 +1,99 @@+"""Test agent name parameter in create_agent.++This module tests that the name parameter correctly sets .name on AIMessage outputs.+"""++from __future__ import annotations++import pytest+from langchain_core.messages import AIMessage, HumanMessage+from langchain_core.tools import tool++from langchain.agents import create_agent++from .model import FakeToolCallingModel+++@tool+def simple_tool(x: int) -> str:+ """Simple tool for basic tests."""+ return f"Result: {x}"+++def test_agent_name_set_on_ai_message() -> None:+ """Test that agent name is set on AIMessage when name is provided."""+ agent = create_agent(+ model=FakeToolCallingModel(tool_calls=[[]]),+ name="test_agent",+ )++ result = agent.invoke({"messages": [HumanMessage("Hello")]})++ ai_messages = [m for m in result["messages"] if isinstance(m, AIMessage)]+ assert len(ai_messages) == 1+ assert ai_messages[0].name == "test_agent"+++def test_agent_name_not_set_when_none() -> None:+ """Test that AIMessage.name is not set when name is not provided."""+ agent = create_agent(+ model=FakeToolCallingModel(tool_calls=[[]]),+ )++ result = agent.invoke({"messages": [HumanMessage("Hello")]})++ ai_messages = [m for m in result["messages"] if isinstance(m, AIMessage)]+ assert len(ai_messages) == 1+ assert ai_messages[0].name is None+++def test_agent_name_on_multiple_iterations() -> None:+ """Test that agent name is set on all AIMessages in multi-turn conversation."""+ agent = create_agent(+ model=FakeToolCallingModel(+ tool_calls=[[{"args": {"x": 1}, "id": "call_1", "name": "simple_tool"}], []]+ ),+ tools=[simple_tool],+ name="multi_turn_agent",+ )++ result = agent.invoke({"messages": [HumanMessage("Call a tool")]})++ ai_messages = [m for m in result["messages"] if isinstance(m, AIMessage)]+ assert len(ai_messages) == 2+ for msg in ai_messages:+ assert msg.name == "multi_turn_agent"+++async def test_agent_name_async() -> None:+ """Test that agent name is set on AIMessage in async execution."""+ agent = create_agent(+ model=FakeToolCallingModel(tool_calls=[[]]),+ name="async_agent",+ )++ result = await agent.ainvoke({"messages": [HumanMessage("Hello async")]})++ ai_messages = [m for m in result["messages"] if isinstance(m, AIMessage)]+ assert len(ai_messages) == 1+ assert ai_messages[0].name == "async_agent"+++async def test_agent_name_async_multiple_iterations() -> None:+ """Test that agent name is set on all AIMessages in async multi-turn."""+ agent = create_agent(+ model=FakeToolCallingModel(+ tool_calls=[[{"args": {"x": 5}, "id": "call_1", "name": "simple_tool"}], []]+ ),+ tools=[simple_tool],+ name="async_multi_agent",+ )++ result = await agent.ainvoke({"messages": [HumanMessage("Call tool async")]})++ ai_messages = [m for m in result["messages"] if isinstance(m, AIMessage)]+ assert len(ai_messages) == 2+ for msg in ai_messages:+ assert msg.name == "async_multi_agent"diff --git a/libs/langchain_v1/uv.lock b/libs/langchain_v1/uv.lockindex 88f2545d6e..3155a9ab61 100644--- a/libs/langchain_v1/uv.lock+++ b/libs/langchain_v1/uv.lock@@ -2166,7 +2166,7 @@ wheels = [[[package]]name = "langchain-core"-version = "1.1.1"+version = "1.1.2"source = { editable = "../core" }dependencies = [{ name = "jsonpatch" },@@ -2347,7 +2347,7 @@ wheels = [[[package]]name = "langchain-openai"-version = "1.1.0"+version = "1.1.1"source = { editable = "../partners/openai" }dependencies = [{ name = "langchain-core" },