새 Context
모델 로딩 중...

Intent를 선택하거나 추가하세요

왼쪽 사이드바에서 Intent, Slot, Macro를 관리할 수 있습니다

Speech to Intent 문법 치트시트

빠른 참조

📝
Phrase (문구) 일반 텍스트 커피 한 잔 주세요
( )
Optional (선택) 있어도 되고 없어도 되는 (뜨거운) 커피
[ ]
Choice (택일) 여러 개 중 하나 선택 [커피, 라떼]
$
Slot (슬롯) 값을 추출하는 변수 $음료:주문음료
@
Macro (매크로) 재사용 가능한 문구 모음 @주문
📝

Phrase (문구)

사용자가 말하는 단어나 문장을 정확하게 매칭합니다.

단어1 단어2 ... 단어N
1 커피 한 잔 주세요 "커피 한 잔 주세요"라고 정확히 말해야 인식
( )

Optional (선택)

괄호 안의 내용은 말해도 되고 안 해도 됩니다.

(선택적 내용)
1 (뜨거운) 커피 주세요 "뜨거운 커피 주세요" 또는 "커피 주세요" 모두 인식
2 (@존칭) 커피 주세요 Optional 안에 매크로 사용 가능
Optional만 단독으로 사용할 수 없습니다. 반드시 하나 이상의 고정 문구가 필요합니다.
[ ]

Choice (택일)

대괄호 안에 콤마로 구분된 여러 항목 중 하나가 매칭됩니다.

[항목1, 항목2, ..., 항목N]
1 [커피, 라떼, 아메리카노] 주세요 "커피 주세요", "라떼 주세요", "아메리카노 주세요" 모두 인식
2 $동작:동작(@줘) "불 켜줘" 또는 "불 꺼" - 동작 슬롯으로 켜/꺼 추출
$

Slot (슬롯)

사용자가 말한 특정 값을 추출합니다. 슬롯 타입과 변수명으로 구성됩니다.

$슬롯타입:변수명
1 $음료:주문음료 주세요 음료 슬롯에 정의된 값 중 하나를 인식하고 추출
2 $크기:사이즈 $음료:음료 주세요 여러 슬롯을 동시에 사용
3 $음료:첫번째 하고 $음료:두번째 주세요 같은 슬롯 타입을 다른 변수명으로 여러 번 사용
인식 결과 예시
"톨 아메리카노 주세요" → { intent: "orderBeverage", 사이즈: "톨", 음료: "아메리카노" }
같은 슬롯 타입을 여러 번 사용할 경우, 변수명을 다르게 지정해야 합니다.
@

Macro (매크로)

슬롯과 비슷하지만 값을 추출하지 않습니다. 자주 사용되는 표현들을 묶어서 재사용합니다.

@매크로이름
1 커피 @주문 @주문에 정의된 값(주세요, 줘, 부탁해 등) 중 하나로 인식
인식 결과 예시
"커피 주세요" → { intent: "orderBeverage" }
"커피 줘" → { intent: "orderBeverage" }
n.

Built-in Slots (내장 슬롯)

기본 숫자 슬롯입니다. 더 구체적인 범위가 필요하면 숫자 슬롯을 직접 만드세요!

슬롯 타입 설명 예시 토큰 반환값
$n.고유어: 고유어 1~9 한, 두, 세, 네, 다섯... 1, 2, 3, 4, 5...
$n.한자어: 한자어 1~9 一, 二, 三, 四, 五... 1, 2, 3, 4, 5...
숫자 슬롯 직접 만들기: Slot 추가 시 "숫자" 유형을 선택하면
원하는 범위(min/max)와 숫자 체계(고유어/한자어)를 직접 지정할 수 있습니다!
예: 층(1~30, 한자어), 시(1~12, 고유어), 퍼센트(10~100, 한자어, step 10)
1 $n.고유어:수량 잔 주세요 "두 잔 주세요" → {수량: "2"}
2 $층:층 층 가줘 사용자 정의 숫자 슬롯 (1~30, 한자어)
3 $시:시 시 알람 사용자 정의 숫자 슬롯 (1~12, 고유어) → "일곱 시 알람"
한국어 숫자 규칙:
- 시/시간/개수: 고유어 → "한 시", "두 시간", "세 잔"
- 분/초/층: 한자어 → "30분", "10초", "5층"
- 숫자 슬롯을 직접 만들면 범위를 제한하여 "59시" 같은 비정상 값을 방지할 수 있습니다.

Built-in 조사 매크로

앞글자의 받침 유무에 따라 자동으로 적절한 조사가 선택됩니다.

매크로 설명 받침 있음 받침 없음
@은/는 주제 조사
@이/가 주격 조사
@을/를 목적격 조사
@과/와 접속 조사
@으로/로 방향 조사 으로
@아/야 호격 조사
1 $음료:음료@을/를 주세요 "아메리카노를 주세요", "라떼를 주세요" (받침 자동 판단)
2 $장소:장소@으로/로 가줘 "거실로 가줘", "안방으로 가줘"
참고: 조사 매크로는 바로 앞 글자의 받침을 자동으로 확인합니다.
키워드 생성 시 앞글자에 따라 적절한 조사가 자동 선택되어 효율적입니다.

Slot vs Macro 비교

구분 Slot ($) Macro (@)
문법 $타입:변수명 @이름
값 추출 ✅ 추출됨 ❌ 추출 안됨
용도 사용자 선택을 알아야 할 때 다양한 표현을 묶을 때

복합 예시

1 ($크기:사이즈) $음료:음료 (@단위) @주문 "톨 아메리카노 한 잔 주세요", "라떼 줘", "그란데 카페모카 두 잔 부탁해" 등
2 $장소:장소 불(좀) $동작:동작(@줘) "거실 불 켜줘", "침실 불 좀 꺼" → { 장소: "거실", 동작: "켜" }