> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xpertai.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 智能体中间件

## 概述

在每一步控制和自定义智能体执行。

中间件提供了一种更精细地控制智能体内部运行的方式。中间件适用于以下场景:

* 通过日志记录、分析和调试来跟踪智能体行为。
* 转换提示词、工具选择和输出格式。
* 添加重试、降级和提前终止逻辑。
* 应用速率限制、防护栏和个人身份信息检测。

## 智能体循环

核心智能体循环包括调用模型，让模型选择要执行的工具，然后在不再需要调用任何工具时结束：

<img src="https://mintcdn.com/xpertai/KjFE_c3zPYs4Z9GJ/public/img/ai/xpert/core_agent_loop.avif?fit=max&auto=format&n=KjFE_c3zPYs4Z9GJ&q=85&s=28f76e9cf0f026757990c1f70915c1ba" alt="Core agent loop diagram" width="300" height="268" data-path="public/img/ai/xpert/core_agent_loop.avif" />

中间件在每个步骤之前和之后都会暴露钩子：

<img src="https://mintcdn.com/xpertai/KjFE_c3zPYs4Z9GJ/public/img/ai/xpert/middleware_final.avif?fit=max&auto=format&n=KjFE_c3zPYs4Z9GJ&q=85&s=aac1bfb54ecd02ff52e293e6e60814c7" alt="Middleware flow diagram" width="500" height="560" data-path="public/img/ai/xpert/middleware_final.avif" />

## 中间件节点

在 XpertAI 中，智能体节点支持以可视化方式为 Agent 挂载多个中间件，用户可在右侧面板统一管理中间件的顺序与配置，实现与 LangChain 相同的可插拔 Middleware 架构。

<img src="https://mintcdn.com/xpertai/KjFE_c3zPYs4Z9GJ/public/img/ai/xpert/agent-middleware-nodes.png?fit=max&auto=format&n=KjFE_c3zPYs4Z9GJ&q=85&s=8383939aabe351cd01ada3468b3676bb" alt="Middleware node config" width="2410" height="1618" data-path="public/img/ai/xpert/agent-middleware-nodes.png" />

每个中间件都拥有独立的配置面板，可进入后调整其执行参数与行为，形成一条可视化、可配置、可扩展的智能体执行流水线。

<img src="https://mintcdn.com/xpertai/KjFE_c3zPYs4Z9GJ/public/img/ai/xpert/middleware-node-config.png?fit=max&auto=format&n=KjFE_c3zPYs4Z9GJ&q=85&s=dbcd182086fd29603746e650376d7fd8" alt="Middleware node config" width="2404" height="1616" data-path="public/img/ai/xpert/middleware-node-config.png" />

点击打开数字专家智能体的图按钮，可以看到中间件与智能体的执行顺序与循环关系：

<img src="https://mintcdn.com/xpertai/KjFE_c3zPYs4Z9GJ/public/img/ai/xpert/agent-middleware-graph.png?fit=max&auto=format&n=KjFE_c3zPYs4Z9GJ&q=85&s=80e6a0932c29823ac941029e31a1d5a5" alt="Middleware graph" width="2400" height="1116" data-path="public/img/ai/xpert/agent-middleware-graph.png" />
