M2-1. 지침 — 에이전트 세부 정보와 Instructions 구성

한 줄 요약 — GitHub Copilot Harness(구 ‘새 경험’)에서는 에이전트 동작을 제어하는 주된 수단이 지침(instructions) 입니다 (Standard Harness(구 클래식)는 토픽 흐름·트리거로 제어). Build 탭에서 이름·아이콘·지침 3요소를 구성합니다.

1. 왜 지침일까

Standard Harness 환경이 토픽 흐름과 트리거로 동작을 정의했다면, GitHub Copilot Harness에서는 자연어 지침이 그 역할을 맡습니다. 향상된 오케스트레이션 런타임이 지침을 해석해 사용자 응답을 생성하므로, 지침을 잘 써야 에이전트도 잘 동작합니다. 지침 편집기는 리치 텍스트 서식 (굵게, 기울임, 목록, 인용, 인라인 코드, 링크)을 지원합니다.

2. 구성할 수 있는 3가지 요소

요소	설명	제약
Agent name(이름)	표시 이름	텍스트 필드
Agent icon(아이콘)	화면에 표시되는 아이콘	PNG 형식, 최대 100 KB — 카탈로그 선택 또는 업로드, 색상/강조색(accent color) 지정 가능
Instructions(지침)	자연어 동작 지침	리치 텍스트 서식 지원

3. 단계별 절차

1. Copilot Studio에서 에이전트 열기
2. Build 탭 선택
3. 이름 변경 — 이름 필드 선택 → 새 이름 입력
4. 아이콘 변경 — 아이콘 선택 → Change agent icon 대화 상자에서 카탈로그 선택 또는 커스텀 아이콘 업로드(PNG, ≤100 KB) → (선택) 색상/강조색 선택
5. 지침 구성 — Instructions 섹션에 자연어 지침 입력(서식 활용 가능)
6. 저장(Save) 아이콘 선택

이름 주의(만들 때) — 에이전트를 처음 만들 때 처음 저장하기 직전에 입력해 둔 이름으로 스키마 이름(schema name)이 확정되며, 그 뒤 스키마 이름은 읽기 전용입니다. 표시 이름은 이후에도 자유롭게 바꿀 수 있습니다.

4. 모범 사례 — 효과적인 지침 작성

지침에 포함할 것:

• 에이전트의 주된 역할과 목적
• 톤·스타일 기대치 (격식/친근/간결 등)
• 거절하거나 다른 곳으로 안내할 주제·작업
• 모호한 입력을 처리하는 방법
• 에스컬레이션(escalation)/핸드오프(handoff) 트리거

권장 방법:

1. 목적을 단순하고 명확하게 적는 것부터 시작
2. 조금씩 늘려 가기
3. Preview 탭 테스트 결과를 반영해 지침 고치기

5. 제약·주의 사항

• 프로덕션 준비 미리보기(production-ready preview) — 추가 이용 약관 적용, GitHub Copilot Harness ↔ Standard Harness 양방향 이전(변환) 불가, Standard Harness의 일부 기능은 GitHub Copilot Harness에서 아직 제공되지 않음.
• 일반 “Write agent instructions” 문서의 일부 내용은 Standard Harness(토픽 기반)에 특화되어 있어 GitHub Copilot Harness에는 그대로 적용되지 않을 수 있습니다.

핵심 정리

1. GitHub Copilot Harness에서 동작을 제어하는 주된 수단 = 지침 — 런타임이 해석해 응답 생성
2. 구성 3요소 = 이름 + 아이콘(PNG ≤100 KB) + 리치 텍스트 지침
3. 지침에는 역할·톤·거절 범위·모호한 입력 처리·에스컬레이션 트리거를 담기
4. 단순하게 시작 → Preview 테스트 → 반복 개선

(기능·화면·명칭은 프리뷰 기준이며 바뀔 수 있음)

---

M2 허브로 · 이전 ← M2-8. 모델 · 다음 → M2-2. 지식

출처: Configure agent details and instructions (MS Learn) · Choose a harness (MS Learn)