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

# 유니코드노멀라이저

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

## 사용예

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

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

## 생성자 매개변수

**options** (`Options`): Unicode 텍스트 정규화의 구성 옵션입니다

**options.stripControlChars** (`boolean`): 제어 문자를 제거할지 여부입니다. 활성화하면 , , 을 제외한 제어 문자를 제거합니다

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

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

**options.trim** (`boolean`): 앞뒤 공백을 제거할지 여부입니다

## 보고

**id** (`string`): 'unicode-normalizer'로 설정된 프로세서 식별자입니다

**name** (`string`): 선택적 프로세서 표시 이름입니다

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

## 확장된 사용 예

```typescript
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,
    }),
  ],
})
```

## 관련된

- [난간](https://mastra.zisheng.pro/ko/docs/agents/guardrails)