Microsoft learning, made practical.교육 문의
MINA JIN. Client Portal
08 WIQD로 Agent Builder 선언적 에이전트 만들기
단계 02

WIQD로 Agent Builder 선언적 에이전트 만들기 약 20분

WIQD를 사용하기 위한 개발 환경 확인

휴대폰의 계정·앱·권한을 준비하듯 VS Code, GitHub Copilot, Node.js, WIQD와 Microsoft 365 계정을 구분해 준비해요.

1

시작하기 전에 준비물을 확인해요

각 도구가 맡은 일이 달라요

준비물왜 필요한가요?쉽게 비유하면
VS Code프로젝트 폴더와 설정 파일을 보고 수정하는 화면이에요.앱을 만드는 작업 책상
GitHub Copilot과 사용할 호스트말로 요청하고 수정 내용을 확인해요. VS Code 확장과 Copilot CLI는 서로 다른 실행 환경이에요.함께 작업하는 도우미와 대화 창
Node.js 24.15 이상 · npm현재 공식 Installation 문서의 CLI 설치 경로 요구 사항이에요. Getting Started는 24+로 요약하므로 세부 설치 기준도 확인해요.개발 도구를 움직이는 기본 엔진
WIQD CLIwiqd 명령으로 프로젝트·검증·인증·프로비저닝 등을 다뤄요.설정 작업을 수행하는 공구
호스트용 WIQD 플러그인 / SkillCopilot 등 코딩 도우미에게 WIQD 작업 방법을 알려 줘요. CLI 설치와 별개예요.도우미가 읽는 작업 매뉴얼
Microsoft 365 계정과 Copilot 접근 권한완성한 에이전트를 설치하고 사용할 조직·라이선스·정책을 확인해요.회사 앱에 들어가는 내 출입증
필요한 도구의 연결·권한Outlook, 외부 MCP 등의 이용 조건과 조직 허용 여부를 확인해요.메일·달력 앱의 접근 권한
↑ 맨 위로
2

Windows에서 WIQD CLI를 준비해요

공식 설치 안내를 확인하고 PowerShell을 열어요

  • VS Code 위 메뉴에서 Terminal → New Terminal을 열고 PowerShell인지 확인해요.
  • 아래 명령은 공식 aka.ms 주소의 설치 스크립트를 받아 실행해요. 먼저 공식 문서와 스크립트 출처·내용, 회사의 설치 정책을 확인하고 본인이 실행해요.
  • 설치기는 Node.js 상태를 확인하고 WIQD CLI를 설치해요. VS Code 확장과 호스트 플러그인 설정은 선택 항목이거나 탐지된 환경에 따라 달라질 수 있어요.
  • EULA가 나타나면 내용을 읽고 본인이 동의 여부를 결정해요. AI에게 대신 약관에 동의하게 하지 않아요.
  • PATH나 확장 설치가 반영되지 않으면 터미널과 관련 호스트를 다시 열어요. 명령을 계속 반복 실행하기보다 오류 메시지를 먼저 읽어요.

Windows PowerShell · 공식 설치 명령

iex "& { $(irm 'https://aka.ms/wiqd/install.ps1') }"

설치됐는지 직접 확인해요

node --version은 엔진 버전, wiqd --version은 WIQD 버전을 보여줘요. wiqd doctor는 CLI와 관련 확장의 상태를 점검해요. 경고나 오류가 있으면 해당 항목을 해결하고, 화면에 나온 버전과 결과를 확인해요.

PPT에 보이는 v0.20.0은 촬영 당시 예시예요. 내 설치 버전과 다를 수 있어요. CLI 버전이 나온다고 Copilot 호스트 플러그인, M365 로그인, Outlook 도구까지 모두 준비된 것은 아니에요.

터미널에서 한 줄씩 실행해요

node --version
wiqd --version
wiqd doctor
↑ 맨 위로
3

GitHub Copilot 호스트에 WIQD 작업 방법을 알려 줘요

Copilot CLI의 공식 Marketplace 설치 경로

GitHub Copilot CLI를 사용하는 경우 공식 Getting Started의 Marketplace 경로로 WIQD 플러그인을 설치할 수 있어요. Copilot CLI가 먼저 설치·로그인되어 있고 필요한 이용 권한이 있어야 해요.

아래는 Copilot CLI를 쓰는 경로예요. VS Code Copilot Chat에 명령을 그대로 붙인다고 같은 설치가 보장되는 것은 아니에요.

  • 설치가 끝나면 Copilot 호스트의 새 세션을 시작해요. 이미 열린 세션에는 새 플러그인이 아직 반영되지 않을 수 있어요.
  • 공식 대안은 microsoft/wiqd Marketplace를 추가하고 wiqd@wiqd를 설치하는 경로예요. 여러 경로를 이유 없이 중복 설치하지 말고 문서와 현재 환경에 맞는 하나를 선택해요.
  • VS Code에서는 설치기의 WIQD 확장 안내를 확인하고, 현재 Copilot 세션에서 WIQD Skill·에이전트가 실제로 제공되는지 확인해요. 확장만 설치하면 모든 호스트가 자동 준비되는 것은 아니에요.

Copilot CLI를 사용할 때 · 호스트 플러그인 설치

copilot plugin install wiqd@awesome-copilot

VS Code Copilot에 설치 점검을 부탁해요

실습용 점검 프롬프트 · 설치·배포를 먼저 실행하지 않아요

이 VS Code에서 WIQD로 작업할 준비가 됐는지 확인해줘. Node.js 버전, WIQD CLI 버전과 doctor 결과, 현재 Copilot 세션의 WIQD Skill/에이전트 사용 가능 여부를 각각 나눠 알려줘. CLI 설치와 호스트 플러그인 설치를 혼동하지 말고, 빠진 항목과 공식 설치 경로를 알려줘. 설치, 약관 동의, 로그인, 에이전트 생성이나 배포는 아직 실행하지 마.
↑ 맨 위로
공식 WIQD 설치 가이드 · 최신 요구 사항 확인