3부 · 배포 & 트러블슈팅

8. 배포 및 실제 테스트

▶ 목표: 에이전트를 게시(배포)하고 실제 채널에서 확인한다.

8.1 게시(Publish)

1. 상단 Publish 클릭 → 게시 완료까지 대기.
2. 게시 후 채널 설정에서 사용할 채널을 켭니다.

8.2 ⚠️ 현재 채널 제약 (프리뷰, 2026-06-14 기준)

개인 개발환경에서 만든 에이전트는 게시 후에도 제대로 동작하지 않습니다 — M365 Copilot 앱에서 오류, Teams 챗봇에서 랜덤 비정상 동작이 관찰됩니다(5.4와 같은 개인 개발환경 제약).

• 해결: 에이전트를 Sandbox 환경에서 개발·게시하면 각 채널이 정상 동작합니다.
• 참고: M365 Copilot 앱 정식 연동 범위는 프리뷰라 계속 변할 수 있습니다(“subject to change”).

8.3 게시 후 주의 — 스킬 변경 시

• 게시 이후 스킬을 수정하면 변경이 바로 반영되지 않을 수 있습니다. 수정 후 재게시하고, 5.4의 “app/skills 보여줘” 프롬프트로 반영을 검증하세요.
• 스킬 버전을 올릴 땐 같은 이름 대신 새 이름(-v2)으로 올리는 게 안전합니다(2부 2.6).

8.4 실제 채널에서 재현 — 7장 실습 반복

게시가 끝나면 테스트 창이 아닌 실제 채널에서 똑같이 동작하는지 확인합니다.

1. 게시 후 제공되는 링크로 에이전트를 엽니다(또는 켜둔 채널에서 접속).
2. 7장의 프롬프트 #1~#5를 그대로 다시 입력해, 테스트 창과 동일한 결과(분석→대시보드→메일)가 나오는지 확인합니다.
3. 차이가 있으면(예: 도구 미연결·스킬 미주입) 5.4·8.2의 개인 개발환경 제약을 의심하고 Sandbox 환경에서 재확인합니다.

짚고 가기: 테스트 창에선 잘 되는데 실제 채널에서만 깨진다면, 거의 항상 개인 개발환경 제약(8.2)입니다. Sandbox에서 게시하면 해결됩니다.

부록. 실습 체크리스트 & 트러블슈팅

실습 체크리스트

• New 환경(preview URL 또는 Try now)에 진입했는가
• 지침이 “무엇을”에 집중하고, 디자인은 스킬을 가리키는가
• SharePoint 특정 폴더(엑셀 시계열 + Word 정책 문서)를 Knowledge로 연결했는가
• 단일 스킬(weekly-sales-brief)이 UI에 등록됐는가
• 2개 ZIP 스킬 패키지(excel-analysis·brand-comms)를 임포트했고, 둘 다 루트에 SKILL.md가 있는가
• 스킬 name이 소문자·숫자·하이픈만 쓰는가
• app/skills 프롬프트로 리소스까지 주입됐는지 검증했는가 (5.4)
• Work IQ Mail·OneDrive MCP가 연결됐는가 (겹치는 도구 없음)
• 프롬프트 #3 주의사항이 Word 정책 문서를 근거로 답했는가
• 메일이 OneDrive 링크로 첨부되고, 나+팀장님에게 발송 전 확인을 거치는가
• 게시 후 실제 채널에서 프롬프트 #1~#5 재반복(8.4)을 확인했는가

트러블슈팅