본문으로 건너뛰기

유니코드노멀라이저

그만큼UnicodeNormalizer입력 프로세서메시지가 언어 Model로 전송되기 전에 일관된 형식을 보장하고 잠재적으로 문제가 있는 문자를 제거하기 위해 유니코드 텍스트를 정규화합니다. 이 프로세서는 유니코드 표현을 처리하고 제어 문자를 제거합니다. 또한 공백 형식도 표준화합니다.

사용예
사용예에 대한 직접 링크

import { UnicodeNormalizer } from '@mastra/core/processors'

const processor = new UnicodeNormalizer({
stripControlChars: true,
collapseWhitespace: true,
})

생성자 매개변수
생성자 매개변수에 대한 직접 링크

options?:

Options
Unicode 텍스트 정규화의 구성 옵션입니다
Options

stripControlChars?:

boolean
제어 문자를 제거할지 여부입니다. 활성화하면 , , 을 제외한 제어 문자를 제거합니다

preserveEmojis?:

boolean
이모지를 보존할지 여부입니다. 비활성화하면 제어 문자가 포함된 이모지가 제거될 수 있습니다

collapseWhitespace?:

boolean
연속된 공백 문자를 하나로 축소할지 여부입니다. 활성화하면 여러 개의 공백, 탭, 줄 바꿈을 각각 하나로 축소합니다

trim?:

boolean
앞뒤 공백을 제거할지 여부입니다

보고
보고에 대한 직접 링크

id:

string
'unicode-normalizer'로 설정된 프로세서 식별자입니다

name?:

string
선택적 프로세서 표시 이름입니다

processInput:

(args: { messages: MastraDBMessage[]; abort: (reason?: string) => never }) => MastraDBMessage[]
Unicode 텍스트를 정규화하도록 입력 메시지를 처리합니다

확장된 사용 예
확장된 사용 예에 대한 직접 링크

src/mastra/agents/normalized-agent.ts
import { Agent } from '@mastra/core/agent'
import { UnicodeNormalizer } from '@mastra/core/processors'

export const agent = new Agent({
id: 'normalized-agent',
name: 'normalized-agent',
instructions: 'You are a helpful assistant',
model: 'openai/gpt-5.6-sol',
inputProcessors: [
new UnicodeNormalizer({
stripControlChars: true,
preserveEmojis: true,
collapseWhitespace: true,
trim: true,
}),
],
})