microsoft/iq-series

The IQ Series와 함께 Microsoft IQ를 배워보세요! Microsoft IQ는 기업을 위한 Microsoft의 통합 지능 계층 (unified intelligence layer)으로, 세 가지 핵심 지능 서비스를 하나로 모읍니다:

Foundry IQ: 기업 데이터를 위한 관리형 지식 계층 (managed knowledge layer); Azure, SharePoint, OneLake 및 웹 전반의 정형 및 비정형 데이터를 연결하여 에이전트 (agents)가 권한을 인식하는 지식에 접근할 수 있도록 합니다.
Work IQ: Microsoft 365 Copilot을 개인화하는 지능 계층 (intelligence layer); 문맥 (context), 관계, 업무 패턴을 이해하여 에이전트가 더 빠르고, 정확하며, 더 안전하게 작동할 수 있도록 합니다.
Fabric IQ: 데이터, 모델 및 시스템 전반의 비즈니스 시맨틱 (business semantics)을 통합하여, 비즈니스에 대한 실시간적이고 총체적인 관점에 기반한 지능형 에이전트와 의사결정을 지원합니다.

이 IQ들은 함께 작동하여 AI 에이전트가 진정한 기업용 지능을 위해 전통적인 RAG (Retrieval-Augmented Generation)를 넘어 깊은 비즈니스 문맥을 바탕으로 추론, 검색 및 행동할 수 있도록 합니다.

참고: 이 시리즈는 Foundry IQ 에피소드로 시작합니다. Work IQ 및 Fabric IQ 콘텐츠는 곧 공개될 예정입니다!

📺 Foundry IQ 에피소드는 2026년 3월 18일부터 Microsoft Developer YouTube에서 매주 수요일 오전 9시 PT에 공개됩니다.

에피소드	설명	비디오	쿡북 (Cookbook)
Foundry IQ: 에이전트를 위한 지식 잠금 해제	Foundry IQ의 핵심 구성 요소와 에이전트 아키텍처 (agent architecture)에 어떻게 부합하는지 이해합니다	지금 시청하기 🎥	쿡북 (Cookbook)
Foundry IQ: 지식 소스를 활용한 데이터 파이프라인 구축	다양한 소스로부터 어떻게 서로 다른 콘텐츠가 Foundry IQ로 유입되는지 배웁니다	지금 시청하기 🎥	쿡북 (Cookbook)
...

세 가지 Foundry IQ 쿡북을 모두 완료하셨나요? 이제 커뮤니티 배지 (community badge)를 요청할 수 있습니다.

• 이 저장소 (repo)를 포크 (Fork)하고, 포크한 저장소에 노트북 (notebook) 출력물을 저장하세요.
• 각 에피소드에 대한 최종 출력 스크린샷을 캡처하세요.
• 배지 요청 이슈 (badge request issue)를 제출하세요.
• 필수 배지 양식을 작성하세요.

배지는 Global AI Community에서 발급하므로, 제출하기 전에 반드시 계정이 있는지 확인해 주세요.

각 에피소드에는 다음이 포함됩니다:

도입 (1분): 경영진 연설 기술 강연 (15분): 제품 그룹 및 옹호 활동가와의 상호 작용 토론 마무리 (1분): 낙서 요약**

에피소드 폴더에는 또한 실습을 위한 단계별 안내가 포함된 Jupyter 노트북 쿠크북이 포함되어 있습니다.

필요한 모든 Azure 리소스(AI Search, Azure OpenAI, Foundry 프로젝트, Azure Blob Storage 및 사용 가능한 지식 기반과 함께 시드된 샘플 데이터)를 배포하려면 위의 버튼을 클릭하십시오.

배포 양식에서:

새 리소스 그룹 생성(예: iq-series-rg):
리소스 그룹 필드 아래의 **새로 만들기(Create new)**를 클릭하고 다음 **사용자 개체 ID(User Object ID)**를 입력합니다. 터미널에서 다음을 실행하여 가져올 수 있습니다:

az login
az ad signed-in-user show --query id -o tsv

필요에 따라 리소스 접두사, 위치 및 SKU를 사용자 지정한 후 **검토 + 생성(Review + create)**을 클릭합니다.

배포가 완료되면 배포 출력(Outputs) 탭에서 Azure AI Search 엔드포인트와 API 키를 복사하십시오. 다음 단계에서 필요합니다.

⚠️ 문제 해결: 배포 스크립트 실패? 일부 Azure 테넌트는 스토리지 계정에 대한 키 기반 액세스를 차단하는 정책을 시행합니다. 이로 인해 다른 모든 리소스가 성공적으로 배포되는 동안 데이터 시딩(data seeding) 스크립트가 실패할 수 있습니다. 이런 경우, 사용자의 Azure 리소스(AI Search, OpenAI, Foundry 프로젝트 등)는 완전히 배포되었으며 샘플 데이터와 지식 기반 설정만 누락된 상태입니다. 다음 대안 중 하나를 사용하여 데이터를 수동으로 시딩할 수 있습니다:

에피소드 1 쿠크북 실행: 에피소드 1 쿠크북을 열고 처음부터 끝까지 실행합니다. 이는 NASA의

Codespace를 실행하고 GitHub Copilot과 함께 Foundry IQ를 탐색해 보세요. Copilot은 MCP를 통해 배포된 지식 베이스 (knowledge base)에 연결됩니다. 데이터에 대해 질문하면 근거가 있고 인용된 답변을 얻을 수 있습니다.

위의 버튼을 클릭하여 Codespace를 엽니다.

.vscode/mcp.json 파일을 열고 두 개의 플레이스홀더 (placeholder)를 배포 Outputs 탭의 값으로 교체하세요:
<your-search-service>
→ 귀하의 AI Search 서비스 이름
<your-search-api-key>
→ 귀하의 AI Search 관리자 API 키

foundry-iq 도구 활성화 (중요!): Copilot Chat을 열고, 채팅 패널 상단의 🔧 Tools 아이콘을 클릭합니다. 도구 목록을 스크롤하여 foundry-iq를 찾아 on으로 토글합니다. 이 단계를 건너뛰면 Copilot이 지식 베이스 (knowledge base)를 쿼리할 수 없습니다.

Copilot에게 지식 베이스 (knowledge base)에 대해 질문해 보세요. 다음 질문들을 시도해 보세요:

*"우주에서 본 지구의 밤 모습은 어떤가요?"
*"과학자들은 도시화를 연구하기 위해 야간 조명을 어떻게 사용하나요?"
*"지구에서 밤에 가장 밝은 지역은 어디이며 그 이유는 무엇인가요?"

어떤 쿠크북 (cookbook) 노트북을 열더라도 Copilot을 사용하여 학습과 실험을 진행할 수 있습니다:

*"이 노트북이 수행하는 작업을 단계별로 설명해 줘"
*"지식 소스 (knowledge source)와 지식 베이스 (knowledge base)의 차이점은 무엇인가요?"
*"다른 인덱스 (index)를 사용하여 새로운 지식 베이스 (knowledge base)를 만드는 것을 도와줘"

리포지토리 (repo)를 로컬에서 사용할 수도 있습니다. 리포지토리를 클론 (clone)하고 VS Code에서 연 다음, .vscode/mcp.json을 귀하의 값으로 업데이트하면 MCP 서버가 Copilot Chat Tools에 나타납니다.

쿠크북 노트북은 단계 1에서 배포한 동일한 Azure 리소스 (Azure resources)를 재사용합니다. 따라서 각 에피소드마다 다시 배포할 필요가 없습니다. 각 쿠크북 폴더에는 엔드포인트 (endpoint) 값이 포함된 자체 .env 파일이 필요합니다:

• Azure portal로 이동 → 귀하의 배포 항목 → Outputs 탭으로 이동
• 에피소드의 cookbook/ 폴더 내에 .env 파일을 생성합니다 (예: 1-Foundry-IQ-Unlocking-Knowledge-for-Agents/cookbook/.env)
• Outputs 탭의 값을 붙여넣습니다 — 필요한 정확한 변수는 각 쿠크북의 README를 참조하세요.

📍 각 에피소드의 .env 파일은 어디에 위치해야 하나요?
cookbook/ 폴더는 자체적인 .env 파일을 기대합니다.

파일입니다. 노트북은 노트북의 위치를 기준으로 상대적인 경로에 있는 .env 파일을 dotenv를 사용하여 로드합니다.

저희 리포지토리(repo)에 기여하고, 질문을 통해 전문가들과 소통하는 모습을 보고 싶습니다!

• 🤔 제안 사항이 있거나 철자 또는 코드 오류를 발견하셨나요? 이슈(Issue)를 제기하거나 풀 리퀘스트(Pull Request)를 생성해 주세요.
• 🚀 진행 중 막히는 부분이 있거나 Microsoft IQ에 대해 궁금한 점이 있다면, 저희 Discord에 참여하세요.
• 기여(Contributing) 및 상표(Trademarks) 세부 사항을 확인해 주세요.