Tự động nạp Agent Skills và tài liệu

Tổng quan

Cơ chế tải động¹ cho phép các AI Agent trong môi trường lập trình tự động nạp trực tiếp các bộ kỹ năng² và tài liệu hướng dẫn từ hệ thống máy chủ của Vnstock, thay vì phải lưu trữ các tệp tin tĩnh trên máy tính cá nhân.

Mục đích của cơ chế này là khắc phục những hạn chế từ phiên bản hướng dẫn lưu trữ trên kho mã nguồn mở GitHub vnstock-agent-guide. Cách triển khai qua Github cho phép tải về toàn bộ tài liệu để nghiên cứu nhưng lại không thuận tiện trong việc cập nhật thường xuyên và tích hợp vào dự án Vibe Coding, dẫn đến tình trạng nội dung bị phân mảnh và không đồng bộ với tài liệu chính thức. Đáng chú ý, phiên bản trên GitHub đôi khi chứa các chỉ dẫn chưa chính xác do thiếu quy trình rà soát như phiên bản nền tảng web. Việc hợp nhất về một nguồn dữ liệu duy nhất³ giúp Vnstock kiểm soát chất lượng chặt chẽ hơn, đồng thời mang lại cho người dùng trải nghiệm đồng bộ dù làm việc ở bất kỳ môi trường lập trình nào.

Cài đặt

Để sử dụng tính năng này, bạn cần cài đặt hoặc cập nhật đồng thời cả hai thư viện vnstock và vnai lên các phiên bản tương thích mới nhất:

pip install -U vnstock>=4.0.5 vnai>=2.5.6

Hệ thống sử dụng thư viện vnstock làm công cụ trung gian để quản lý và tải nội dung kỹ năng chính thức. Mã API Key từ tài khoản Vnstock của bạn sẽ được thư viện đọc từ môi trường máy tính của bạn (sau khi bạn đã đăng ký mã này trên máy) để tải các kỹ năng này. Bạn hoàn toàn có thể yêu cầu AI thực hiện bước thiết lập này.

Kiến trúc hoạt động

Hệ thống hoạt động dựa trên sự liên kết giữa máy chủ lưu trữ nền tảng web và thư viện Python ở phía người dùng, đảm bảo cung cấp ngữ cảnh chính xác cho AI.

1. Agent Skills Hub (Trung tâm Kỹ năng)

Tất cả các bộ kỹ năng dành cho AI được quản lý tập trung tại Agent Skills Hub. Dựa vào Mã khóa cá nhân (API Key), hệ thống sẽ tự động phân quyền truy cập các nhóm kỹ năng phù hợp với hạng thành viên của bạn:

• Người dùng Miễn phí (Free): Được quyền tiếp cận các bộ kỹ năng nền tảng. Nhóm kỹ năng này hướng dẫn AI cách vận hành thư viện vnstock mã nguồn mở để lấy dữ liệu thị trường cơ bản, thiết lập môi trường và cấu hình tự động hóa.
• Người dùng Tài trợ (Sponsor): Tùy thuộc vào cấp độ gói tài trợ, hệ thống sẽ cung cấp thêm các kỹ năng phân tích chuyên sâu. Những kỹ năng nâng cao này giúp AI tương tác hiệu quả với các luồng dữ liệu mở rộng (như vnstock_data, vnstock_ta, vnstock_news), hỗ trợ bạn thực hiện các bài toán phân tích định lượng phức tạp.

Bên cạnh các bộ kỹ năng, Agent Skills Hub cũng tự động cho phép AI Agent đọc trực tiếp toàn bộ tài liệu hướng dẫn chính thức trên web thông qua API, giúp AI luôn nắm bắt kịp thời những cập nhật mới nhất mà không cần bạn phải sao chép thủ công.

2. Trải nghiệm Tự động hóa với AI

Thư viện vnstock đóng vai trò là cầu nối giữa bạn và Agent Skills Hub. Quá trình nạp kỹ năng diễn ra tự động ngầm thông qua các quy tắc đã được cài đặt sẵn (như file AGENTS.md) trên môi trường của bạn.

Thay vì phải tự viết code hay quan tâm đến các hàm nạp dữ liệu nội bộ, bạn chỉ cần ra lệnh bằng ngôn ngữ tự nhiên để sử dụng các tính năng của thư viện:

• Yêu cầu AI lấy dữ liệu thị trường, truy xuất báo cáo tài chính hoặc phân tích kỹ thuật.
• Yêu cầu AI tự động tra cứu tài liệu hướng dẫn (docs) mới nhất của một hàm cụ thể.

AI sẽ tự động duyệt danh mục để tìm đúng bộ kỹ năng cần thiết, nạp trực tiếp vào bộ nhớ đệm để làm bối cảnh xử lý tác vụ, và tự động giải phóng không gian này hoàn toàn khi bạn đóng phiên làm việc.

3. Cấu hình quy tắc tự động

Khi bạn khởi tạo dự án và sử dụng thư viện vnstock, hệ thống sẽ tự động thiết lập các file chỉ dẫn AGENTS.md⁴ vào tệp tin cấu hình của những môi trường lập trình của bạn.

File này định hướng AI ưu tiên sử dụng các hàm nạp dữ liệu động thay vì tự phỏng đoán thông tin.

Bản quyền và Sử dụng

Toàn bộ nội dung các bộ kỹ năng (Agent Skills), tài liệu hướng dẫn và mã nguồn liên quan được cung cấp thông qua hệ thống này đều thuộc bản quyền sở hữu trí tuệ của Vnstock.