处理器
🌐 Processors
处理器接口已更新,以使用一致的命名模式和数据库消息类型。
🌐 Processor interfaces have been updated to use consistent naming patterns and database message types.
已更改Direct link to 已更改
🌐 Changed
处理器配置从 name 更改为 idDirect link to processor-configuration-from-name-to-id
🌐 Processor configuration from name to id
处理器现在需要 id 字段,而不是 name。name 字段现在是可选的。此更改与其他 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 }) => {
// ...
},
};
MastraMessageV2 到 MastraDBMessage 的处理器消息类型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';