Tầng 2 · Chỉ dẫn trợ lý AI
Thiết lập nhanh bằng lời nhắc. Trợ lý luôn hỏi ý kiến trước mỗi bước.
Chỉ cần gửi lời nhắc mẫu cho trợ lý AI của bạn. Kịch bản cài đặt được duy trì trực tiếp trên máy chủ Vnstock đảm bảo luôn ở phiên bản mới nhất, và trợ lý sẽ hiển thị từng câu lệnh để bạn duyệt trước khi chạy.
Cài đặt tự động bằng lời nhắc
01
Mở trợ lý AI bạn đang dùng
Trên máy tính, bản ứng dụng hay trợ lý dòng lệnh đều được.
Ứng dụng trò chuyện
- Claude
- ChatGPT
- Antigravity
Chạy lệnh trên máy
- Claude Code
- Codex
- VS Code
- Antigravity IDE
Các trợ lý lập trình chuyên dụng (như Claude Code, Antigravity) có thể tự động cài đặt thay bạn. Với ứng dụng trò chuyện thông thường, trợ lý sẽ cung cấp từng lệnh chuẩn xác để bạn thực thi.
02
Dán lời nhắc vào trợ lý AI
Lời nhắc không chứa khoá truy cập. Tên hệ điều hành đổi theo lựa chọn ở trên.
Lời nhắcHãy giúp tôi thiết lập thư viện Python vnstock thế hệ 5 (bản Cộng đồng) trên máy macOS, tuân thủ tài liệu hướng dẫn tại https://vnstocks.com/files/vibe-onboarding.md - Trước khi thực hiện bất kỳ lệnh nào, hãy giải thích rõ và chờ tôi xác nhận đồng ý. - Cài vào môi trường ảo cố định ~/.venv (tạo mới nếu chưa có), trừ khi tôi yêu cầu chỗ khác; trên Google Colab hay GitHub Codespaces thì cài thẳng vào môi trường của phiên, không tạo môi trường ảo. - Trước khi cài, kiểm tra môi trường đó đang có gì. Nếu đã có vnstock 4.x, vnstock_data hoặc vnai, hãy dừng lại và hỏi tôi: cài đè sẽ làm hỏng bản cũ và không khôi phục được. Khi đó hãy đề xuất cài thế hệ 5 vào ~/.venv5x. - Tuyệt đối không hỏi hay yêu cầu tôi cung cấp khoá truy cập (API key) qua khung chat. - Cài xong, chạy `vnstock onboard` bằng lệnh vnstock của môi trường đó và làm theo hướng dẫn nó in ra trước khi viết mã: quy tắc, bước tiếp theo theo cấp của tôi, và các skill cấp tôi đọc được. Nếu lệnh báo không có `onboard`, chạy `vnstock update` rồi thử lại. - Không tự ý ghi đè hay thay đổi các tệp cấu hình trợ lý AI (AGENTS.md, CLAUDE.md...) nếu chưa có yêu cầu. - Khi hoàn tất cài đặt, hãy chạy một truy vấn mẫu lấy thông tin hợp đồng tương lai VN30F1M để kiểm tra tính sẵn sàng, đồng thời gợi ý cho tôi 3 bài toán nghiên cứu đầu tiên để bắt đầu trải nghiệm ngay.
03
Xem và đồng ý từng lệnh
Trợ lý cho bạn xem từng lệnh trước khi chạy. Cài xong, trợ lý chạy thử một đoạn lấy dữ liệu để chắc là dùng được.
Quy trình diễn ra sau khi bạn gửi lời nhắc
- Gửi lời nhắc cho trợ lý AIBạn luôn nắm rõ và kiểm soát mọi lệnh thực thi
- Trợ lý hỏi ý kiến từng bướcKhoá bảo mật lưu cục bộ, không gửi qua khung chat
- Tự động nạp kỹ năng khi cầnLuôn đồng bộ tài liệu và phiên bản mới nhất
Toàn bộ quy trình diễn ra nhanh chóng ngay trong phiên làm việc. Bạn luôn giữ quyền chủ động tuyệt đối: trợ lý sẽ không thực thi bất kỳ lệnh nào nếu chưa có sự xác nhận của bạn.
Cơ chế nạp trực tuyến: Luôn mới, không lo lỗi thời
Tải toàn bộ thư mục về máy
Trợ lý đọc ngữ cảnh trực tiếp từ web khi cần
Phải theo dõi và tải lại bằng tay
Luôn sẵn sàng phiên bản mới ở lần chạy tiếp theo
Dễ bị lỗi thời sau khi tải về
Đồng bộ liên tục với bản phát hành chính thức
Phải cấu hình lại từ đầu
Chỉ cần gửi lại cùng một lời nhắc mẫu
Phải tự tra cứu gói tính năng
Hệ thống tự động đối chiếu theo khoá truy cập
Cách nhận biết trợ lý đã hiểu đúng hướng dẫn
Bạn có thể kiểm tra nhanh qua các đoạn mã mà trợ lý AI sinh ra trong khung chat.
Trợ lý đã hiểu đúng (Cú pháp thế hệ 5)
- from vnstock import Market
- Market().equity("FPT").ohlcv()
Chưa nhận đúng ngữ cảnh (Cú pháp cũ đã lỗi thời)
- from vnstock3 import stock_historical_data
- stock_historical_data(symbol="FPT", ...)
Nếu trợ lý sinh ra cú pháp cũ, bạn chỉ cần dán lại lời nhắc mẫu ở đầu trang để làm mới ngữ cảnh.
Một khoá truy cập (API Key) đồng bộ cho toàn bộ hệ sinh thái
Thư viện, kho kỹ năng AI và trang quản lý tài khoản đều dùng chung một khoá truy cập duy nhất. Khi đổi máy tính hoặc chuyển đổi công cụ AI, bạn không cần phải kích hoạt lại từ đầu. Bạn có thể xem hoặc cấp lại khoá bất cứ lúc nào tại trang quản lý tài khoản.
Tương thích linh hoạt với mọi công cụ AI
Trợ lý sẽ tự động khởi tạo tệp cấu hình phù hợp với từng môi trường làm việc. Khi chuyển sang ứng dụng mới, bạn chỉ cần dùng lại cùng một lời nhắc mẫu.
- Google Antigravity
AGENTS.md - Claude Code
CLAUDE.md - ChatGPT (OpenAI Codex)
AGENTS.md
Kho kỹ năng
Khi trợ lý AI đã nắm vững cú pháp chuẩn của Vnstock, bước tiếp theo là trang bị các bộ kỹ năng chuyên biệt phù hợp với mục tiêu phân tích của bạn — từ lọc cổ phiếu tiềm năng, đọc hiểu báo cáo tài chính đến đo lường rủi ro danh mục.
Sang tầng 3: Kho kỹ năng