Vnstock Logo

Vibe Coding Cùng Vnstock Insiders

Chào mừng bạn đến với tài liệu hướng dẫn khai thác Vnstock Agent Guide dành riêng cho thành viên tài trợ. Thiết lập này giúp AI Agent của bạn khai phá 100% tiềm năng của các gói nâng cao: vnstock_data, vnstock_ta, vnstock_news, và vnstock_pipeline!

Khác biệt cho Insiders

Trở thành nhà tài trợ mang lại cho bạn những công cụ làm việc với dữ liệu chứng khoán mạnh mẽ nhất tại Việt Nam. Tuy nhiên, nếu không chỉ dẫn đúng cách, AI của bạn sẽ viết mã theo cú pháp miễn phí cũ hoặc tự bịa đặt hàm không tồn tại.

Vnstock Agent Guide được tối ưu hóa đặc biệt để giúp AI Agent làm chủ kiến trúc bộ thư viện và sử dụng đúng cách các tính năng được tác giả thiết kế một cách dễ dàng, hiệu quả.

Môi trường Virtual EnvironmentThành viên tài trợ nên cài đặt thư viện nâng cao trong môi trường ảo tại ~/.venv (thư mục Home) để các AI Agent luôn tự động tìm kiếm, định cấu hình và chia sẻ giấy phép đăng ký thiết bị một cách dễ dàng.

Tận Dụng Triệt Để AI:

  • Lập trình Unified UI: AI sẽ tự động viết mã sử dụng Market() và Fundamental() vô cùng gọn gàng và chuẩn xác.
  • Khai thác TA & Pipeline: AI tự tạo các hệ thống cảnh báo kịch bản vẽ đồ thị với vnstock_ta hay luồng pipeline tốc độ cao với vnstock_pipeline.
  • Tự động sửa lỗi: AI được cung cấp cẩm nang docs/setup-and-debug để tự gỡ lỗi kết nối, quá giới hạn thiết bị hay cấu hình môi trường ảo mà không làm phiền bạn.

Quy Trình Cài Đặt Hướng Dẫn

Thiết lập môi trường làm việc chỉ với 2 bước đơn giản:

1
Nhân bản (Clone) Agent Guide về máy tính
Mở terminal tại gốc thư mục dự án làm việc của bạn và chạy lệnh:
git clone https://github.com/vnstock-hq/vnstock-agent-guide.git
2
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 để copy toàn bộ tài nguyên chỉ dẫn:

Dành cho macOS / Linux:

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ụ lập trình AI bạn đang sử dụng:

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 nâng cao để 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).
chỉ dẫn cấu hình: AGENTS.md

Quy trình thực hiện:

  1. 1Hệ sinh thái Google Antigravity hoàn toàn chấp nhận AGENTS.md làm chuẩn.
  2. 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).
  3. 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.

Ví Dụ Trực Quan Cho Insiders

Sau khi đã chép tệp cấu hình, Agent sẽ tự động phân quyền truy cập. Hãy thử hỏi trợ lý AI câu lệnh sau:

"Viết mã Python sử dụng thư viện vnstock_data thế hệ mới (Unified UI) để tải dữ liệu lịch sử giá OHLCV của cổ phiếu FPT trong năm 2025"

AI Agent của bạn sẽ tự động viết mã chuẩn xác sử dụng đối tượng Market và gọi các hàm tìm kiếm API trước khi thực thi.

Quay lại trang Hướng Dẫn