M2-3. 토픽 — 작성 캔버스에서 대화 대본 만들기

한 줄 요약 — 토픽은 대화의 한 구간을 정의하는 대본입니다. 작성 캔버스에서 트리거 + 노드 (메시지·질문·조건·도구)로 그리며, YAML 코드 편집기로 복사·재사용할 수 있습니다.

1. 토픽이란

토픽(topic)은 사용자와 에이전트 간 대화의 한 구간입니다. 작성 캔버스(authoring canvas) 위에 하나 이상의 노드(node) 를 배치해 대화 경로를 결정합니다 — 각 노드는 메시지 발송, 질문, 조건 분기 같은 동작을 수행합니다.

토픽 종류	설명
시스템 토픽	대화 시작·폴백·종료·사람 연결 등 필수 동작 — 생성 불가·삭제 불가(끄기 가능)·수정 가능
커스텀 토픽	메이커가 만드는 모든 토픽 — 새 에이전트에 예제 커스텀 토픽 포함

2. 단계별 절차 — 빈 토픽 만들기

1. 에이전트의 Topics 페이지로 이동 (테스트 패널은 닫기)
2. Add a topic → From blank 선택 — 캔버스에 Trigger 노드가 나타남
3. Trigger 노드의 … → Properties → Phrases 영역 선택
4. 트리거 구문 5~10개 입력 — 짧은 구문 권장, 붙여넣기·파일 업로드 가능
5. 도구 모음의 Details에서 이름·표시 이름·설명 입력
   • 설명은 생성형 오케스트레이션의 토픽 선택 기준 — 고객에게는 안 보임
6. Save 선택

⚠️ 토픽 이름에 마침표(.)를 쓰지 마세요 — 이름에 마침표가 있는 토픽이 포함된 솔루션은 내보낼 수 없습니다.

화면 구성 예시 — 실제 화면·명칭은 버전에 따라 다를 수 있습니다

3. 주요 노드 종류

노드	역할
Message	사용자에게 메시지 표시 (텍스트·이미지·카드)
Question	질문하고 응답을 변수에 저장 — 엔터티로 형식 지정
Condition	변수·수식 기반 분기
Topic management	다른 토픽으로 리디렉션 · 대화 종료 · 사람 연결
Add a tool	커넥터·프롬프트·플로우 호출
Create generative answers	지식 검색·요약 응답 (M2-7)
Set variable / Power Fx	변수 설정·수식 평가

노드 추가 — 노드 아래 + 아이콘 → 종류 선택. 노드 삭제는 … → Delete. 도구 모음에서 잘라내기·복사·붙여넣기·실행 취소(마지막 저장으로 되돌리기 포함)를 지원합니다.

4. 토픽 입·출력 매개변수

토픽은 입력·출력 매개변수를 가질 수 있습니다:

• 토픽 간 리디렉션 시 정보 전달
• 생성형 오케스트레이션에서는 대화 맥락으로 입력을 자동 채움 — 부족하면 질문을 자동 생성 (도구 슬롯 채우기와 동일 원리)

5. 코드 편집기 (YAML)

캔버스 오른쪽 위 More → Open code editor:

• 토픽이 YAML로 표시 — 읽기 쉬운 마크업
• 다른 에이전트의 토픽을 복사·붙여넣기로 재사용 가능
• 전체를 코드로만 설계하거나 복잡한 토픽을 통째로 붙여넣는 것은 완전 지원되지 않음 — 캔버스와 병행

화면 구성 예시 — 실제 화면·명칭은 버전에 따라 다를 수 있습니다

실습 체크리스트

1. “휴가 신청 안내” 토픽을 From blank로 생성 — 트리거 구문 5개
2. 질문 노드(휴가 종류) + 조건 분기 + 종류별 메시지 노드 구성
3. Details에 설명 작성 (생성형 라우팅 대비)
4. 코드 편집기로 YAML 확인

핵심 정리

1. 토픽 = 트리거 + 노드의 대본 — 캔버스에서 시각적으로, YAML로 재사용 가능하게
2. 트리거 구문은 5~10개의 짧은 구문, 설명은 생성형 라우팅의 기준
3. 시스템 토픽은 함부로 고치지 말 것 — 에이전트 빌드에 익숙해진 뒤에

---

M2 빌드로 · 다음: M2-4. 트리거·시스템 토픽

출처: Create and edit topics (MS Learn) · Manage topic inputs and outputs (MS Learn)