Xây dựng, kiểm tra và triển khai các tác nhân AI tới Dịch vụ Tác nhân Microsoft Foundry như Các Tác nhân Lưu trữ - hoàn toàn từ VS Code sử dụng tiện ích mở rộng Microsoft Foundry và Bộ công cụ Foundry.
Các Tác nhân Lưu trữ hiện đang trong giai đoạn xem trước. Các khu vực hỗ trợ còn hạn chế - xem khả năng sẵn có theo khu vực.
Thư mục
agent/bên trong mỗi bài lab được tự động tạo khung bởi tiện ích mở rộng Foundry - bạn sau đó tùy chỉnh mã, kiểm tra cục bộ và triển khai.
Tiếng Ả Rập | Tiếng Bengali | Tiếng Bulgaria | Tiếng Miến Điện (Myanmar) | Tiếng Trung (Giản thể) | Tiếng Trung (Phồn thể, Hồng Kông) | Tiếng Trung (Phồn thể, Ma Cao) | Tiếng Trung (Phồn thể, Đài Loan) | Tiếng Croatia | Tiếng Séc | Tiếng Đan Mạch | Tiếng Hà Lan | Tiếng Estonia | Tiếng Phần Lan | Tiếng Pháp | Tiếng Đức | Tiếng Hy Lạp | Tiếng Hebrew | Tiếng Hindi | Tiếng Hungary | Tiếng Indonesia | Tiếng Ý | Tiếng Nhật | Tiếng Kannada | Tiếng Khmer | Tiếng Hàn | Tiếng Litva | Tiếng Malay | Tiếng Malayalam | Tiếng Marathi | Tiếng Nepal | Tiếng Pidgin Nigeria | Tiếng Na Uy | Tiếng Ba Tư (Farsi) | Tiếng Ba Lan | Tiếng Bồ Đào Nha (Brazil) | Tiếng Bồ Đào Nha (Bồ Đào Nha) | Tiếng Punjabi (Gurmukhi) | Tiếng Romania | Tiếng Nga | Tiếng Serbia (Chữ Kirin) | Tiếng Slovakia | Tiếng Slovenia | Tiếng Tây Ban Nha | Tiếng Swahili | Tiếng Thụy Điển | Tiếng Tagalog (Filipino) | Tiếng Tamil | Tiếng Telugu | Tiếng Thái | Tiếng Thổ Nhĩ Kỳ | Tiếng Ukraina | Tiếng Urdu | Tiếng Việt
Ưu tiên sao chép về máy?
Kho lưu trữ này bao gồm hơn 50 bản dịch ngôn ngữ, làm tăng đáng kể kích thước tải xuống. Để sao chép mà không có bản dịch, hãy dùng sparse checkout:
Bash / macOS / Linux:
git clone --filter=blob:none --sparse https://github.com/microsoft-foundry/Foundry_Toolkit_for_VSCode_Lab.git cd Foundry_Toolkit_for_VSCode_Lab git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'CMD (Windows):
git clone --filter=blob:none --sparse https://github.com/microsoft-foundry/Foundry_Toolkit_for_VSCode_Lab.git cd Foundry_Toolkit_for_VSCode_Lab git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"Điều này cung cấp cho bạn tất cả những gì cần để hoàn thành khóa học với tốc độ tải về nhanh hơn nhiều.
flowchart TB
subgraph Local["Phát Triển Cục Bộ (VS Code)"]
direction TB
FE["Tiện Ích Microsoft Foundry"]
FoundryToolkit["Tiện Ích Foundry Toolkit"]
Scaffold["Mã Đại Lý Được Tạo Sẵn
(main.py · agent.yaml · Dockerfile)"]
Inspector["Trình Kiểm Tra Đại Lý
(Kiểm Tra Cục Bộ)"]
FE -- "Tạo Đại Lý
Được Lưu Trữ Mới" --> Scaffold
Scaffold -- "Gỡ Lỗi F5" --> Inspector
FoundryToolkit -.- Inspector
end
subgraph Cloud["Microsoft Foundry"]
direction TB
ACR["Đăng Ký Azure Container"]
AgentService["Dịch Vụ Đại Lý Foundry
(Thời Gian Chạy Đại Lý Được Lưu Trữ)"]
Model["Azure OpenAI
(gpt-4.1 / gpt-4.1-mini)"]
Playground["Sân Chơi Foundry
& Sân Chơi VS Code"]
ACR --> AgentService
AgentService -- "/responses API" --> Model
AgentService --> Playground
end
Scaffold -- "Triển Khai
(Xây dựng Docker + đẩy)" --> ACR
Inspector -- "POST /responses
(localhost:8088)" --> Scaffold
Playground -- "Thử Lời Gợi Ý" --> AgentService
style Local fill:#f0f4ff,stroke:#4a6cf7,stroke-width:2px
style Cloud fill:#fff4e6,stroke:#f59e0b,stroke-width:2px
Luồng: Tiện ích mở rộng Foundry tạo khung tác nhân → bạn tùy chỉnh mã & hướng dẫn → kiểm tra cục bộ với Agent Inspector → triển khai lên Foundry (hình ảnh Docker được đẩy lên ACR) → xác minh trong Playground.
| Lab | Mô tả | Trạng thái |
|---|---|---|
| Lab 01 - Tác nhân đơn | Xây dựng Tác nhân "Giải thích như tôi là một Giám đốc điều hành", kiểm tra cục bộ và triển khai lên Foundry | ✅ Có sẵn |
| Lab 02 - Quy trình làm việc đa tác nhân | Xây dựng "Đánh giá Sơ yếu lý lịch → phù hợp công việc" - 4 tác nhân phối hợp để đánh giá độ phù hợp của sơ yếu lý lịch và tạo lộ trình học tập | ✅ Có sẵn |
Trong hội thảo này bạn sẽ xây dựng Tác nhân "Giải thích như tôi là một Giám đốc điều hành" - một tác nhân AI giúp dịch những thuật ngữ kỹ thuật rắc rối thành các bản tóm tắt bình tĩnh, sẵn sàng trình bày ở phòng họp. Bởi vì thành thật mà nói, không ai trong ban giám đốc muốn nghe về "cạn kiệt thread pool do các cuộc gọi đồng bộ được giới thiệu trong bản v3.2."
Tôi xây dựng tác nhân này sau quá nhiều lần sự cố mà bài viết hậu sự hoàn hảo của tôi nhận được phản hồi: "Vậy... website có bị lỗi hay không?"
Bạn cung cấp một bản cập nhật kỹ thuật. Tác nhân sẽ trả lại một bản tóm tắt dành cho giám đốc - ba điểm chính, không biệt ngữ, không tracing, không gây lo lắng. Chỉ có điều gì đã xảy ra, ảnh hưởng kinh doanh, và bước tiếp theo.
Bạn nói:
"Độ trễ API tăng do cạn kiệt thread pool gây ra bởi các cuộc gọi đồng bộ được giới thiệu trong v3.2."
Tác nhân trả lời:
Tóm tắt Giám đốc:
- Điều gì đã xảy ra: Sau bản phát hành mới nhất, hệ thống bị chậm lại.
- Ảnh hưởng kinh doanh: Một số người dùng gặp trễ khi sử dụng dịch vụ.
- Bước tiếp theo: Thay đổi đã được hoàn tác và một bản sửa đang được chuẩn bị trước khi triển khai lại.
Nó là một tác nhân đơn giản, mục đích duy nhất - hoàn hảo để học quy trình tác nhân lưu trữ từ đầu đến cuối mà không bị vướng mắc vào các chuỗi công cụ phức tạp. Và thật lòng mà nói? Mỗi nhóm kỹ thuật đều có thể sử dụng một con như thế này.
📂 Foundry_Toolkit_for_VSCode_Lab/
├── 📄 README.md ← You are here
├── 📂 ExecutiveAgent/ ← Standalone hosted agent project
│ ├── agent.yaml
│ ├── Dockerfile
│ ├── main.py
│ └── requirements.txt
└── 📂 workshop/
├── 📂 lab01-single-agent/ ← Full lab: docs + agent code
│ ├── README.md ← Hands-on lab instructions
│ ├── 📂 docs/ ← Step-by-step tutorial modules
│ │ ├── 00-prerequisites.md
│ │ ├── 01-install-foundry-toolkit.md
│ │ ├── 02-create-foundry-project.md
│ │ ├── 03-create-hosted-agent.md
│ │ ├── 04-configure-and-code.md
│ │ ├── 05-test-locally.md
│ │ ├── 06-deploy-to-foundry.md
│ │ ├── 07-verify-in-playground.md
│ │ └── 08-troubleshooting.md
│ └── 📂 agent/ ← Reference solution (auto-scaffolded by Foundry extension)
│ ├── agent.yaml
│ ├── Dockerfile
│ ├── main.py
│ └── requirements.txt
└── 📂 lab02-multi-agent/ ← Resume → Job Fit Evaluator
├── README.md ← Hands-on lab instructions (end-to-end)
├── 📂 docs/ ← Step-by-step tutorial modules
│ ├── 00-prerequisites.md
│ ├── 01-understand-multi-agent.md
│ ├── 02-scaffold-multi-agent.md
│ ├── 03-configure-agents.md
│ ├── 04-orchestration-patterns.md
│ ├── 05-test-locally.md
│ ├── 06-deploy-to-foundry.md
│ ├── 07-verify-in-playground.md
│ └── 08-troubleshooting.md
└── 📂 PersonalCareerCopilot/ ← Reference solution (multi-agent workflow)
├── agent.yaml
├── Dockerfile
├── main.py
└── requirements.txt
Lưu ý: Thư mục
agent/bên trong mỗi bài lab là những gì tiện ích mở rộng Microsoft Foundry tạo ra khi bạn chạyMicrosoft Foundry: Create a New Hosted Agenttừ Command Palette. Các tệp sau đó được tùy chỉnh với hướng dẫn, công cụ và cấu hình của tác nhân bạn. Lab 01 hướng dẫn bạn tạo lại điều này từ đầu.
git clone https://github.com/microsoft-foundry/Foundry_Toolkit_for_VSCode_Lab.git
cd Foundry_Toolkit_for_VSCode_Labpython -m venv venvKích hoạt nó:
- Windows (PowerShell):
.\venv\Scripts\Activate.ps1
- macOS / Linux:
source venv/bin/activate
pip install -r workshop/lab01-single-agent/agent/requirements.txtSao chép file mẫu .env bên trong thư mục agent và điền giá trị của bạn:
cp workshop/lab01-single-agent/agent/.env.example workshop/lab01-single-agent/agent/.envChỉnh sửa workshop/lab01-single-agent/agent/.env:
AZURE_AI_PROJECT_ENDPOINT=https://<your-account>.services.ai.azure.com/api/projects/<your-project>
MODEL_DEPLOYMENT_NAME=<your-model-deployment-name>Mỗi bài lab tự chứa với các module riêng. Bắt đầu với Lab 01 để học các kiến thức cơ bản, rồi chuyển sang Lab 02 cho quy trình đa tác nhân.
Lab 01 - Tác nhân đơn (hướng dẫn đầy đủ)
| # | Module | Liên kết |
|---|---|---|
| 1 | Đọc các yêu cầu cần thiết | 00-prerequisites.md |
| 2 | Cài đặt Foundry Toolkit & tiện ích mở rộng Foundry | 01-install-foundry-toolkit.md |
| 3 | Tạo dự án Foundry | 02-create-foundry-project.md |
| 4 | Tạo một tác nhân lưu trữ | 03-create-hosted-agent.md |
| 5 | Cấu hình hướng dẫn & môi trường | 04-configure-and-code.md |
| 6 | Kiểm tra cục bộ | 05-test-locally.md |
| 7 | Triển khai lên Foundry | 06-deploy-to-foundry.md |
| 8 | Xác minh trong playground | 07-verify-in-playground.md |
| 9 | Xử lý sự cố | 08-troubleshooting.md |
Lab 02 - Quy trình làm việc đa tác nhân (hướng dẫn đầy đủ)
| # | Module | Liên kết |
|---|---|---|
| 1 | Yêu cầu cần thiết (Lab 02) | 00-prerequisites.md |
| 2 | Hiểu kiến trúc đa tác nhân | 01-understand-multi-agent.md |
| 3 | Tạo khung dự án đa tác nhân | 02-scaffold-multi-agent.md |
| 4 | Cấu hình các tác nhân & môi trường | 03-configure-agents.md |
| 5 | Mẫu điều phối | 04-orchestration-patterns.md |
| 6 | Kiểm tra cục bộ (đa tác nhân) | 05-test-locally.md |
| 7 | Triển khai lên Foundry | 06-deploy-to-foundry.md |
| 8 | Xác minh trong playground | 07-verify-in-playground.md |
| 9 | Khắc phục sự cố (đa tác nhân) | 08-troubleshooting.md |
 Shivam Goyal |
| Kịch bản | Vai trò cần thiết |
|---|---|
| Tạo dự án Foundry mới | Azure AI Owner trên tài nguyên Foundry |
| Triển khai dự án hiện có (tài nguyên mới) | Azure AI Owner + Contributor trên subscription |
| Triển khai dự án đã cấu hình đầy đủ | Reader trên tài khoản + Azure AI User trên dự án |
Quan trọng: Vai trò
OwnervàContributorcủa Azure chỉ bao gồm quyền quản lý, không bao gồm quyền phát triển (hành động dữ liệu). Bạn cần Azure AI User hoặc Azure AI Owner để xây dựng và triển khai các tác nhân.
- Bắt đầu nhanh: Triển khai tác nhân được lưu trữ đầu tiên của bạn (VS Code)
- Tác nhân được lưu trữ là gì?
- Tạo luồng công việc tác nhân được lưu trữ trong VS Code
- Triển khai tác nhân được lưu trữ
- RBAC cho Microsoft Foundry
- Mẫu tác nhân đánh giá kiến trúc - Tác nhân được lưu trữ thực tiễn với các công cụ MCP, sơ đồ Excalidraw và triển khai kép
Tuyên bố từ chối trách nhiệm:
Tài liệu này đã được dịch bằng dịch vụ dịch thuật AI Co-op Translator. Mặc dù chúng tôi cố gắng đảm bảo độ chính xác, xin lưu ý rằng bản dịch tự động có thể chứa lỗi hoặc sự không chính xác. Tài liệu gốc bằng ngôn ngữ gốc nên được coi là nguồn xác thực nhất. Đối với các thông tin quan trọng, nên sử dụng dịch vụ dịch thuật chuyên nghiệp do con người thực hiện. Chúng tôi không chịu trách nhiệm đối với bất kỳ sự hiểu lầm hoặc giải thích sai nào phát sinh từ việc sử dụng bản dịch này.