> Discover all available pages from the documentation index: https://mastra.zisheng.pro/zh-HK/llms.txt

# 處理器

檔案式 Agent 會在其 `processors/` 目錄中探索[處理器](https://mastra.zisheng.pro/zh-HK/docs/agents/processors)。本頁說明檔案式慣例；如需了解內置處理器、自訂處理器、串流行為及進階模式，請參閱處理器指南。

`processors/input/` 下的檔案會在訊息送達模型前執行。`processors/output/` 下的檔案會在模型回應後執行。每個檔案都會預設匯出一個 [`Processor`](https://mastra.zisheng.pro/zh-HK/reference/processors/processor-interface)，而檔案名稱會成為其探索鍵。

## 快速開始

將處理器檔案放在 `processors/input/` 下，即可加入輸入處理器：

```typescript
import { PIIDetector } from '@mastra/core/processors'

export default new PIIDetector({
  strategy: 'block',
})
```

此處理器會在用戶訊息送達模型前執行。

## 加入輸出處理器

輸出處理器適合在傳回模型回應前篩選或轉換回應。以下範例會遮蔽最終回應中的 PII。

```typescript
import { PIIDetector } from '@mastra/core/processors'

export default new PIIDetector({
  strategy: 'redact',
})
```

## 次序

探索到的處理器會加入在 [`config.ts`](https://mastra.zisheng.pro/zh-HK/reference/file-based-agents/config) 中定義的所有處理器之後。換言之，config 處理器會先執行。

```text
config.inputProcessors → processors/input/* → model
model → config.outputProcessors → processors/output/* → response
```

如果 `config.inputProcessors` 或 `config.outputProcessors` 是函數，系統會忽略該類型已探索到的處理器並顯示警告，因為函數值處理器無法以靜態方式合併。

## 與 config 的優先次序

如處理器需要在執行階段建立或由多個 Agent 共用，請使用 `config.ts`。如屬靜態、每個 Agent 專用，並應與 Agent 一併審閱的處理器，請使用檔案式處理器。

優先次序如下：

1. 函數值 `config.inputProcessors` 或 `config.outputProcessors`
2. 陣列值 `config.inputProcessors` 或 `config.outputProcessors`
3. 在 `processors/input/` 或 `processors/output/` 下探索到的檔案

如需完整介面，請參閱 [`Processor` 參考](https://mastra.zisheng.pro/zh-HK/reference/processors/processor-interface)。