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. 연결된 에이전트·모델 선택

다른 에이전트에 전문 작업을 위임하는 연결된 에이전트와, 오케스트레이션 기본 모델을 드롭다운으로 바꾸는 모델 선택을 다룹니다.

👉 상세 — 연결된 에이전트·모델

핵심 정리

1. 빌드 순서 권장 — 지침 → 지식 → 토픽 → 도구 순으로 얇게 만들고 테스트로 다듬습니다
2. 생성형 오케스트레이션에서는 설명(description) 이 토픽·도구 선택의 기준입니다
3. 정형이 필요한 구간만 토픽으로, 나머지는 지식·생성형 답변에 맡깁니다

---

이전 ← M1. 시작하기 · 다음 → M3. 운영

출처: Create and edit topics (MS Learn) · Knowledge sources summary (MS Learn) · Add tools (MS Learn)