스킬: ai901.practice_labs.micro.validated
설명: 실행 가능하고 자체 검증이 가능한 짧은 AI-901 실습 랩(15-25분)을 만듭니다. 모든 랩에는 사전 준비 사항, 정확한 작업, 검증 단계, 예상 출력 및 정리 단계가 포함됩니다.
강좌 맥락
이 스킬은 C:\github\ai901 경로에 있는 Tim Warner의 Microsoft Press AI-901 비디오 강좌 동반 리포지토리를 지원합니다. 이 강좌는 16개 레슨으로 구성된 Microsoft Press 비디오 강좌입니다. 레슨 01-07은 AI-901 도메인 1에 해당하는 개념 레슨입니다. 레슨 08-16은 AI-901 도메인 2에 해당하는 빌드 레슨입니다. 각 레슨은 lessons/lesson-NN/README.md에 있습니다. 특정 레슨을 지원하기 위해 랩이 빌드되는 경우, 학습자가 레슨 계획 옆에서 찾을 수 있도록 랩 아티팩트를 lessons/lesson-NN/labs/ 아래에 저장합니다.
대상 학습자
AI-901 대상 학습자는 AI 솔루션 개발 경력의 초기 단계에 있습니다. 학습자는 Azure의 AI에 대한 개념적 지식을 가지고 있고, Python 코딩 구문을 읽을 수 있으며, Azure 리소스에 익숙합니다. 랩의 문체는 따뜻하고 직접적입니다. 레슨에서 아직 소개하지 않은 전문 용어는 사용하지 않습니다.
스타일 우선 순위
시험 문구(제목, 목표 설명, 명명된 리소스, 회사 참조)를 반영하는 텍스트에는 Microsoft Worldwide Learning Exam Writing Style Guide(WWL)을 따릅니다. 랩 문체 자체에는 Microsoft Writing Style Guide(MWSG)를 따릅니다: 따뜻하고, 쉽게 훑어볼 수 있으며, 현재 시제, 문장 스타일 대문자 사용을 적용합니다. 랩에 대해 WWL이 MWSG보다 우선하는 두 가지 규칙: 축약형 사용 금지 및 키 이름은 모두 대문자(TAB, ENTER, CTRL+ALT+DELETE)입니다.
랩 카테고리
AI-901 랩은 AI-901 빌드 도메인에 매핑되는 네 가지 실용적인 카테고리에 걸쳐 있습니다.
- foundry-portal -- Microsoft Foundry 포털 실습. 모델 카탈로그의 모델 배포, 플레이그라운드 실험, 단일 에이전트 빌드, 프롬프트 흐름 검사, 포털 내에서 완전히 구성되는 접지된 채팅.
- foundry-sdk -- azure-ai-projects 및 azure-ai-agents 패키지로 Microsoft Foundry 엔드포인트를 호출하는 Python 3.12 클라이언트 앱. 인증은 DefaultAzureCredential을 통해 키 없이 수행됩니다. 패턴에는 채팅 완성, 다중 턴 대화, 단일 에이전트 호출 및 도구 강화 에이전트가 포함됩니다.
- ai-services -- Microsoft Foundry Tools를 통해 사용되는 Azure AI Language, Azure AI Speech 및 Azure AI Vision. 예로는 텍스트 분석, 감정 분석, 핵심 구문, 개체 인식, 음성-텍스트, 텍스트-음성, 이미지 분석, 광학 문자 인식 및 이미지 생성이 있습니다.
- content-understanding -- 문서, 이미지, 오디오 및 비디오의 네 가지 지원되는 양식에 걸친 Azure Content Understanding 분석기. 분석기 생성, 스키마 정의, 샘플 입력 실행 및 출력 검증이 포함됩니다.
카테고리별 기본 제작 도구:
- foundry-portal 랩의 경우, 기본 경로는
ai.azure.com의 Microsoft Foundry 포털입니다. - foundry-sdk 랩의 경우, 기본 경로는 Foundry SDK 및 DefaultAzureCredential을 사용한 Python 3.12입니다. API 키를 기본값으로 사용하지 마십시오.
- ai-services 랩의 경우, 기본 경로는 Microsoft Foundry 포털입니다. 자동화가 필요한 경우, 테넌트 측 리소스 작업에 Azure CLI를 사용합니다.
- content-understanding 랩의 경우, 기본 경로는 Microsoft Foundry 포털입니다. 코드가 필요한 경우, 키 없는 인증과 함께 Python 3.12를 사용합니다.
접지
필수 출처:
- Microsoft Learn(서비스 기능, 구성 및 아키텍처에 대한 진실 공급원). Microsoft Learn MCP 서버(
ai901buddy-mslearn)를 통해microsoft_docs_search및microsoft_docs_fetch를 사용하여 액세스합니다. - Microsoft Learn 코드 샘플(Python SDK, Azure CLI 및 Bicep 정확성 확인용).
microsoft_code_sample_search를 통해 액세스합니다. - 정식 AI-901 목표 도메인 파일:
.claude/skills/_references/ai901-objective-domain.md.
항상 먼저 접지하십시오. 서비스 기능, 모델 이름 또는 SKU 옵션을 임의로 만들지 마십시오.
AI-901 도메인(정식)
측정된 기술 날짜: 2026년 4월 15일.
| 도메인 | 가중치 |
|---|---|
| AI 개념 및 기능 식별 | 40-45% |
| Microsoft Foundry를 사용하여 AI 솔루션 구현 | 55-60% |
도메인 1은 개념 레슨 01-07을 다룹니다(실습 랩은 필요하지 않지만, 선택적 성찰 실습은 허용됨). 도메인 2는 빌드 레슨 08-16을 다루며 랩 작업의 주요 출처입니다.
스타일 및 단어 사용
리소스 및 사람 이름 지정(WWL)
- 회사: 아래 표에서 WWL 승인 가상 회사만 사용하십시오. 모든 언급에서 회사 이름 전체를 사용하십시오.
- 사람: the user 또는 User1, User2, User3(공백 없음).
- 서버: Server1, Server2; Exch1, Exch2; SQL1, SQL2; DC1, DC2; DNS1, DNS2.
- 컴퓨터: Computer1, Computer2. 애플리케이션: App1, App2. 서브넷: Subnet1, Subnet2. 사이트: Site1, Site2.
- 사무실: main office, branch office, satellite office. 도시: WWL 승인(애틀랜타, 보스턴, 카이로, 프랑크푸르트, 런던, 뉴욕, 파리, 시애틀, 싱가포르, 시드니, 도쿄 등).
- 각 이름은 첫 번째 언급 시 정의합니다.
승인된 가상 회사(WWL 가상 이름 목록)
항상 회사 이름 전체를 사용하십시오. 목록 전체에서 무작위로 선택하십시오. Contoso, Ltd.를 기본값으로 사용하지 마십시오.
| 회사 | 승인된 URL |
|---|---|
| A. Datum Corporation | adatum.com |
| Adventure Works Cycles | adventure-works.com |
| Alpine Ski House | alpineskihouse.com |
| Bellows College | bellowscollege.com |
| Best For You Organics Company | bestforyouorganics.com |
| Blue Yonder Airlines | blueyonderairlines.com |
| City Power & Light | cpandl.com |
| Coho Vineyard | cohovineyard.com |
| Coho Winery | cohowinery.com |
| Coho Vineyard & Winery | cohovineyardandwinery.com |
| Consolidated Messenger | consolidatedmessenger.com |
| Contoso, Ltd. | contoso.com |
| Contoso Pharmaceuticals | contoso.com |
| Contoso Suites | contososuites.com |
| Fabrikam, Inc. | fabrikam.com |
| Fabrikam Residences | fabrikamresidences.com |
| First Up Consultants | firstupconsultants.com |
| Fourth Coffee | fourthcoffee.com |
| Graphic Design Institute | graphicdesigninstitute.com |
| Humongous Insurance | humongousinsurance.com |
| Lamna Healthcare Company | lamnahealthcare.com |
| Liberty's Delightful Bakery & Cafe | libertysdelightfulbakeryandcafe.com |
| Litware, Inc. | litwareinc.com |
| Lucerne Publishing | lucernepublishing.com |
| Margie's Travel | margiestravel.com |
| Munson's Pickles and Preserves Farm | munsonspicklesandpreservesfarm.com |
| Nod Publishers | nodpublishers.com |
| Northwind Electric Cars | northwindelectriccars.com |
| Northwind Traders | northwindtraders.com |
| Proseware, Inc. | proseware.com |
| Relecloud | relecloud.com |
| School of Fine Art | fineartschool.net |
| Southridge Video | southridgevideo.com |
| Tailspin Toys | tailspintoys.com |
| The Phone Company | thephone-company.com |
| Trey Research | treyresearch.net |
| VanArsdel, Ltd. | vanarsdelltd.com |
| Wide World Importers | wideworldimporters.com |
| Wingtip Toys | wingtiptoys.com |
| Woodgrove Bank | woodgrovebank.com |
단어 사용(WWL)
- 이름이 지정된, 호출된이 아님.
- 보고, 불평이 아님.
- 결정 사용 금지; 확인, 식별, 설정, 수립, 계산, 결정을 사용하십시오.
- ~할 수도 있다 사용 금지; ~할 수 있다 또는 ~할지도 모른다를 사용하십시오.
- 사용하여 단독 사용 금지; 사용하여를 사용하십시오.
- 특정 결정자(모든, 전혀, 오직, 항상, 절대) 및 무한정 한정사(소수의, 많은, 여러 개의, 몇몇, 일부, 보통)를 피하십시오.
- site는 논리적, location은 물리적 -- 절대 상호 교환하지 마십시오.
- *(s)보다는 복수형을 사용하십시오.
- 목표 설명: You need to ... / You need to ensure that ...
서식
- 클릭 가능한 UI 요소, Azure CLI 명령 및 있는 그대로 입력되는 Python 클래스 또는 메서드 이름은 굵게 표시합니다.
- 입력 중립 동사: 선택(클릭 아님), 입력(타이핑 아님), 이동, 열기, 닫기.
- 절차 단계에서는 명령형을 사용합니다.
- 파일 이름은 file 레이블과 함께 표시: main.py 파일, deploy.bicep 파일.
- 키 이름은 모두 대문자: TAB, ENTER, CTRL+ALT+DELETE.
- 다른 곳에서는 문장 스타일 대문자 사용; 제품 이름과 고유 명사는 예외입니다.
- 세 개 이상 목록에서는 옥스포드 쉼표를 사용합니다.
- 일반 ASCII -- 곱은 따옴표, en 또는 em 대시 사용 금지;
--및->를 사용합니다. - 0부터 9까지는 철자로 표기하고, 10 이상은 숫자를 사용합니다.
세계화
- 문장은 15-20단어. 능동태. 단순 시제.
- 구두점으로
/또는-사용 금지(create/edit/display를 create, edit, and display로 대체). - 제품 이름에 소유격 사용 금지. 명사화 사용 금지. 명사 연속 사용 금지.
용어 이름 변경 표(변경 불가)
항상 최신 Microsoft 제품 이름을 사용하십시오. 사용자가 사용하더라도 사용 중단되었거나 레거시 이름은 절대 사용하지 마십시오. 자동으로 현재 이름에 매핑하십시오.
| 사용 중단/레거시 이름 | 현재 이름 |
|---|---|
| Azure Active Directory(Azure AD) | Microsoft Entra ID |
| Azure AD 테넌트 | Microsoft Entra 테넌트 |
| Azure AD 조건부 액세스 | Microsoft Entra 조건부 액세스 |
| Azure AD B2B / B2C | Microsoft Entra External ID |
| Azure AD PIM | Microsoft Entra Privileged Identity Management |
| Azure OpenAI Service(독립형, 브랜드 변경 후) | Microsoft Foundry의 Azure OpenAI |
| Azure AI Studio | Microsoft Foundry |
| Azure AI Foundry | Microsoft Foundry |
| Azure AI Foundry Tools | Microsoft Foundry Tools |
| Cognitive Services(포괄적) | Azure AI Services |
| Azure Cognitive Services for Language | Azure AI Language |
| Azure Cognitive Services for Speech | Azure AI Speech |
| Azure Cognitive Services for Vision | Azure AI Vision |
| Form Recognizer | Azure AI Document Intelligence |
| Custom Vision | Azure AI Vision(사용자 지정 이미지 분류 및 개체 감지) |
| LUIS | Azure AI Language 대화형 언어 이해 |
| QnA Maker | Azure AI Language 사용자 지정 질문 답변 |
인증 기본값(변경 불가)
코드 기반 랩의 경우:
- azure.identity 패키지의 DefaultAzureCredential을 사용합니다.
- 학습자는 스크립트를 실행하기 전에 az login으로 로그인합니다.
- 코드, 환경 파일 또는 구성 파일에 API 키를 절대 포함시키지 마십시오.
- Foundry 프로젝트 엔드포인트만이 유일한 비밀 형태 값입니다. PROJECT_ENDPOINT라는 이름의 환경 변수에 저장하십시오.
- 스크립트가 실행되기 전에 학습자에게 Foundry 프로젝트에 대한 Azure AI User 역할을 부여하십시오. 이를 시작 상태 요구 사항으로 포함하십시오.
가드레일
- AI-901 범위(기본 AI 개념 및 Microsoft Foundry 실습) 내에 머무르십시오. 전문가 수준의 코드 모델 교육이나 고급 MLOps는 피하십시오.
- 가장 저렴한 경로를 선호하십시오. 레슨에서 더 큰 모델을 필요로 하지 않는 한 gpt-4o-mini 또는 gpt-5-mini를 사용하십시오. 사용 가능한 경우 Azure AI Services 무료 F0 계층을 사용하십시오.
- 랩 어디에서도 축약형을 사용하지 마십시오.
- 여기저기 클릭해 보세요와 같은 모호한 단계는 없습니다. 모든 단계에는 정확한 UI 레이블, 정확한 Azure CLI 명령 또는 정확한 Python 문이 있습니다.
- 항상 정리 또는 롤백을 포함하십시오. 모델 배포, 에이전트 정의, AI Service 리소스, Content Understanding 분석기, 리소스 그룹 또는 스토리지 계정을 생성하는 랩의 경우, 정확한 삭제 단계를 나열하십시오.
정리 기대 사항(변경 불가)
정리는 모든 랩에서 변경 불가능합니다. 특정 AI-901 정리 대상은 다음과 같습니다.
- Microsoft Foundry의 모델 배포. My assets > Models + endpoints에서 삭제합니다.
- Agents 서비스에서 생성된 에이전트 정의. Foundry 포털의 Agents에서 삭제합니다.
- Azure AI Services 리소스(Language, Speech, Vision, Document Intelligence). Azure 포털에서 또는 az cognitiveservices account delete를 사용하여 삭제합니다.
- Content Understanding 분석기. Foundry 포털 Content Understanding 작업 영역에서 삭제합니다.
- 랩에서 생성한 Foundry 프로젝트 및 Foundry 허브.
- 랩 전용 리소스를 포함하는 리소스 그룹. az group delete --name --yes --no-wait를 사용하여 삭제합니다.
- 랩에서 프로비저닝한 스토리지 계정 및 업로드된 샘플 파일.
- 랩에서 생성한 로컬 Python 가상 환경 및 다운로드한 샘플 데이터.
정리 검증은 상위 범위를 나열하고 리소스가 사라졌음을 표시하여 삭제가 성공했는지 확인합니다.
비용 및 라이선스 경고 배치
랩에서 다음 중 하나라도 사용하는 경우, 사전 준비 사항 직후 및 시작 상태 전에 경고가 나타납니다.
- 128k 토큰보다 큰 컨텍스트 창을 가진 모델.
- 프리미엄 요금으로 청구되는 멀티모달 또는 추론 모델.
- Azure Content Understanding(페이지당, 이미지당, 분당 가격).
- Azure AI Speech 일괄 전사 또는 사용자 지정 음성.
- 대규모 Azure AI Vision Read OCR.
- 무료 계층 이상의 모든 Azure 리소스.
경고에는 비용 유발 요소, 대략적인 비용 규모 및 비용을 중지하는 정리 단계가 명시됩니다.
가상 회사 무작위화(변경 불가)
위의 WWL 승인 목록 전체에서 무작위로 선택하십시오. Contoso, Ltd.를 기본값으로 사용하지 마십시오. 항상 전체 회사 이름을 사용하십시오.
시간 제한 지침
랩에는 모든 작업을 통틀어 총 12단계를 초과할 수 없습니다. 더 많은 단계가 필요한 경우, 두 개의 더 좁은 범위의 랩으로 분할하십시오. 해당 레슨을 완료한 학습자의 목표 완료 시간은 15-25분입니다.
작업 흐름
.claude/skills/_references/ai901-objective-domain.md에서 단일 AI-901 목표를 선택하고 랩 상단에 명시합니다. 랩이 특정 레슨을 지원하는 경우, 레슨 폴더 이름(lessons/lesson-NN/)을 지정합니다.microsoft_docs_search를 사용하여 의도된 구성을 Microsoft Learn에서 접지합니다.- 랩 카테고리(Microsoft Foundry 포털, Python 3.12 + DefaultAzureCredential을 사용하는 Foundry SDK, Foundry Tools를 통한 Azure AI Services 또는 Content Understanding)와 일치하는 하나의 기본 경로를 선택합니다.
microsoft_code_sample_search를 사용하여 모든 Python, Azure CLI 또는 Bicep 코드 조각을 확인합니다.microsoft_docs_fetch를 사용하여 서비스 기능, SDK 클래스 또는 구성 단계에 대한 전체 페이지 세부 정보를 가져옵니다.- 각 주요 단계(포털 UI 상태, Azure CLI 출력, Python 스크립트 출력, 분석기 실행 결과) 후에 검증 게이트를 추가합니다.
- 작업을 정확히 되돌리는 정리를 추가하고, 최종 유효성 검사를 수행합니다.
(원본 내용이 잘렸으므로, 전체 내용을 반영하지 못할 수 있습니다. 전체 내용은 원본 SKILL.md를 참조하십시오.)