interlinear

실무자와 개발자 사이비즈니스 앱과 에이전트 사이자연어와 기계어 사이

3 min

M365 Copilot 선언적 에이전트에 커스텀 스킬 추가하기 (preview)

Microsoft 365 Copilot 선언적 에이전트에 커스텀 스킬(프리뷰)을 추가하는 두 가지 방법과 용량·개수 한도, 샌드박스 네트워크·설치 제약을 정리했어요.

Microsoft 365 Copilot커스텀 스킬선언적 에이전트Agents ToolkitFrontier Preview

카드뉴스

1 / 8

M365 Copilot 선언적 에이전트에 커스텀 스킬 추가하기 (preview) 카드뉴스 1/8
M365 Copilot 선언적 에이전트에 커스텀 스킬 추가하기 (preview) 카드뉴스 2/8
M365 Copilot 선언적 에이전트에 커스텀 스킬 추가하기 (preview) 카드뉴스 3/8
M365 Copilot 선언적 에이전트에 커스텀 스킬 추가하기 (preview) 카드뉴스 4/8
M365 Copilot 선언적 에이전트에 커스텀 스킬 추가하기 (preview) 카드뉴스 5/8
M365 Copilot 선언적 에이전트에 커스텀 스킬 추가하기 (preview) 카드뉴스 6/8
M365 Copilot 선언적 에이전트에 커스텀 스킬 추가하기 (preview) 카드뉴스 7/8
M365 Copilot 선언적 에이전트에 커스텀 스킬 추가하기 (preview) 카드뉴스 8/8
← → 한 장씩 이동 · 아래에서 본문이 이어집니다

원문: Custom skills in declarative agents (preview) · Microsoft Learn 공식 문서를 짧게 정리한 글이에요. 관련 문서: Agent Builder에서 스킬 추가, Agents Toolkit으로 스킬 추가

무엇이 새로 생겼나요

Microsoft 365 Copilot의 선언적 에이전트(declarative agent)에 커스텀 스킬을 붙일 수 있게 됐어요. 아직 프리뷰이고, Microsoft Frontier Preview에 참여한 조직만 쓸 수 있어요.

예전에는 “스킬”이 지침(instructions) 안에 적어 두는 작업 설명을 뜻했어요. 이제는 지침과 분리된 별도 구성 요소예요. 작업 세부 내용을 지침에 길게 적는 대신, 스킬로 묶어 두고 에이전트가 필요할 때 참조해요.

스킬이란

스킬은 폴더 하나예요. 안에 이런 것이 들어가요.

  • 필수 파일 SKILL.md: 맨 위 YAML에 이름과 설명, 그 아래에 지침. 지침은 2만 자 미만이어야 해요.
  • 선택 파일: 템플릿, 참고 데이터, 정의서 같은 리소스.
  • 선택 스크립트와 하위 폴더.

예를 들어 재무팀이 “분기 사업 리뷰” 스킬을 만든다면, 리뷰 작성 지침과 데이터 변환·차트 생성 스크립트, 재무 모델과 KPI 정의, 브랜드 슬라이드 템플릿을 한 폴더에 묶을 수 있어요. 사용자가 그 작업을 요청하면 에이전트가 이 스킬을 꺼내 써요.

왜 스킬로 나누나요

  • 컨텍스트를 아껴요. 스킬은 필요할 때만 로드돼요(점진적 공개). 스킬이 늘어나도 에이전트의 컨텍스트는 가벼워요. 모델이 즉석에서 코드를 짜는 대신 준비된 스크립트를 쓰니 결과가 매번 비슷하게 나와요.
  • 지침 한도를 넘어요. 선언적 에이전트 지침은 8,000자 제한이 있어요. 복잡한 절차를 스킬로 쪼개면 품질을 잃지 않고 더 길고 구체적인 안내를 줄 수 있어요.
  • 자산을 묶어요. 지침·리소스·스크립트를 하나로 패키징해 에이전트에 붙여요.
  • 기업용 준비가 돼 있어요. 스크립트는 격리된 샌드박스에서 돌고, 파일의 민감도 레이블이 유지되며, 관리자 거버넌스가 있어요.

어디서 추가하나요

두 가지 경로가 있어요.

  • Agent Builder(Copilot 채팅 안): .zip 패키지를 업로드해요. 자연어로 설명하면 Agent Builder가 스킬을 만들어 주기도 해요. 패키지는 최대 50MB, 파일 하나는 25MB까지예요.
  • Microsoft 365 Agents Toolkit(CLI 또는 VS Code): 스킬 폴더를 추가해요. .zip은 안 되고, 앱 패키지 전체가 10MB 이내여야 해요. 에이전트 매니페스트 버전 1.9가 필요하고, TEAMSFX_AGENT_SKILLS 환경 변수를 켜야 해요.

두 경로 모두 에이전트당 스킬 8개, 전체 350파일, 폴더 깊이 3단계까지예요. 프리뷰 단계라 스킬을 여러 에이전트에서 재사용하는 건 아직 안 돼요.

쓸 수 있는 파일

  • 지침·리소스: json, xml, yaml, ini, config, docx, pdf, txt, md, pptx, xlsx, csv, html, png, jpg 등 문서·이미지 대부분.
  • 스크립트: Python(.py), JavaScript(.js/.mjs/.cjs), TypeScript(.ts/.mts), 셸(.sh/.bash).

스크립트 샌드박스의 한계

스크립트는 안전한 샌드박스에서 실행돼요. 그래서 이런 건 못 해요.

  • 인터넷·네트워크 접근 없음. 인증이 필요한 외부 호출도 안 돼요.
  • 패키지를 실행 중에 설치할 수 없어요. 샌드박스에 이미 있는 패키지만 쓰고, 있는지 확인되지 않은 패키지에 의존하면 안 돼요.
  • 커넥터·API 플러그인·MCP 서버는 에이전트(오케스트레이터)가 쓰는 것이지, 스크립트가 직접 부를 수는 없어요.

보안과 저장

  • 민감도 레이블은 샌드박스에서도 유지되고 정책이 적용돼요. 다만 사용자 정의 권한과 이중 키 암호화(DKE)는 지원하지 않아요.
  • 업로드한 스킬 파일은 테넌트 범위의 SharePoint Embedded 컨테이너에 저장돼요.

알려진 문제

  • 프리뷰 동안 스킬과 임베디드 파일(embedded files)을 한 에이전트에 같이 쓸 수 없어요. 지원 예정이에요.

정리

지침에 다 적지 말고, 반복되는 작업은 스킬 폴더로 묶어 에이전트에 붙이세요. 필요할 때만 로드되니 가볍고, 스크립트 덕에 결과가 일정해요. 다만 프리뷰이고 Frontier 프로그램 참여 조직만 쓸 수 있으니, 시작 전에 자격과 샌드박스 한계(네트워크 없음, 패키지 설치 없음)를 먼저 확인하세요.