README.md

Scenario 3: Tài liệu trong trình soạn thảo với MCP Server trong VS Code

Tổng quan

Trong kịch bản này, bạn sẽ học cách đưa Microsoft Learn Docs trực tiếp vào môi trường Visual Studio Code của mình thông qua MCP server. Thay vì phải liên tục chuyển đổi giữa các tab trình duyệt để tìm kiếm tài liệu, bạn có thể truy cập, tìm kiếm và tham khảo tài liệu chính thức ngay trong trình soạn thảo. Cách tiếp cận này giúp quy trình làm việc của bạn trở nên mạch lạc hơn, giữ sự tập trung và cho phép tích hợp liền mạch với các công cụ như GitHub Copilot.

• Tìm kiếm và đọc tài liệu ngay trong VS Code mà không cần rời khỏi môi trường lập trình.
• Tham khảo tài liệu và chèn liên kết trực tiếp vào README hoặc các file khóa học.
• Sử dụng GitHub Copilot và MCP cùng nhau để có quy trình làm việc tài liệu hỗ trợ AI mượt mà.

Mục tiêu học tập

Kết thúc chương này, bạn sẽ hiểu cách thiết lập và sử dụng MCP server trong VS Code để nâng cao quy trình làm việc về tài liệu và phát triển. Bạn sẽ có khả năng:

• Cấu hình workspace để sử dụng MCP server cho việc tra cứu tài liệu.
• Tìm kiếm và chèn tài liệu trực tiếp từ bên trong VS Code.
• Kết hợp sức mạnh của GitHub Copilot và MCP để có quy trình làm việc hiệu quả hơn, được hỗ trợ bởi AI.

Những kỹ năng này sẽ giúp bạn duy trì sự tập trung, cải thiện chất lượng tài liệu và tăng năng suất làm việc với vai trò là nhà phát triển hoặc người viết tài liệu kỹ thuật.

Giải pháp

Để truy cập tài liệu ngay trong trình soạn thảo, bạn sẽ làm theo một loạt bước tích hợp MCP server với VS Code và GitHub Copilot. Giải pháp này rất phù hợp cho các tác giả khóa học, người viết tài liệu và nhà phát triển muốn giữ sự tập trung trong trình soạn thảo khi làm việc với tài liệu và Copilot.

• Nhanh chóng thêm liên kết tham khảo vào README khi viết tài liệu khóa học hoặc dự án.
• Dùng Copilot để tạo mã và MCP để tìm kiếm, trích dẫn tài liệu liên quan ngay lập tức.
• Giữ sự tập trung trong trình soạn thảo và tăng năng suất làm việc.

Hướng dẫn từng bước

Để bắt đầu, làm theo các bước dưới đây. Với mỗi bước, bạn có thể thêm ảnh chụp màn hình từ thư mục assets để minh họa trực quan quá trình.

1. Thêm cấu hình MCP: Tại thư mục gốc dự án, tạo một file .vscode/mcp.json và thêm cấu hình sau:

   {
     "servers": {
       "LearnDocsMCP": {
         "url": "https://learn.microsoft.com/api/mcp"
       }
     }
   }

   Cấu hình này giúp VS Code biết cách kết nối với Microsoft Learn Docs MCP server.

   

2. Mở bảng GitHub Copilot Chat: Nếu bạn chưa cài đặt tiện ích GitHub Copilot, hãy vào phần Extensions trong VS Code và cài đặt. Bạn có thể tải trực tiếp từ Visual Studio Code Marketplace. Sau đó, mở bảng Copilot Chat từ thanh bên.

   

3. Bật chế độ agent và kiểm tra công cụ: Trong bảng Copilot Chat, bật chế độ agent.

   

   Sau khi bật chế độ agent, kiểm tra xem MCP server có xuất hiện trong danh sách công cụ khả dụng không. Điều này đảm bảo agent của Copilot có thể truy cập server tài liệu để lấy thông tin liên quan.

   

4. Bắt đầu cuộc trò chuyện mới và hỏi agent: Mở một cuộc trò chuyện mới trong bảng Copilot Chat. Bạn có thể đặt câu hỏi về tài liệu cho agent. Agent sẽ sử dụng MCP server để truy xuất và hiển thị tài liệu Microsoft Learn liên quan ngay trong trình soạn thảo.

   • "Tôi đang cố gắng lập kế hoạch học tập cho chủ đề X. Tôi sẽ học trong 8 tuần, mỗi tuần đề xuất nội dung tôi nên học."

   

5. Truy vấn trực tiếp:

   Hãy lấy một truy vấn trực tiếp từ mục #get-help trong kênh Azure AI Foundry Discord (xem tin nhắn gốc):

   "Tôi đang tìm câu trả lời về cách triển khai giải pháp đa agent với các AI agent phát triển trên Azure AI Foundry. Tôi thấy không có phương pháp triển khai trực tiếp như kênh Copilot Studio. Vậy có những cách nào để triển khai cho người dùng doanh nghiệp tương tác và hoàn thành công việc?
   Có nhiều bài viết/blog nói rằng ta có thể dùng Azure Bot service làm cầu nối giữa MS Teams và Azure AI Foundry Agents, vậy liệu có hoạt động nếu tôi thiết lập một Azure bot kết nối với Orchestrator Agent trên Azure AI Foundry qua Azure function để thực hiện điều phối hay tôi cần tạo Azure function cho từng AI agent trong giải pháp đa agent để điều phối tại Bot framework? Mọi đề xuất khác đều rất được hoan nghênh."

   

   Agent sẽ trả lời bằng các liên kết tài liệu và tóm tắt liên quan, bạn có thể chèn trực tiếp vào file markdown hoặc dùng làm tài liệu tham khảo trong code.

Ví dụ truy vấn

Dưới đây là một số câu truy vấn mẫu bạn có thể thử. Những truy vấn này sẽ minh họa cách MCP server và Copilot phối hợp để cung cấp tài liệu và tham chiếu phù hợp theo ngữ cảnh ngay trong VS Code:

• "Hướng dẫn cách sử dụng triggers trong Azure Functions."
• "Chèn liên kết đến tài liệu chính thức của Azure Key Vault."
• "Những thực hành tốt nhất để bảo mật tài nguyên Azure là gì?"
• "Tìm quickstart cho dịch vụ Azure AI."

Những truy vấn này sẽ giúp bạn thấy cách MCP server và Copilot làm việc cùng nhau để cung cấp tài liệu và tham chiếu theo ngữ cảnh tức thì mà không cần rời khỏi VS Code.

---

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 các bản dịch tự động có thể chứa lỗi hoặc sai sót. Tài liệu gốc bằng ngôn ngữ nguyên bản nên được coi là nguồn chính xác và đáng tin cậy. Đố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 về bất kỳ sự hiểu lầm hay giải thích sai nào phát sinh từ việc sử dụng bản dịch này.