M3-2. 지침(Instructions) 작성법

한 줄 요약 — Instructions는 에이전트의 행동을 정하는 핵심 구성 요소로 최대 8,000자입니다. 목적·일반 지침·Skills 참조를 구조화하고, 명확하고 원자적인 문장으로 작성해야 품질이 안정됩니다.

1. Configure 탭 필드 한도 (참고)

2. 지침을 구성하는 요소

• Purpose — 에이전트의 역할과 목적
• General guidelines — 톤, 제약 사항
• Skills — 별도 구성 요소(Custom skills, M3-6)를 이름으로만 참조 — 세부 절차를 지침에 중복 서술하지 않음
• (필요 시) 단계별 절차, 오류 처리·한계, 피드백/반복, 대화 예시, 비표준 용어 정의, 마무리 문구

3. 작성 모범 사례

• 긍정형 문장으로 무엇을 할지 지시하고, “~하지 마세요”보다 정확한 동사(확인·검색·전송·점검)를 씁니다.
• 단계별 워크플로는 목표(Goal) + 행동(Action) + 전환(Transition) 으로 원자적으로 쪼갭니다.
• 구조를 목적에 맞게 씁니다 — 섹션(범주, 순서 없음) · 글머리표(병렬 작업) · 번호 목록(순서가 반드시 필요한 작업)만.
• 톤·상세도·출력 형식을 항상 명시합니다 — 지정하지 않으면 모델이 매번 다르게 추론합니다.
• Markdown 구조를 사용합니다 — #/## 헤더, -/1. 목록, 백틱으로 도구·시스템 이름, **굵게**로 핵심 지시.
• 조직 고유 용어·약어는 도메인 용어집으로 정의합니다.
• 기능·지식·도구는 이름을 명시해 참조합니다(예: “차트가 필요하면 code interpreter를 사용”).
• 복잡한 시나리오에는 few-shot 예시를 추가하고, 단순한 경우에는 생략합니다.
• 추론 깊이는 어휘로 제어합니다 — “분석해라·도출해라·근거를 대라·단계별로 생각해라”는 깊은 추론, “짧게, 근거 설명 없이”는 빠른 응답을 유도합니다.
• 과도한 도구 호출·반복적 표현·장황한 설명 같은 흔한 실패 패턴은 “필요한 입력이 있을 때만 도구를 호출” 같은 제약 문장으로 억제합니다.
• 마지막에 자체 점검(self-check) 단계를 넣어 답을 확정하기 전에 스스로 검토하게 합니다.
• 지시를 자꾸 다르게 해석하는 “추론 이탈” 현상이 보이면, 임시 안정화 장치로 문자 그대로 실행 헤더 (“지시는 항상 문자 그대로 해석하십시오. 의도를 임의로 추측하지 마십시오”)를 맨 앞에 넣습니다.

4. 한도를 우회하지 마세요 — SharePoint 오프로딩 경고

8,000자 한도를 피하려고 지침 내용을 SharePoint 등 지식 소스로 옮기는 방법은 권장하지 않습니다. 지식 소스 콘텐츠는 실행 시점에 신뢰되지 않은(untrusted) 입력으로 취급되어 XPIA(교차 프롬프트 인젝션) 분류기의 검사를 받으며, 예측 불가능하게 차단·잘림·정제될 수 있습니다. 또한 문서 편집 권한이 있는 누구나 매니페스트의 거버넌스 밖에서 에이전트 동작을 바꿀 수 있게 되어 공격 표면이 넓어집니다.

5. 복붙 시작 템플릿 — “회의록 정리 도우미”

# Purpose
회의 녹취록이나 회의 노트를 받아 결정 사항 · 액션 아이템 · 다음 단계를 정리하는 도우미입니다.

# General guidelines
- 항상 한국어 존댓말로, 표 위주로 간결하게 답합니다.
- 회의와 무관한 질문은 정중히 거절하고 담당 채널로 안내합니다.
- 출력 형식은 항상 아래 3단 구조를 따릅니다: 요약 → 결정 사항 표 → 액션 아이템 표.

# Steps
1. 입력에서 참석자 이름과 회의 날짜를 찾아 맨 위에 한 줄로 요약합니다.
2. 결정 사항을 표로 정리합니다 — 컬럼: 항목, 결정 내용.
3. 액션 아이템을 표로 정리합니다 — 컬럼: 담당자, 작업, 기한.
4. 담당자나 기한이 불명확하면 "확인 필요"로 표시하고 근거 문장을 함께 남깁니다.

# Error handling
- 입력이 회의록으로 보이지 않으면, 회의록 형식(발언자·시간 등)을 붙여넣어 달라고 요청합니다.
- 결정 사항이나 액션 아이템이 전혀 없으면 "이번 회의에는 해당 항목이 없습니다"라고 명시합니다.

# Examples
사용자: "오늘 회의에서 김철수가 다음 주까지 예산안 초안 작성하기로 했어"
→ 액션 아이템 표에 "담당자: 김철수 · 작업: 예산안 초안 작성 · 기한: 다음 주"로 반영합니다.

# Self-check
응답을 보내기 전에 표의 각 행이 원문 근거를 갖는지 스스로 확인합니다.

핵심 정리

1. Instructions는 최대 8,000자 — Purpose·General guidelines·Skills 등으로 구조화합니다
2. 긍정형·원자적 지시, Markdown 구조, 톤·형식 명시, few-shot, 추론 깊이 어휘, 자체 점검이 핵심 모범 사례입니다
3. 한도를 피해 SharePoint 등 지식 소스로 지침을 옮기지 마세요 — XPIA 검사·차단 대상이 되어 신뢰할 수 없습니다

M3 허브로 → 다음: M3-3. 지식(Knowledge) 소스와 한도

출처: Write effective instructions for declarative agents (MS Learn) · Build agents in Agent Builder (MS Learn)