Overview

Control and customize agent execution at every step 在每一步控制并定制代理执行

Middleware provides a way to more tightly control what happens inside the agent. Middleware is useful for the following: 中间件提供了一种更严格控制代理内部发生事情的方法。中间件适用于以下用途：

• Tracking agent behavior with logging, analytics, and debugging.通过日志记录、分析和调试跟踪代理行为。
• Transforming prompts, tool selection, and output formatting.转换提示、 工具选择和输出格式。
• Adding retries, fallbacks, and early termination logic.增加了重试 、 后备和提前终止逻辑。
• Applying rate limits, guardrails, and PII detection.
• 应用速率限制 、保护栏和个人身份识别（PII）检测 。

Add middleware by passing them to create_agent: 通过传递给 create_agent 添加中间件：

from langchain.agents import create_agent
from langchain.agents.middleware import SummarizationMiddleware, HumanInTheLoopMiddleware

agent = create_agent(
    model="gpt-4o",
    tools=[...],
    middleware=[
        SummarizationMiddleware(...),
        HumanInTheLoopMiddleware(...)
    ],
)

The agent loop

The core agent loop involves calling a model, letting it choose tools to execute, and then finishing when it calls no more tools: 核心代理循环包括调用模型，让模型选择执行工具，然后在调用工具不复存在时完成：

Middleware exposes hooks before and after each of those steps: 中间件在每一步之前和之后都暴露了钩子：

todo 中间件

为代理提供复杂多步骤任务的任务规划和跟踪能力。待办事项清单适用于以下用途：

• 复杂的多步骤任务需要在多个工具间协调。
• 运行长时间任务，进度可见性非常重要。

from langchain.agents import create_agent
from langchain.agents.middleware import TodoListMiddleware

agent = create_agent(
    model="gpt-4o",
    tools=[read_file, write_file, run_tests],
    middleware=[TodoListMiddleware()],
)

该中间件自动为代理提供 write_todos 工具和系统提示，以指导有效的任务规划。 write_todos其实是将todo_list 放到state中持久化上下文

Context editing 上下文编辑中间件

通过清除旧工具调用输出，在达到令牌限制时管理对话上下文，同时保留近期结果。这有助于在长时间对话中保持上下文窗口的可控性，尤其是涉及大量工具调用时。上下文编辑适用于以下情况：

• 长时间对话中，许多超出令牌限制的工具调用
• 通过移除不再相关的旧工具输出来降低token成本
• 只保持最近的n个工具的上下文

from langchain.agents import create_agent
from langchain.agents.middleware import ContextEditingMiddleware, ClearToolUsesEdit

agent = create_agent(
    model="gpt-4o",
    tools=[],
    middleware=[
        ContextEditingMiddleware(
            edits=[
                ClearToolUsesEdit(
                    trigger=100000,
                    keep=3,
                ),
            ],
        ),
    ],
)

ContextEditingMiddleware参数

参数	描述	默认
edits	ContextEdit 可应用策略列表	[ClearToolUsesEdit（）]
token_count_method	计数令牌的方法。选项：'approximate' or 'model'	”approximate”

ClearToolUsesEdit参数

参数	描述	默认
trigger	触发编辑的代币计数。当对话超过令牌数时，旧工具输出将被清除。	“100000”
clear_at_least	编辑执行时，最低可回收的代币数。如果设置为0，则可以清除所需的所有内容。	“0”
keep	必须保存的最新工具结果数量。这些永远不会被清除。	“3”
clear_tool_inputs	是否清除 AI 消息中的发起工具调用参数。当 True 时，工具调用参数被空对象取代。	“False”
exclude_tools	排除清除的工具名称列表。这些工具的输出永远不会被清除。	()
placeholder	插入占位符文本以表示已清除的工具输出。这替换了原来的工具信息内容。	“[cleared]”