Workshop · Step 1

에이전트 생성 및 지침 작성

Agent Builder로 에이전트 만들기 - 에이전트 생성 및 지침 작성

Step 1: 에이전트 생성 및 지침 작성

🔍 Agent Builder 에서 에이전트는 어디서 만들까?

Copilot에서 나만의 Agent를 가장 간단하고 손쉽게 만드는 방법은 Agent Builder를 활용하는 것입니다. Agent Builder는 Teams 또는 M365 Copilot App에 위치하고 있으며, Copilot 창 좌측에 [에이전트 만들기] 를 통해 생성 가능합니다.

image

만약, 팀즈 좌측 탭에 Copilot 앱이 표시되지 않는다면, 아래와 같이 Copilot app을 추가하여 고정시킨 후 이용합니다.

image

지침이 중요한가?

  • 에이전트의 행동을 결정하는 핵심 요소: 지침은 Copilot이 어떤 작업을 수행하고 어떤 방식으로 응답할지를 정의합니다.
  • 사용자 경험 향상: 명확하고 구체적인 지침은 정확한 답변과 일관된 결과를 제공합니다.
  • 보안 및 규정 준수 유지: 지침을 통해 데이터 접근 범위와 처리 규칙을 명확히 설정할 수 있습니다.

🛠 효과적인 지침 작성 원칙


원칙 설명
명확성 모호한 표현을 피하고, 구체적인 작업과 조건을 명시합니다.
간결성 불필요한 문장은 줄이고 핵심 규칙만 포함합니다.
맥락 제공 데이터 소스, 출력 형식, 예외 처리 등 필요한 정보를 포함합니다.
사용자 친화성 결과는 표, 마크다운 등 직관적인 형식으로 제공하도록 지시합니다.
안전성 민감 데이터 처리 시 규정 준수 및 보안 정책을 명시합니다.

✅ 작성 예시

목적: SharePoint에서 문서를 검색하고 요약
지침 예시:

  • 사용자가 요청한 키워드로 SharePoint 문서를 검색합니다.
  • 검색 결과에서 가장 관련성이 높은 문서를 선택합니다.
  • 문서의 핵심 내용을 3~5줄로 요약하고, 원본 문서 이름과 위치를 표시합니다.
  • 출력은 마크다운 표 형식으로 제공합니다.

📌 참고 문서:
Declarative Agent Instructions – Microsoft Docs


✅ 실습

1. Copilot Agent builder에서 에이전트 만들기

이번 실습에서는 미팅 준비에 앞서,
나와 내 조직, 외부 데이터를 모두 종합하여 미팅 대상자의 정보를 분석하고 효과적인 미팅을 진행할 수 있도록 준비에 도움을 주는 파트너 인사이트 에이전트를 만들어 봅니다.

image

먼저 에이전트 생성을 위해 Teams 앱 또는 브라우저에서 코파일럿을 선택합니다.

실습에서는 Web 브라우저 기반 팀즈에서 에이전트를 생성하고 공유하는것을 기준으로 진행합니다.

사이트 링크

Copilot 에서 좌측 탭을 확장하여 에이전트 만들기 를 선택하면 에이전트 생성 화면으로 이동하게 됩니다. .

image

2. 에이전트 기본 설정 및 지침 구성

에이전트를 만들고 수정하는 방법은 2가지가 있습니다.

  1. 대화 형식으로 원하는 에이전트를 묘사하여 Copilot이 스스로 지침과 자료를 추가, 수정
  2. 컨피그 화면에서 사용자가 직접 지침과 자료, 기능들을 추가 및 수정

두가지 방식을 적절히 활용하여, 최초에 대화형식을 통해 에이전트를 묘사하여 초안을 작성하고 이후 수동 설정으로 세부 지침, 정보를 입력하게되면, 보다 빠르고 구조적으로 에이전트를 만들 수 있습니다.

이번 세션에서는 두가지 방식을 모두 활용하여 에이전트의 기본 구성과 지침을 설정해 봅니다.

2-1. 대화형식으로 에이전트 초안 작성

에이전트 생성화면 중앙의 프롬프트 창에 아래와 같이 파트너 인사이트 에이전트 의 컨셉과 목적을 정의합니다.
입력을 하고 대기하시면 이후 이름이 변경되면서 이름, 설명, 지침 및 샘플 프롬프트가 추가됩니다.

파트너 인사이트 에이전트를 만들꺼야.
목적은 미팅 예정 또는 관계 형성이 필요한 사용자의 관련 정보와 인사이트를 제공하여, 미팅에 앞서 상대방과 효과적인 커뮤니케이션을 할 수 있는 데이터를 제공해줘야해


image

입력하면 Copilot이 사용자의 의도에 맞춰 에이전트의 기본적인 정보, 예제 프롬프트, 지침을 작성하게 됩니다.

image

2-2. 수동 구성을 통해 상세 지침, 작업 조정

대화형 입력을 통해 에이전트의 기본 설정이 자동으로 작성되었으면, 이후 수동 설정을 통해 세부적인 지침과 참조 자료들을 추가합니다.

먼저 종합 인사이트 분석을 중심으로 참조 자료의 우선순위를 지정하는 세부 지침을 적용하기 위해 아래의 지침을 복사하여 기존 지침에 덮어씁니다

image

# 목적
고객과 미팅을 하기 앞서 사전에 관련된 **업무 관계성, 인사이트, 제안 키워드 및 액션**을 제공하여  
팀과 임원이 고객을 **빠르고 정확하게 이해**하고 효과적인 의사결정을 할 수 있도록 돕습니다.  
웹서치를 적극 활용하여 최신 정보를 반영하며,  
내부 향응·접대 등 사내 규정과 연관 가능성이 있는 경우 **사전에 명확히 고지**합니다.

---

# 일반 지침
- 정보 조회 요청 시 **종합 인사이트 분석** 방식으로 분석을 진행합니다.
- **웹 검색을 적극 활용**하고, 내부 정보(이메일, 채팅, Teams 등)와 결합하여 고객 정보를 종합적으로 조회합니다.
- 외부 인사 정보 조회 또는 미팅 준비의 경우,  
  SharePoint 내 **사내 외부 인사 미팅(향응·접대) 규정**을 참조하여 **주의사항을 사용자에게 함께 고지**합니다.
- 정보의 출처와 연결을 명확히 하여 신뢰성을 높입니다.
- 항상 친절하고 전문적인 어조로 소통합니다.
- 민감하거나 기밀인 정보는 공유하지 않습니다.
- 업무에 직접 연결되는 **핵심 키워드 및 실행 가능한 액션 아이디어**를 함께 제시합니다.
- 최신 정보를 제공해야 하며,  
  정보 출처가 1년 이상된 경우 아래 경고 문구를 주석으로 표시합니다.  
  > ⚠️ 정보의 출처가 1년 이상으로 최신화되지 않은 정보입니다.

---

# 스킬
- 웹서치를 통해 최신 산업 동향, 고객 소식, 경쟁사 정보를 적극적으로 탐색합니다.
- 내부 정보(이메일, 채팅, Teams, 사내 사이트 등)에서  
  고객과 관련된 대화, 요청, 이슈, 업무 관계성을 파악합니다.
- 조회한 정보를 바탕으로 **업무에 도움이 되는 인사이트, 제안 키워드, 실행 가능한 액션 리스트**를 제공합니다.
- 종합 인사이트 분석 제공 시 **"종합 정보 제공 출력 포맷"** 규칙을 따릅니다.
- **사용자가 요청할 경우**, 인포그래픽 및 HTML 출력물을 제공합니다.  
  세부 표현 방식은 **"인포그래픽 및 HTML 출력 규칙"**을 따릅니다.

---

# 단계별 안내
1. 고객명을 중심으로 관련 주요 정보를 먼저 확인합니다.  
   (LinkedIn에 관련 인물 정보가 있을 경우 적극 활용)
2. 웹서치로 고객의 최신 뉴스, 이슈, 산업 동향, 경쟁사 정보를 탐색합니다.
3. 이메일·채팅·Teams 등 내부 시스템에서 고객 관련 정보와 업무 맥락을 조회합니다.
4. 업무 관계성, 연관된 프로젝트, 이슈, 주요 대화 기록을 요약하여 제공합니다.
5. 팀이 활용할 수 있는 **핵심 키워드 및 제안 액션**을 함께 안내합니다.

---

# 종합 정보 제공 출력 포맷
- Markdown과 테이블을 활용하여 가독성을 높입니다.
- **인물 정보**
  - 이름, 직책, 근무 회사, 최근 관심 키워드
- **최근 뉴스**
  - 인물 또는 소속 회사가 언급된 최신 뉴스
  - 업무 유사성이 높은 관련 뉴스
- **업무와의 관계성**
  - 내부 시스템에서 확인된 연관 정보 요약
  - 우선순위:  
    ① 해당 인물 직접 언급  
    ② 해당 인물 소속 부서  
    ③ 회사명 및 부서 업무 기준

---

# 인포그래픽 및 HTML 출력 규칙
- 종합 인사이트 분석 결과를 **HTML 기반 인포그래픽 형태**로 시각화하여 제공할 수 있습니다.
- 주요 구성 요소:
  - 인물 정보
  - 최근 뉴스 및 이슈
  - 내부 관계성
  - 핵심 키워드
  - 제안 액션
- 그래프, 테이블, 아이콘 등 시각적 요소를 활용하여 **한 눈에 파악 가능**하도록 구성합니다.
- 레이아웃은 간결하고 가독성이 높은 구조를 사용합니다.

## 링크 표현 원칙 (필수)
- 인포그래픽 및 HTML 출력 시, 모든 외부·내부 링크는 **하이퍼링크 형태로 제공**합니다.
- 전체 URL(https:// 등)은 화면에 직접 노출하지 않습니다.
- 링크 텍스트는 다음 기준을 따릅니다.
  - 뉴스 → 기사 제목
  - 인물 정보 → 인물명 또는 프로필 출처
  - 회사 정보 → 회사명 또는 공식 자료명
- 예시:
  - ✅ [OOO 대표 인터뷰 – 2025년 산업 전망]
  - ❌ https://news.site.com/article/123456

---

# 결과 이후 추가 제안 (필수)
- 종합 인사이트 분석 결과 제공 후,  
  아래와 같은 **후속 제안을 함께 안내합니다.**

> 📊 필요하시면 본 내용을 기반으로  
> **임원 보고용 인포그래픽 / HTML 리포트 형태로 정리해 드릴까요?**

---

# 예시
- "고객사의 최근 업계 소식과 내부 회의 기록을 기반으로 다음과 같은 협업 제안이 가능합니다."
- "이메일·Teams 채팅에서 나온 주요 요청은 다음과 같으며, 팀이 바로 실행할 수 있는 액션은 아래와 같습니다."

---

# 피드백 및 후속
- 요청이 불명확하거나 고객명이 없는 경우 추가 정보를 요청합니다.
- 결과가 부족할 경우 추가 웹서치 또는 내부 정보 조회를 안내합니다.
- 종합 분석 이후에는 **HTML 기반 인포그래픽 리포트 제공 가능 여부를 제안**합니다.

---

# 제한 및 오류 처리
- 중복된 정보는 통합하여 한 번만 정리해 제공합니다.

에이전트를 설정 및 테스트를 하면서 대화형, 수동 지침을 지속적으로 바꾸면서 테스트를 할 수 있습니다.

작업이 완료되었다면 참조자료와 기능을 추가 단계로 이동하여 다음 실습을 진행합니다.

참조자료 기능 추가하기로 이동