Lập Trình Cùng AI Agent

Chào mừng bạn đến với hướng dẫn tích hợp Vnstock Agent Guide. Đây là bộ chỉ dẫn đặc thù giúp các trợ lý AI (như Google Antigravity, Claude, Codex) hiểu rõ về thư viện Vnstock để sinh mã chuẩn xác, chấm dứt việc tạo mã lỗi hoặc hàm không tồn tại!

Tại sao AI cần Agent Guide?

Mặc dù các mô hình ngôn ngữ lớn (LLM) ngày nay rất thông minh, nhưng dữ liệu huấn luyện của chúng thường bị lỗi thời hoặc không cập nhật các thay đổi mới nhất của thư viện vnstock.

Vnstock Agent Guide giải quyết triệt để vấn đề này bằng cách cung cấp trực tiếp tài liệu chi tiết có cấu trúc ngay trong thư mục làm việc của bạn. AI Agent sẽ đọc tài liệu để biết chính xác cú pháp và viết code đúng ngay từ đầu.

Lợi ích vượt trội:

Sinh mã chuẩn xác: AI không còn bịa đặt tên hàm, tham số hay sử dụng các API đã lỗi thời.
Tiết kiệm thời gian: Không còn cảnh bạn phải liên tục copy-paste lỗi rồi bắt AI sửa đi sửa lại.
Học hỏi nhanh hơn: AI sẽ giải thích chi tiết các hàm dựa trên tài liệu chuẩn để bạn tự giải đáp các thắc mắc về dự án.

Quy Trình Cài Đặt 2 Bước

Chỉ mất 2 phút để trang bị cho trợ lý AI của bạn một cuốn cẩm nang lập trình Vnstock toàn diện.

Sao chép Agent Guide về máy tính

Mở ứng dụng Terminal (PowerShell trên Windows) tại thư mục dự án Python của bạn và chạy lệnh sau:

git clone https://github.com/vnstock-hq/vnstock-agent-guide.git

Sao chép các thư mục chỉ dẫn vào dự án

Chọn dòng lệnh tương ứng với hệ điều hành của bạn để copy cấu hình:

Dành cho macOS / Linux (Terminal):

cp -rf vnstock-agent-guide/docs vnstock-agent-guide/.agents vnstock-agent-guide/AGENTS.md vnstock-agent-guide/CLAUDE.md ./

Dành cho Windows (PowerShell):

Copy-Item -Path vnstock-agent-guide/docs, vnstock-agent-guide/.agents, vnstock-agent-guide/AGENTS.md, vnstock-agent-guide/CLAUDE.md -Destination ./ -Recurse -Force

Cấu Hình Cho Từng AI Agent

Chọn công cụ AI bạn đang dùng để xem chi tiết hướng dẫn cấu hình:

1. Quy Tắc Đầu Vào

Tệp AGENTS.md hoặc CLAUDE.md định hướng phong cách viết mã và quy tắc hệ thống của Agent.

2. Thư Viện Tài Liệu

Thư mục docs/ chứa toàn bộ tài liệu chi tiết về API và cú pháp chuẩn của các thư viện để Agent tra cứu nhanh.

3. Bộ Kỹ Năng AI

Thư mục .agents/ (chứa .agents/skills/) cung cấp các kỹ năng tự động gỡ lỗi, thiết lập và viết code chuẩn cho user.

Google Antigravity

Hệ sinh thái AI Agent tiên tiến từ Google (gồm IDE và CLI).

Tệp cấu hình tương ứng: AGENTS.md

Các bước thao tác:

1Hệ sinh thái Google Antigravity hoàn toàn chấp nhận AGENTS.md làm chuẩn.
2Đảm bảo chép kèm thư mục docs/ (chứa tài liệu chi tiết của từng thư viện) và thư mục .agents/ (chứa .agents/skills cung cấp "kỹ năng" cho AI Agent tự động cài đặt, gỡ lỗi, viết code).
3Agent sẽ tự động đọc trạng thái tài khoản của bạn là Miễn phí hay Sponsor và đưa ra chỉ dẫn phù hợp.

Thử Nghiệm Ngay Lập Tức

Sau khi đã thiết lập Agent Guide, Agent sẽ tự động cấu hình. Hãy thử hỏi AI Agent của bạn bằng một câu lệnh cụ thể dưới đây để kiểm tra:

"Viết một script Python sử dụng thư viện vnstock thế hệ mới (Unified UI) để tải dữ liệu lịch sử giá cổ phiếu FPT"

Bạn sẽ thấy AI viết mã chính xác sử dụng đối tượng Market và gọi phương thức mkt.equity("FPT").ohlcv(...) của thư viện vnstock, thay vì gợi ý các API cũ hay tự ảo tưởng ra các hàm không tồn tại.

Quay lại danh sách hướng dẫn