langchain-dev-utils 1.2.8__tar.gz → 1.2.10__tar.gz

{langchain_dev_utils-1.2.8 → langchain_dev_utils-1.2.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langchain-dev-utils
-Version: 1.2.8
+Version: 1.2.10
 Summary: A practical utility library for LangChain and LangGraph development
 Project-URL: Source Code, https://github.com/TBice123123/langchain-dev-utils
 Project-URL: repository, https://github.com/TBice123123/langchain-dev-utils
@@ -192,52 +192,70 @@ def get_current_time() -> str:
 
 ### 4. **Agent Development**
 
-Includes the following features:
+Includes the following capabilities:
 
-- Predefined agent factory functions
-- Common middleware components
+- Multi-agent construction  
+- Commonly used middleware components  
 
-#### 4.1 Agent Factory Functions
+#### 4.1 Multi-Agent Construction
 
-In LangChain v1, the official `create_agent` function can be used to create a single agent; its `model` parameter accepts either a BaseChatModel instance or a specific string (when a string is provided, only models supported by `init_chat_model` are allowed). To extend the flexibility of specifying models via string, this library provides an equivalent `create_agent` function that lets you designate any model supported by `load_chat_model` (registration required beforehand).
+Wrapping an agent as a tool is a common implementation pattern in multi-agent systems, as elaborated in the official LangChain documentation. To support this pattern, this library provides a pre-built utility function `wrap_agent_as_tool`, which encapsulates an agent instance into a tool that can be invoked by other agents.
 
-Usage example:
+**Usage Example**:
 
 ```python
-from langchain_dev_utils.agents import create_agent
+import datetime
+from langchain_dev_utils.agents import create_agent, wrap_agent_as_tool
 from langchain.agents import AgentState
 
-agent = create_agent("vllm:qwen3-4b", tools=[get_current_time], name="time-agent")
-response = agent.invoke({"messages": [{"role": "user", "content": "What time is it?"}]})
+@tool
+def get_current_time() -> str:
+    """Get the current time"""
+    return datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+
+time_agent = create_agent("vllm:qwen3-4b", tools=[get_current_time], name="time-agent")
+call_time_agent_tool = wrap_agent_as_tool(time_agent)  
+
+agent = create_agent(
+    "vllm:qwen3-4b",
+    name="agent",
+    tools=[call_time_agent_tool],
+)
+response = agent.invoke(
+    {"messages": [{"role": "user", "content": "What time is it now?"}]}
+)
 print(response)
 ```
 
 #### 4.2 Middleware
 
-Provides some commonly used middleware components. Below, we illustrate with `ToolCallRepairMiddleware` and `PlanMiddleware`.
-
-`ToolCallRepairMiddleware` is used to repair `invalid_tool_calls` generated by large language models.
+Provides several commonly used middleware components. Below are examples using `ToolCallRepairMiddleware` and `PlanMiddleware`.
 
-`PlanMiddleware` is used for agent planning.
+- `ToolCallRepairMiddleware` automatically repairs malformed tool calls found in the model's `invalid_tool_calls` output.
+- `PlanMiddleware` enables task planning capabilities for agents.
 
 ```python
 from langchain_dev_utils.agents.middleware import (
-    ToolcallRepairMiddleware,
+    ToolCallRepairMiddleware,
     PlanMiddleware,
 )
 
 agent = create_agent(
     "vllm:qwen3-4b",
     name="plan-agent",
-    middleware=[ToolCallRepairMiddleware(), PlanMiddleware(
-        use_read_plan_tool=False
-    )]
+    middleware=[
+        ToolCallRepairMiddleware(),
+        PlanMiddleware(use_read_plan_tool=False)
+    ]
 )
-response = agent.invoke({"messages": [{"role": "user", "content": "Give me a travel plan to New York"}]})
+response = agent.invoke({"messages": [{"role": "user", "content": "Give me a travel plan for visiting New York."}]})
 print(response)
 ```
 
-**For more information about agent development and all built-in middleware, please refer to**: [Pre-built Agent Functions](https://tbice123123.github.io/langchain-dev-utils-docs/en/agent-development/prebuilt.html), [Middleware](https://tbice123123.github.io/langchain-dev-utils-docs/en/agent-development/middleware.html)
+**For more details on agent development and a complete list of built-in middleware, please refer to**:  
+[Multi-Agent Construction](https://tbice123123.github.io/langchain-dev-utils-docs/en/agent-development/multi-agent.html),  
+[Middleware](https://tbice123123.github.io/langchain-dev-utils-docs/en/agent-development/middleware.html)
+
 
 ### 5. **State Graph Orchestration**
 

{langchain_dev_utils-1.2.8 → langchain_dev_utils-1.2.10}/README.md

@@ -175,52 +175,70 @@ def get_current_time() -> str:
 
 ### 4. **Agent Development**
 
-Includes the following features:
+Includes the following capabilities:
 
-- Predefined agent factory functions
-- Common middleware components
+- Multi-agent construction  
+- Commonly used middleware components  
 
-#### 4.1 Agent Factory Functions
+#### 4.1 Multi-Agent Construction
 
-In LangChain v1, the official `create_agent` function can be used to create a single agent; its `model` parameter accepts either a BaseChatModel instance or a specific string (when a string is provided, only models supported by `init_chat_model` are allowed). To extend the flexibility of specifying models via string, this library provides an equivalent `create_agent` function that lets you designate any model supported by `load_chat_model` (registration required beforehand).
+Wrapping an agent as a tool is a common implementation pattern in multi-agent systems, as elaborated in the official LangChain documentation. To support this pattern, this library provides a pre-built utility function `wrap_agent_as_tool`, which encapsulates an agent instance into a tool that can be invoked by other agents.
 
-Usage example:
+**Usage Example**:
 
 ```python
-from langchain_dev_utils.agents import create_agent
+import datetime
+from langchain_dev_utils.agents import create_agent, wrap_agent_as_tool
 from langchain.agents import AgentState
 
-agent = create_agent("vllm:qwen3-4b", tools=[get_current_time], name="time-agent")
-response = agent.invoke({"messages": [{"role": "user", "content": "What time is it?"}]})
+@tool
+def get_current_time() -> str:
+    """Get the current time"""
+    return datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+
+time_agent = create_agent("vllm:qwen3-4b", tools=[get_current_time], name="time-agent")
+call_time_agent_tool = wrap_agent_as_tool(time_agent)  
+
+agent = create_agent(
+    "vllm:qwen3-4b",
+    name="agent",
+    tools=[call_time_agent_tool],
+)
+response = agent.invoke(
+    {"messages": [{"role": "user", "content": "What time is it now?"}]}
+)
 print(response)
 ```
 
 #### 4.2 Middleware
 
-Provides some commonly used middleware components. Below, we illustrate with `ToolCallRepairMiddleware` and `PlanMiddleware`.
-
-`ToolCallRepairMiddleware` is used to repair `invalid_tool_calls` generated by large language models.
+Provides several commonly used middleware components. Below are examples using `ToolCallRepairMiddleware` and `PlanMiddleware`.
 
-`PlanMiddleware` is used for agent planning.
+- `ToolCallRepairMiddleware` automatically repairs malformed tool calls found in the model's `invalid_tool_calls` output.
+- `PlanMiddleware` enables task planning capabilities for agents.
 
 ```python
 from langchain_dev_utils.agents.middleware import (
-    ToolcallRepairMiddleware,
+    ToolCallRepairMiddleware,
     PlanMiddleware,
 )
 
 agent = create_agent(
     "vllm:qwen3-4b",
     name="plan-agent",
-    middleware=[ToolCallRepairMiddleware(), PlanMiddleware(
-        use_read_plan_tool=False
-    )]
+    middleware=[
+        ToolCallRepairMiddleware(),
+        PlanMiddleware(use_read_plan_tool=False)
+    ]
 )
-response = agent.invoke({"messages": [{"role": "user", "content": "Give me a travel plan to New York"}]})
+response = agent.invoke({"messages": [{"role": "user", "content": "Give me a travel plan for visiting New York."}]})
 print(response)
 ```
 
-**For more information about agent development and all built-in middleware, please refer to**: [Pre-built Agent Functions](https://tbice123123.github.io/langchain-dev-utils-docs/en/agent-development/prebuilt.html), [Middleware](https://tbice123123.github.io/langchain-dev-utils-docs/en/agent-development/middleware.html)
+**For more details on agent development and a complete list of built-in middleware, please refer to**:  
+[Multi-Agent Construction](https://tbice123123.github.io/langchain-dev-utils-docs/en/agent-development/multi-agent.html),  
+[Middleware](https://tbice123123.github.io/langchain-dev-utils-docs/en/agent-development/middleware.html)
+
 
 ### 5. **State Graph Orchestration**
 

{langchain_dev_utils-1.2.8 → langchain_dev_utils-1.2.10}/README_cn.md

@@ -176,21 +176,36 @@ def get_current_time() -> str:
 
 包含以下功能：
 
-- 预设的智能体工厂函数
+- 多智能体构建
 - 常用的中间件组件
 
-#### 4.1 智能体工厂函数
+#### 4.1 多智能体构建
 
-LangChain v1 版本中，官方提供的 `create_agent` 函数可以用于创建单智能体，其中 model 参数支持传入 BaseChatModel 实例或特定字符串（当传入字符串时，仅限于 `init_chat_model` 支持的模型）。为扩展字符串指定模型的灵活性，本库提供了功能相同的 `create_agent` 函数，使您能够通过字符串指定 `load_chat_model` 支持的模型（需要提前注册）。
+将智能体封装为工具是多智能体系统中的一种常见实现模式，LangChain 官方文档对此有详细阐述。为此，本库提供了预构建函数`wrap_agent_as_tool` 来实现此模式，该函数能够将一个智能体实例封装成一个可供其它智能体调用的工具。
 
 使用示例：
 
 ```python
-from langchain_dev_utils.agents import create_agent
+import datetime
+from langchain_dev_utils.agents import create_agent, wrap_agent_as_tool
 from langchain.agents import AgentState
 
-agent = create_agent("vllm:qwen3-4b", tools=[get_current_time], name="time-agent")
-response = agent.invoke({"messages": [{"role": "user", "content": "现在几点了？"}]})
+@tool
+def get_current_time() -> str:
+    """获取当前时间"""
+    return datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+
+time_agent = create_agent("vllm:qwen3-4b", tools=[get_current_time], name="time-agent")
+call_time_agent_tool = wrap_agent_as_tool(time_agent)  
+
+agent = create_agent(
+    "vllm:qwen3-4b",
+    name="agent",
+    tools=[call_time_agent_tool],
+)
+response = agent.invoke(
+    {"messages": [{"role": "user", "content": "现在几点了？"}]}
+)
 print(response)
 ```
 
@@ -219,7 +234,7 @@ response = agent.invoke({"messages": [{"role": "user", "content": "给我一个
 print(response)
 ```
 
-**对于更多关于智能体开发以及所有的内置中间件的相关介绍，请参考**: [预构建智能体函数](https://tbice123123.github.io/langchain-dev-utils-docs/zh/agent-development/prebuilt.html),[中间件](https://tbice123123.github.io/langchain-dev-utils-docs/zh/agent-development/middleware.html)
+**对于更多关于智能体开发以及所有的内置中间件的相关介绍，请参考**: [多智能体构建](https://tbice123123.github.io/langchain-dev-utils-docs/zh/agent-development/multi-agent.html),[中间件](https://tbice123123.github.io/langchain-dev-utils-docs/zh/agent-development/middleware.html)
 
 ### 5. **状态图编排**
 

{langchain_dev_utils-1.2.8 → langchain_dev_utils-1.2.10}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "langchain-dev-utils"
-version = "1.2.8"
+version = "1.2.10"
 description = "A practical utility library for LangChain and LangGraph development"
 readme = "README.md"
 authors = [{ name = "tiebingice", email = "tiebingice123@outlook.com" }]

langchain_dev_utils-1.2.10/src/langchain_dev_utils/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.2.10"