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

# Processor

檔案式 Agent 會從 `processors/` 目錄探索 [processor](https://mastra.zisheng.pro/zh-TW/docs/agents/processors)。本頁說明檔案式慣例；若要了解內建 processor、自訂 processor、串流行為與進階模式，請參閱 processor 指南。

`processors/input/` 下的檔案會在訊息送達模型前執行。`processors/output/` 下的檔案則會在模型回應後執行。每個檔案會 default export 一個 [`Processor`](https://mastra.zisheng.pro/zh-TW/reference/processors/processor-interface)，而檔名會成為其探索 key。

## 快速開始

將 processor 檔案放在 `processors/input/` 下，以新增輸入 processor：

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

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

此 processor 會在使用者訊息送達模型前執行。

## 新增輸出 processor

輸出 processor 適合在模型回應傳回前進行篩選或轉換。以下範例會從最終回應中遮蔽 PII。

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

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

## 順序

探索到的 processor 會加在 [`config.ts`](https://mastra.zisheng.pro/zh-TW/reference/file-based-agents/config) 中定義的 processor 之後。也就是說，config processor 會先執行。

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

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

## 與 config 的優先順序

對於需要在執行階段建立或由多個 Agent 共用的 processor，請使用 `config.ts`。對於應與 Agent 一起檢閱的靜態、各 Agent 專用 processor，請使用檔案式 processor。

優先順序如下：

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

完整 interface 請參閱 [`Processor` 參考文件](https://mastra.zisheng.pro/zh-TW/reference/processors/processor-interface)。