코드 어시스턴트에 한 문장이면 끝: Agent 365 Skills로 내 에이전트를 엔터프라이즈급으로
내 노트북에서는 에이전트가 완벽하게 동작합니다. 추론하고, 도구를 호출하고, 데모도 깔끔하게 성공합니다. 그런데 진짜 어려운 일은 그 다음부터입니다. 신원(Identity), 관측성(Observability), 거버넌스(Governance), 메시징(Messaging), 그리고 Microsoft 365 데이터에 대한 안전한 접근 — 이 “엔터프라이즈 준비” 단계가 시작되는 순간이죠.
지금까지 이 마지막 단계는, Microsoft Learn 문서를 한참 읽고, CLI 명령을 정확한 순서대로 실행하고, 매니페스트를 손으로 편집하고, 모든 사전 조건이 갖춰졌기를 기도하며 프로덕션까지 끌고 가는 과정이었습니다. 조직은 빠르게 움직이고 있습니다. AI 에이전트를 실험하는 단계를 넘어, 이제 실제 비즈니스 프로세스 곳곳에 에이전트를 투입하고 있죠. 개발자들은 LangChain, OpenAI, Semantic Kernel, Azure AI Foundry, Claude SDK, Google ADK 등 다양한 도구로 에이전트를 만듭니다. 하지만 뛰어난 오케스트레이션 로직만으로는 부족합니다.
Microsoft는 2026년 6월 22일 Agent 365 블로그를 통해, 바로 이 “마지막 1마일”을 자연어 한 문장으로 끝낼 수 있게 해 주는 Agent 365 Skills를 공개했습니다. 개발자가 이미 쓰고 있는 코드 어시스턴트 안에서, 원하는 결과를 말로 설명하면 스킬이 알아서 프로젝트를 감지하고, 꼭 필요한 것만 질문하고, 적절한 변경을 적용한 뒤, 세션이 끝나기 전에 결과까지 검증해 줍니다.
가장 어려운 구간, “마지막 1마일”
Agent 365 Skills가 등장하기 전, 에이전트를 온보딩하려면 길고 깨지기 쉬운 수작업의 연속을 거쳐야 했습니다.
- Agent 365 CLI 설치
- Azure 사전 조건 검증
- 블루프린트(Blueprint) 등록
- Entra 아티팩트 구성
- OpenTelemetry 익스포터 연결
- 매니페스트 패키징
- MCP 서버 연결
- 로컬 테스트
문제는 이 단계들이 순서에 민감하다는 점입니다. 하나라도 빠뜨리면 무언가가 깨지고, 그 사실은 보통 늦게 — 프로덕션에서 — 드러납니다.
Agent 365 Skills는 이 흩어진 워크플로를 가이드형 라이프사이클로 대체합니다. 개발자는 Claude Code, GitHub Copilot CLI, VS Code 에이전트 모드 안에 머무른 채 원하는 결과를 요청하기만 하면 됩니다. 구현 세부 사항은 스킬이 처리하되, 엔터프라이즈 팀이 의존하는 기술적 통제(control)는 그대로 보존합니다.
여러 시간이 걸리던, 순서에 민감한 험난한 과정을 → 가이드를 따라가는 한 문장으로.
개발자에게 무엇이 달라지나요?
- 한 문장으로 시작: 수많은 Microsoft Learn 페이지를 읽는 대신 “add WorkIQ tools”, “integrate observability” 같은 한 문장으로 시작합니다.
- 분 단위 자동 계측: OpenTelemetry 익스포터, 토큰 리졸버, baggage 스코프를 손으로 연결하는 대신 몇 분 만에 자동으로 계측합니다.
- 자동 매니페스트/설정 변경: 매니페스트와 구성 파일을 직접 편집하는 대신 스킬이 필요한 변경을 적용합니다.
- 출시 전 문제 포착: “빠뜨린 게 없기를” 바라는 대신 내장 검증기(validator)가 출시 전에 문제를 잡아냅니다.
동작 방식: describe → detect → ask → apply → validate
예를 들어 개발자가 텔레메트리(관측성)를 추가하고 싶다고 해 봅시다. 한 줄만 입력하면 됩니다.
> add observability to this agent
그 다음부터는 스킬이 작업을 넘겨받습니다. 프레임워크를 감지하고(예: .NET Semantic Kernel 프로젝트), 정말 중요한 질문만 던지고(어떤 인증 모드를 쓸지 — OBO, Agentic-User, S2S 중), OpenTelemetry와 Agent 365 추적 익스포터를 연결한 뒤, 프로젝트가 여전히 정상 빌드되는지 확인합니다. 매니페스트를 헤집을 필요도, 반쯤 설정되다 만 익스포터도 없습니다.
모든 스킬은 동일한 다섯 박자 루프를 따릅니다.
describe(설명) → detect(감지) → ask(질문) → apply(적용) → validate(검증)
다른 요청들도 같은 방식으로 동작합니다.
- “Add messaging and notifications to this agent.” (이 에이전트에 메시징과 알림 추가)
- “Add observability to this agent.” (이 에이전트에 관측성 추가)
- “Wire up WorkIQ Mail and Calendar.” (WorkIQ 메일·캘린더 연결)
- “Test this agent locally.” (이 에이전트를 로컬에서 테스트)
6개의 스킬, 하나의 라이프사이클
Agent 365 Skills는 개발자가 에이전트를 Microsoft Agent 365용으로 준비할 때 마주치는 라이프사이클 단계에 매핑되는 6개의 스킬로 구성됩니다. 내 에이전트에 필요한 것만 골라 실행해도 되고, make 계열 스킬로 필요한 단계를 한 번에 실행할 수도 있습니다.
| 스킬 | 하는 일 |
|---|---|
| a365-setup | Agent 365 CLI 설치, Azure 사전 조건 검증, 에이전트 스택 감지, 알맞은 온보딩 경로 안내까지 하나의 가이드 흐름으로 처리 |
| make-a365-agent | 전체 메시징 계층 없이 관측성이나 카탈로그 가시성만 필요한 에이전트를 위해 블루프린트(Blueprint) 등록 |
| instrument-observability | OpenTelemetry와 Agent 365 추적 익스포터를 연결해 에이전트 스팬(span)이 Microsoft Defender, Microsoft Purview, Microsoft 365 관리 센터에 나타나도록 함. OBO·Agentic-User·S2S 인증 모드 지원 |
| add-workiq-tools | Work Intelligence(WorkIQ) MCP 서버 — 메일, 캘린더, Word 등 — 를 연결해 에이전트가 Microsoft 365 데이터를 읽고 처리하도록 함 |
| make-ai-teammate | 메시징과 알림을 추가해 에이전트가 Teams, 이메일, @멘션으로 메시지를 받을 수 있게 함 |
| test-local | 에이전트를 AgentsPlayground와 함께 실행해 클라우드 배포 없이 로컬 스모크 테스트 수행 |
이미 쓰고 있는 스택 그대로
에이전트 개발은 하나의 언어, 하나의 프레임워크로 통일돼 있지 않습니다. Agent 365 Skills는 그런 현실을 전제로 설계되어, 세 가지 주요 생태계와 인기 있는 다수의 에이전트 프레임워크를 지원합니다.
- .NET: Agent Framework, Semantic Kernel, Azure AI Foundry
- Node.js: LangChain, OpenAI Agents SDK, Claude SDK, Semantic Kernel, Google ADK
- Python: Agent Framework, LangChain, OpenAI, Claude, Semantic Kernel, Google ADK
프로젝트 스택은 자동으로 감지되므로, 구성 파일을 먼저 작성하거나 프로젝트 구조를 손으로 매핑할 필요가 없습니다. 스킬이 경로를 판단하고 다음 단계를 안내합니다.
엔터프라이즈를 위한 설계 원칙
속도도 중요하지만, “무언가를 망가뜨리지 않는 것”도 그만큼 중요합니다. Agent 365 Skills는 빠르게 움직이면서도 팀이 기대하는 안전성과 검증을 포기하지 않도록 만들어졌습니다.
- 가산적·멱등적(Additive & idempotent): 스킬은 기존 코드를 삭제하거나 구조를 바꾸지 않으며, 같은 스킬을 다시 실행해도 안전하도록 설계됨
- 상태 인식(State-aware): 워크스페이스 감지 캐시가 이미 연결된 항목을 추적해, 완료된 단계는 중복 실행이 아니라 건너뜀
- 가드레일(Guard-railed): pre-tool 훅이 프로젝트 외부 수정을 차단하고, stop-hook 검증기가 세션 종료 전에 빌드 통과를 확인
이러한 통제 장치들이 함께 작동하면서, 셋업 리스크를 줄이는 동시에 에이전트 등록·관측성 추가·Microsoft 365 데이터 연결·로컬 테스트로 이어지는 반복 가능한 경로를 제공합니다.
결과적으로 더 빠르고 안전한 온보딩 경험을 얻게 됩니다. 에이전트가 Agent 365에 등록되고, Defender·Purview·Microsoft 365 관리 센터에서 가시성을 갖도록 계측되며, Work IQ MCP 서버를 통해 Microsoft 365 데이터에 연결되고, 배포 전에 로컬에서 테스트되는 것이죠.
한국 개발자·도입 담당자를 위한 시사점
- “오케스트레이션은 시작일 뿐”: 데모가 잘 되는 것과 사내 프로덕션에 올리는 것은 전혀 다른 문제입니다. Agent 365 Skills는 신원·관측성·거버넌스·메시징·데이터 연결이라는 운영 요소를 표준화된 경로로 묶어, 프로토타입에서 엔터프라이즈급 에이전트까지의 거리를 단축합니다.
- IT·보안 관점의 일관성: 개발자가 셋업 단계를 일일이 꿰어 맞추는 대신 일관된 등록·관측성·거버넌스 패턴을 따르게 되므로, 조직 전체의 에이전트 자산(agent estate)을 더 통일된 방식으로 관리할 수 있습니다. Defender·Purview·M365 관리 센터에서 에이전트 활동이 보인다는 점은 거버넌스 검토에 특히 유용합니다.
- 프레임워크 종속성 완화: LangChain·OpenAI·Semantic Kernel·Claude·Google ADK 등 팀마다 다른 선택을 하더라도, 동일한 온보딩 흐름으로 Agent 365에 합류시킬 수 있습니다. 멀티 프레임워크 환경을 운영하는 조직에 현실적인 장점입니다.
- 검토할 포인트: 사내 도입 시에는 인증 모드(OBO / Agentic-User / S2S) 선택 기준, WorkIQ로 접근할 Microsoft 365 데이터 범위, 에이전트가 Teams·이메일로 받을 메시지의 정책 등을 미리 정리해 두는 것이 좋습니다.
시작하기
스킬은 다음 명령으로 설치합니다.
gh skill add microsoft/agent365-skills
- GitHub 저장소: microsoft/agent365-skills
- 더 깊은 개발 가이드는 Microsoft Agent 365 개발자 문서를 참고하세요.
마무리
에이전트를 만드는 일은 점점 쉬워지고 있지만, 그 에이전트를 실제 업무에 안전하게 올리는 일은 여전히 어렵습니다. Agent 365 Skills는 바로 그 간극을 겨냥합니다. 개발자는 셋업 단계를 꿰어 맞추는 데 시간을 덜 쓰고, 비즈니스 문제를 푸는 에이전트를 만드는 데 더 집중할 수 있습니다. “한 문장이면 끝”이라는 경험이, 프로토타입과 프로덕션 사이의 거리를 얼마나 좁혀 줄지 직접 확인해 보시기 바랍니다.
원문: Agent 365 Skills: Bring your agents into Microsoft Agent 365 in minutes (Microsoft Tech Community, Agent 365 Blog) · 자세한 내용은 원문을 참조하세요.