> For the complete documentation index, see [llms.txt](https://docs.neuron-ai.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.neuron-ai.dev/neuron-v3-zh/gong-zuo-liu/middleware.md).

# 中间件

在每一步控制并自定义 Agent 执行

### 什么是中间件

中间件提供了一种挂钩工作流执行的方式，因此也适用于 Agent 和 RAG，因为它们本质上也是工作流。

核心的工作流执行涉及根据其他节点返回的事件调用节点。中间件暴露了钩子，以便在以下时机介入 `到达` 和 `之后` 节点的执行：

<figure><img src="https://99736354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGHx4l2LknIex7vFIUg1R%2Fuploads%2FPhEdX3C3TkEM9TtU7lN9%2Fmiddleware.png?alt=media&amp;token=d9a13cda-5e25-475f-b9b9-385bf69c3f52" alt=""><figcaption></figcaption></figure>

### 中间件能做什么？

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>控制</strong></td><td>转换提示词、工具选择和输出格式。</td></tr><tr><td><strong>护栏</strong></td><td>添加重试、速率限制，实现防护规则、提示拒绝。</td></tr><tr><td><strong>注入</strong></td><td>中间件可以按需向节点或后续中间件提供资源。</td></tr></tbody></table>

### 创建中间件

你可以使用下面的命令创建一个中间件类：

{% tabs %}
{% tab title="Unix" %}

```bash
vendor/bin/neuron make:middleware CustomMiddleware
```

{% endtab %}

{% tab title="Windows" %}

```powershell
.\vendor\bin\neuron make:middleware CustomMiddleware
```

{% endtab %}
{% endtabs %}

你的项目中将会创建一个带有默认中间件结构的新类：

```php
<?php

namespace App\Neuron\Middleware;

class CustomMiddleware implements WorkflowMiddleware
{
    /**
     * 在节点运行前执行。
     */
    public function before(
        NodeInterface $node, 
        Event $event, 
        WorkflowState $state, 
        WorkflowResources $resources,
    ): void {
        // ...
    }
    
    /**
     * 在节点运行后执行。
     */
    public function after(
        NodeInterface $node, 
        Event $event, 
        WorkflowState $state, 
        WorkflowResources $resources,
    ): void {
        // ...
    }
}
```

### 注册中间件

如果你想将中间件分配给特定节点，你可以在定义工作流时重写 `middleware` 方法：

```php
class MyWorkflow extends Workflow
{
    /**
     * 定义节点中间件。
     */
    protected function middleware(): array
    {
        return [
            NodeOne::class => new CustomMiddleware(),
        ];
    }
}
```

你也可以通过定义一个数组，将多个中间件分配给一个节点：

```php
class MyWorkflow extends Workflow
{
    /**
     * 定义节点中间件。
     */
    protected function middleware(): array
    {
        return [
            NodeOne::class => [
                new CustomMiddleware(),
                new AnotherMiddleware(),
            ]
        ];
    }
}
```

### 全局中间件

如果你希望中间件在每个节点之前和之后运行，可以将其附加到工作流中的全局中间件栈：

```php
class MyWorkflow extends Workflow
{
    /**
     * 定义全局中间件。
     */
    protected function globalMiddleware(): array
    {
        return [
            new CustomMiddleware(),
        ];
    }
}
```

### 示例

Neuron 提供了适用于常见用例的预构建中间件，例如工具审批或上下文摘要。你可以在 Agent 部分查看它们：

{% content-ref url="/pages/9ea2066a9f786ede6683c1553ff65e839e3105e5" %}
[中间件](https://docs.neuron-ai.dev/neuron-v3-zh/dai-li/middleware.md)
{% endcontent-ref %}
