Skip to main content

处理器

🌐 Processors

处理器接口已更新,以使用一致的命名模式和数据库消息类型。

🌐 Processor interfaces have been updated to use consistent naming patterns and database message types.

已更改
Direct link to 已更改

🌐 Changed

处理器配置从 name 更改为 id
Direct link to processor-configuration-from-name-to-id

🌐 Processor configuration from name to id

处理器现在需要 id 字段,而不是 namename 字段现在是可选的。此更改与其他 Mastra 实体(如评分器和代理)保持一致。

🌐 Processors now require an id field instead of name. The name field is now optional. This change provides consistency with other Mastra entities like scorers and agents.

要迁移,请更新处理器定义,将 id 作为必填字段。

🌐 To migrate, update processor definitions to use id as the required field.

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

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

MastraMessageV2MastraDBMessage 的处理器消息类型
Direct link to processor-message-types-from-mastramessagev2-to-mastradbmessage

🌐 Processor message types from MastraMessageV2 to MastraDBMessage

处理器消息类型已从 MastraMessageV2 变更为 MastraDBMessage。此更改使其与评分器配置保持一致,并通过与数据库消息格式对齐,提高了类型安全性。

🌐 Processor message types have changed from MastraMessageV2 to MastraDBMessage. This change provides consistency with scorer configuration and better type safety by aligning with the database message format.

要进行迁移,请更新处理器消息类型的导入和使用方式。

🌐 To migrate, update processor message type imports and usage.

  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[] }) => {
// ...
},
};

已移除
Direct link to 已移除

🌐 Removed

已弃用的输入处理器导出
Direct link to 已弃用的输入处理器导出

🌐 Deprecated input processor exports

已弃用的输入处理器导出,包括内置处理器,已从 @mastra/core/agent/input-processors/processors 中移除。请改用 @mastra/core/processors。此更改将处理器类型整合到统一的 Processor 接口下。

🌐 Deprecated input-processor exports which include the built-in processors have been removed from @mastra/core/agent/input-processors/processors. Use @mastra/core/processors instead. This change consolidates processor types under the unified Processor interface.

如果你使用过 InputProcessor,请将其替换为实现了 processInput 功能的 Processor

🌐 If you have used InputProcessor, replace it with Processor which implements a processInput function.

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

内存处理器导出已移动到核心
Direct link to 内存处理器导出已移动到核心

🌐 Memory processor exports moved to core

@mastra/memory/processors 导出已被移除。现在所有处理器都从 @mastra/core/processors 导出。此更改将所有处理器导出整合到一个位置。

🌐 The @mastra/memory/processors export has been removed. All processors are now exported from @mastra/core/processors. This change consolidates all processor exports in a single location.

要进行迁移,请将你的导入路径从 @mastra/memory/processors 更新为 @mastra/core/processors

🌐 To migrate, update your import paths from @mastra/memory/processors to @mastra/core/processors.

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