M2. 빌드 — 에이전트를 구성하는 8요소
한 줄 요약 — 표준 하네스 에이전트는 지침·지식·토픽·트리거·엔터티·변수·생성형 답변·도구·연결된 에이전트·모델로 조립합니다. M2는 공식 문서의 빌드 구간을 8개 하위 세션으로 나눠, 각 요소의 개념과 클릭 절차를 익힙니다.
하위 세션
| # | 세션 | 핵심 |
|---|---|---|
| 1 | 지침 | 에이전트 세부 정보 · Instructions 작성 · 모범 사례 |
| 2 | 지식 | 소스 종류 · 추가 절차 · 접지·인용 · 소스 한도 |
| 3 | 토픽 | 시스템/커스텀 토픽 · 노드 종류 · 캔버스 편집 · 코드 편집기 |
| 4 | 트리거·시스템 토픽 | 트리거 종류 · 트리거 구문 설계 · 시스템 토픽 역할 |
| 5 | 엔터티·변수·조건 | 프리빌트/커스텀 엔터티 · 슬롯 채우기 · 변수 범위 · Power Fx |
| 6 | 도구 | 커넥터 · 프롬프트 · REST API · 커스텀 커넥터 · MCP · 플로우 |
| 7 | 생성형 답변 | 노드 기반 검색·요약 · 폴백 구성 · 소스 한도 4 |
| 8 | 연결된 에이전트·모델 | 다른 에이전트 연결 · 기본 모델 선택 |
1. 지침 (Instructions)
에이전트의 역할·톤·범위·금지 사항을 자연어로 서술합니다. 생성형 오케스트레이션에서는 지침이 계획 수립의 기준이 됩니다.
👉 상세 — 지침
2. 지식 (Knowledge)
웹사이트·파일·SharePoint·Dataverse 등 지식 소스를 연결하면, 에이전트가 생성형 답변으로 근거 기반 응답을 만듭니다. 에이전트 수준(Knowledge 페이지)과 토픽 수준(생성형 답변 노드) 두 곳에서 씁니다.
👉 상세 — 지식
3. 토픽 (Topics)
토픽은 대화가 어떻게 진행될지 정의하는 대본입니다 — 트리거 + 노드(메시지·질문·조건·도구 호출)로 구성되며, 작성 캔버스에서 시각적으로 편집하거나 YAML 코드 편집기로 다룹니다.
4. 트리거·시스템 토픽
토픽이 언제 시작될지 정하는 트리거(의도 인식·구문·이벤트)와, 대화 시작·폴백·종료 등 필수 동작을 담당하는 시스템 토픽을 다룹니다.
5. 엔터티·변수·조건
사용자 입력에서 정보를 뽑는 엔터티(슬롯 채우기), 대화 중 값을 저장하는 변수, Power Fx 수식으로 분기하는 조건을 익힙니다.
6. 도구 (Tools)
에이전트가 실제 행동을 하게 만드는 도구 — 프리빌트 커넥터, 프롬프트, REST API, 커스텀 커넥터, MCP 서버, 에이전트 플로우 — 를 추가·구성합니다. 생성형 오케스트레이션에서는 이름·설명이 곧 호출 조건입니다.
👉 상세 — 도구
7. 생성형 답변 노드
토픽 안에서 지식을 검색·요약하는 Create generative answers 노드로, 폴백 토픽이나 특정 토픽 구간에 지식 기반 응답을 붙입니다. 노드 수준 소스 한도(4)에 주의합니다.
8. 연결된 에이전트·모델 선택
다른 에이전트에 전문 작업을 위임하는 연결된 에이전트와, 오케스트레이션 기본 모델을 드롭다운으로 바꾸는 모델 선택을 다룹니다.
핵심 정리
- 빌드 순서 권장 — 지침 → 지식 → 토픽 → 도구 순으로 얇게 만들고 테스트로 다듬습니다
- 생성형 오케스트레이션에서는 설명(description) 이 토픽·도구 선택의 기준입니다
- 정형이 필요한 구간만 토픽으로, 나머지는 지식·생성형 답변에 맡깁니다
출처: Create and edit topics (MS Learn) · Knowledge sources summary (MS Learn) · Add tools (MS Learn)