Design Spec: Bộ Học Liệu "Azure AI Agent"
Tóm tắt dự án
Xây dựng bộ học liệu kỹ thuật chuyên sâu về Azure AI Agent / Microsoft Foundry Agent Service dưới dạng Docs trong Docusaurus, theo chuẩn sư phạm 4MAT, phục vụ đối tượng Intern/Junior Developer muốn học hệ sinh thái Azure AI.
Nguồn tài liệu: sources/documentations/learn.microsoft.com/en-us/azure/foundry/agents/
overview.md(17KB)concepts/— 25 files (agent identity, tools, workflows, memory, RAG, MCP, v.v.)how-to/— 45+ files (deploy, configure, debug, MCP auth, memory, VS Code, M365, v.v.)quickstarts/— 9 files
Quyết định thiết kế
| Hạng mục | Quyết định |
|---|---|
| Output format | docs/ — Docusaurus Docs với sidebar navigation |
| Cấu trúc | Tiered Category (nhóm theo chủ đề) |
| Đối tượng | Intern/Junior Developer |
| Phong cách | Giảng dạy thuần túy — Concept, Diagram, Analogy |
| Template | Sử dụng skillcreate-tech-lecture (4MAT: Why → What → How → What if) |
| Diagrams | Mermaid bắt buộc tại mỗi bước flow/architecture |
| Glossary | Bảng thuật ngữ đầu mỗi bài |
| Độ dài | 2.000–4.000 từ/bài, 15-20 phút đọc |
| Footer | "Made by Anh Tu - Share to be share" |
Cấu trúc thư mục Docs
docs/
└── azure-ai-agent/
├── index.md ← Landing page: "Lộ trình học Azure AI Agent"
│
├── 01-foundations/ ← Category: Nền tảng (Module 1)
│ ├── index.md
│ ├── what-is-ai-agent.md
│ ├── microsoft-foundry.md
│ ├── development-approaches.md
│ ├── first-agent-foundry.md
│ ├── vscode-setup.md
│ ├── agent-tools-overview.md
│ └── deploy-integrate.md
│
├── 02-tools/ ← Category: Công cụ (Module 2, 3)
│ ├── index.md
│ ├── custom-tools-why.md ← Module 2
│ ├── custom-tools-options.md
│ ├── custom-tools-integrate.md
│ ├── mcp-discovery.md ← Module 3
│ ├── mcp-server-client.md
│ └── mcp-azure-agents.md
│
├── 03-knowledge/ ← Category: Knowledge & RAG (Module 4)
│ ├── index.md
│ ├── rag-for-agents.md
│ ├── foundry-iq-overview.md
│ ├── data-sources-config.md
│ └── retrieval-config.md
│
├── 04-integration/ ← Category: Tích hợp hệ sinh thái (Module 5, 9)
│ ├── index.md
│ ├── m365-publish-options.md ← Module 5
│ ├── m365-teams-publish.md
│ ├── m365-agents-toolkit.md
│ ├── work-iq.md
│ ├── a2a-protocol.md ← Module 9
│ ├── a2a-agent-executor.md
│ ├── a2a-server.md
│ └── a2a-connect.md
│
└── 05-orchestration/ ← Category: Workflow & Multi-Agent (Module 6, 7, 8)
├── index.md
├── workflows-overview.md ← Module 6
├── workflow-patterns.md
├── workflow-foundry.md
├── workflow-power-fx.md
├── agent-framework-intro.md ← Module 7
├── agent-framework-create.md
├── agent-framework-tools.md
├── multi-agent-overview.md ← Module 8
├── orchestration-concurrent.md
├── orchestration-sequential.md
├── orchestration-group.md
├── orchestration-handoff.md
└── orchestration-magentic.md
Tổng: 5 categories, ~35 files docs