Lab 0-7 — 배포 및 실제 테스트

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

1. 게시(Publish)

최초 게시는 상단 Publish 버튼 옆 셰브론(chevron) → Publish agent 대화 상자에서 세부 정보 검토·채널 선택 후 Publish → 게시 완료까지 대기. (이름·설명·지침이 누락되면 대화 상자가 완료 필요 항목을 알려줍니다.)
이후 변경은 Publish 버튼 → Publish your changes 대화 상자로 재게시합니다. 게시가 끝나야 Monitor 탭도 활성화됩니다.

Publish 버튼 / 채널 설정 화면

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

새 환경에서 현재 사용 가능한 채널은 Microsoft 365 Copilot · Microsoft Teams · Demo website · Web app 4개뿐입니다 (SharePoint·메시징·컨택 센터 채널 등은 미제공, subject to change). 또한 개인 개발환경에서 만든 에이전트는 게시 후에도 제대로 동작하지 않습니다 — M365 Copilot 앱에서 오류, Teams 챗봇에서 랜덤 비정상 동작이 관찰됩니다(4장과 같은 개인 개발환경 제약).

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

3. 게시 후 주의 — 스킬 변경 시

게시 이후 스킬을 수정해도 재게시 전까지 라이브 버전에 반영되지 않습니다(초안 독립성). 수정 후 재게시하고, 4장의 “app/skills 보여줘” 프롬프트로 반영을 검증하세요.
스킬 버전을 올릴 땐 같은 이름 대신 새 이름(-v2) 으로 올리는 게 안전합니다.

4. 실제 채널에서 재현 — 6장 실습 반복

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

게시 후 제공되는 링크로 에이전트를 엽니다(또는 켜둔 채널에서 접속). 다른 사용자에게 보여주려면 Share로 공유합니다(새 환경은 보기 권한만 부여 가능, 게시 후 공유 가능).
6장의 프롬프트 #1~#5를 그대로 다시 입력해, Preview 탭과 동일한 결과(분석→대시보드→메일)가 나오는지 확인합니다.
차이가 있으면(예: 도구 미연결·스킬 미주입) 4장·위 2절의 개인 개발환경 제약을 의심하고 Sandbox 환경에서 재확인합니다.

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

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

실습 체크리스트

트러블슈팅

증상	원인	해결
ZIP 업로드 거부	폴더째 압축	폴더 내용물을 압축(루트 SKILL.md)
“Name must use only lowercase…”	이름에 `_`·대문자	소문자·숫자·하이픈만
디자인 무시·제멋대로	스킬 리소스 미주입(개인 개발환경 제약)	`app/skills` 검증 → Sandbox 환경에서 개발
Copilot 앱 오류·Teams 랜덤 오동작	개인 개발환경에서 New CLI 에이전트 미지원	Sandbox 환경에서 개발·게시
수정해도 옛 동작	같은 이름 캐시 / 게시 후 미반영(초안 독립성)	새 이름(`-v2`) / 재게시 후 검증
메일 첨부 실패	OneDrive 도구 미연결 / 직접 첨부	도구 재연결 / 링크 첨부 방식
게시 실패(Publish failed)	구성 오류 등	대화 상자의 오류 확인 → Retry

← 6. 테스트 · Lab 0 개요로 · 다음: Lab 1 — 경영진 보고 자료 브리핑

출처: Publish an agent — Microsoft Learn · Available channels for agents — Microsoft Learn · 3부 · 배포 & 트러블슈팅 — Microsoft Copilot Agentic Blog