Processor

Processor 接口已更新为使用一致的命名模式和数据库消息类型。

已变更

Processor 配置从 name 改为 id

Processor 现在必须提供 id 字段，而不再要求 name。name 字段现在是可选的。此变更与 scorer 和 Agent 等其他 Mastra 实体保持一致。

迁移时，请更新 Processor 定义，将 id 作为必填字段。

  import type { InputProcessor } from '@mastra/core/processors';

  const processor: InputProcessor = {
-   name: 'my-processor',
+   id: 'my-processor',
+   name: 'My Processor', // optional
    processInput: async ({ messages }) => {
      // ...
    },
  };

Processor 消息类型从 MastraMessageV2 改为 MastraDBMessage

Processor 消息类型已从 MastraMessageV2 改为 MastraDBMessage。Processor 和 scorer 现在使用数据库消息格式及其类型。

迁移时，请更新 Processor 消息类型的导入和用法。

  import type { InputProcessor } from '@mastra/core/processors';
- import type { MastraMessageV2 } from '@mastra/core/agent';
+ import type { MastraDBMessage } from '@mastra/core/agent';

  const processor: InputProcessor = {
    id: 'my-processor',
-   processInput: async ({ messages }: { messages: MastraMessageV2[] }) => {
+   processInput: async ({ messages }: { messages: MastraDBMessage[] }) => {
      // ...
    },
  };

已移除

已弃用的输入 Processor 导出

@mastra/core/agent/input-processors/processors 中已移除包含内置 Processor 在内的已弃用输入 Processor 导出。请改用 @mastra/core/processors。此变更将 Processor 类型统一到 Processor 接口下。

如果使用了 InputProcessor，请将其替换为实现 processInput 函数的 Processor。

- import { InputProcessor, ModerationProcessor } from '@mastra/core/agent/input-processors/processors';
+ import { Processor, ModerationProcessor } from '@mastra/core/processors';

Memory Processor 导出迁移到 core

@mastra/memory/processors 导出已移除。所有 Processor 现在都从 @mastra/core/processors 导出。此变更将所有 Processor 导出集中在同一位置。

迁移时，请将导入路径从 @mastra/memory/processors 更新为 @mastra/core/processors。

- import { TokenLimiter, ToolCallFilter } from '@mastra/memory/processors';
+ import { TokenLimiter, ToolCallFilter } from '@mastra/core/processors';