Hướng dẫn cài đặt Finhay Skills vào AI Agent của bạn chi tiết từ A – Z

Năm 2026 đánh dấu sự trưởng thành vượt bậc của công nghệ trí tuệ nhân tạo. Bạn có thể dễ dàng tải về hoặc sử dụng một AI-Agent (Trợ lý AI) thông minh để lập trình, viết lách hay sắp xếp lịch trình. Tuy nhiên, ngay khi bạn đưa AI này vào chiến trường tài chính và hỏi: “Thị trường chứng khoán hôm nay thế nào? Danh mục đầu tư của tôi đang lãi hay lỗ?”, cỗ máy thông minh ấy lập tức trở nên vô dụng hoặc tệ hơn – nó bắt đầu bịa đặt số liệu.

Tại sao lại như vậy? Câu trả lời rất đơn giản: Trí thông minh nhân tạo (LLM) là một “bộ não” xuất chúng, nhưng nếu không được kết nối mạng lưới dữ liệu thực tế, bộ não ấy hoàn toàn bị “mù” và “điếc”. Để một AI trở thành một AI Agent chứng khoán thực thụ, nó cần được cắm những “giác quan” để nhìn thấy dòng chảy của tiền tệ.

Đó chính là sứ mệnh của Finhay AI-Agent Ready Platform và Finhay Skills.

Bài viết này là chương đầu tiên trong chuỗi series hướng dẫn làm chủ công nghệ quản lý tài sản thế hệ mới. Chúng tôi sẽ cung cấp cho bạn một hướng dẫn tận dụng Finhay AI-Agent Ready Platform chi tiết nhất, đi từ tổng quan lý thuyết đến các bước cài đặt Finhay Skills từ A-Z. Bằng việc tích hợp API Finhay một cách an toàn, bạn sẽ chính thức đánh thức “Quản gia tài chính” của riêng mình, sẵn sàng cho công cuộc tự động hóa đầu tư đầy thảnh thơi phía trước.

1. Tổng quan: Tại sao AI-Agent lại “mù” dữ liệu tài chính thực tế?

Trước khi bắt tay vào gõ những dòng code cài đặt đầu tiên, chúng ta cần hiểu rõ bản chất của vấn đề kỹ thuật mà mình đang giải quyết. Nếu không nắm vững nguyên lý, bạn sẽ rất dễ gặp rủi ro khi giao phó tài sản cho máy móc.

Giới hạn của các mô hình ngôn ngữ lớn (LLM)

Dù bạn đang sử dụng mô hình tối tân nào (Claude, GPT, Gemini, Llama…), bản chất của chúng là được huấn luyện trên một tập dữ liệu khổng lồ nhưng tĩnh. Dữ liệu này bị “đóng băng” (knowledge cutoff) tại thời điểm chúng được đào tạo.

Thị trường tài chính lại là một thực thể sống, thay đổi theo từng mi-li-giây. Giá cổ phiếu HPG, tỷ giá USD/VND hay lãi suất liên ngân hàng của ngày hôm nay hoàn toàn không tồn tại trong bộ nhớ gốc của AI, mà khi được hỏi thì AI có xu hướng lựa chọn theo các kết quả chúng tìm được, không đảm bảo chính xác theo thời gian thực. Khi bị ép phải trả lời những câu hỏi về dữ liệu thị trường real-time, AI sẽ dùng xác suất ngôn ngữ để dự báo dựa trên các kết quả tìm kiếm hoặc dữ liệu sẵn có, dẫn đến hiện tượng đưa ra nhận định trên các dữ liệu có thể không mang tính chính xác. Tất nhiên trong đầu tư, nếu không đảm bảo được tính chính xác, các nhận định sẽ mang tính sai lệch rất nhiều, ảnh hưởng trực tiếp đến hiệu suất đầu từ

Giải pháp từ Finhay: AI-Agent Ready Platform

Để khắc phục các sai lệch về mặt dữ liệu này, AI cần một đường ống dẫn thông tin liên tục và chuẩn xác. Thay vì yêu cầu nhà đầu tư tự xây dựng hệ thống thu thập dữ liệu (crawling) phức tạp và tiềm tàng khả năng phát sinh lỗi, Finhay định vị mình đòng vai trò AI-Agent Ready Platform và cho ra đời để cung cấp sẵn một hạ tầng hoàn chỉnh. Và không chỉ dừng lại ở đó, Finhay còn có thể cung cấp khả năng tiếp cận dữ liệu danh mục cá nhân cho người dùng và AI-Agent của mình, cũng như mở ra khả năng giao dịch (trading) thông qua AI-Agent (sắp ra mắt).

Finhay đóng gói toàn bộ dữ liệu thị trường và dữ liệu danh mục người dùng vào một kho kỹ năng Finhay (Finhay Skills Hub). Việc của bạn không phải là xây dựng từ đầu, mà chỉ đơn giản là “cắm” AI-Agent của bạn vào kho kỹ năng này thông qua cơ chế tích hợp API Finhay.

>> Để hiểu sâu hơn về sự khác biệt giữa AI thông thường và AI tự chủ, bạn có thể tham khảo bài viết: AI Agent là gì? Phân biệt Agentic AI, Generative AI và Chatbot.

2. Hệ sinh thái Finhay Skills: Bộ 3 Kỹ năng định hình AI-Agent chứng khoán

Khi thực hiện việc cài đặt Finhay Skills, bạn đang tải về một bộ công cụ (Tools) mạnh mẽ. Việc cấp quyền cho AI sử dụng các công cụ này được thực hiện qua giao thức chuẩn hóa toàn cầu.

Giao thức MCP (Model Context Protocol)

Finhay Skills được xây dựng hoàn toàn dựa trên giao thức MCP. Bạn có thể hình dung MCP giống như cổng kết nối USB-C. Dù bạn dùng điện thoại hãng nào (ví dụ: dùng AI của Anthropic, OpenAI hay Google), chỉ cần có cổng USB-C (hỗ trợ MCP), bạn đều có thể cắm trực tiếp vào hệ thống của Finhay để truyền tải dữ liệu một cách mượt mà và bảo mật.

>> Đọc thêm: Giao thức MCP (Model Context Protocol) là gì? “Cổng USB-C” định hình tương lai ứng dụng AI

Chi tiết 3 “kỹ năng” tài chính (Finhay Skills)

Gói cài đặt mà chúng ta chuẩn bị thao tác dưới đây bao gồm 3 kỹ năng cốt lõi:

1. finhay-market: Truy xuất dữ liệu thị trường real-time 24/7. AI sẽ đọc được bảng giá chứng khoán, chỉ số VN-Index, báo cáo tài chính doanh nghiệp, giá vàng, vĩ mô…

2. finhay-portfolio: Truy cập an toàn vào bức tranh tài sản cá nhân của bạn trên app Finhay để phân tích lãi/lỗ và rủi ro danh mục.

3. finhay-trading (Sắp ra mắt):  Thực hiện các lệnh mua hoặc bán theo yêu cầu hoặc các quy tắc đầu tư tự động mà bạn thiết lập, giúp tối ưu hóa cơ hội thị trường.

Bây giờ, hãy xắn tay áo lên và bắt đầu quá trình tích hợp.

3. Chuẩn bị môi trường cài đặt Finhay Skills (Pre-requisites)

Để quá trình cài đặt Finhay Skills diễn ra suôn sẻ, máy tính của bạn cần được trang bị một số công cụ nền tảng. Hướng dẫn Finhay Agent-Ready này được thiết kế để ngay cả những nhà đầu tư không phải là lập trình viên chuyên nghiệp (Non-dev) cũng có thể làm theo.

Cài đặt Node.js

Finhay Skills được phân phối dưới dạng một package (gói phần mềm) thông qua công cụ dòng lệnh npx. Để sử dụng được lệnh này, máy tính của bạn BẮT BUỘC phải cài đặt Node.js.

• Hành động: Truy cập trang chủ Nodejs.org và tải về phiên bản LTS (Long Term Support) mới nhất cài đặt cho Windows hoặc macOS.

• Kiểm tra: Sau khi cài xong, mở ứng dụng Terminal (trên macOS/Linux) hoặc Command Prompt/PowerShell (trên Windows). Gõ lệnh node -v và nhấn Enter. Nếu hệ thống trả về số phiên bản (ví dụ: v20.11.0), bạn đã cài đặt thành công.

Môi trường AI-Agent (Agent Environment)

Bạn cần một nền tảng hoặc ứng dụng AI Agent có hỗ trợ giao thức MCP để cài đặt skills vào đó. Hiện tại, kho kỹ năng Finhay hỗ trợ tương thích hoàn hảo với các môi trường phổ biến trong năm 2026 như:

Trong bài hướng dẫn này, chúng ta giả định bạn đã có sẵn một trong các môi trường trên đang hoạt động trên máy tính.

Tài khoản Finhay đang hoạt động

Tất nhiên, để trợ lý AI tài chính có thể đọc được danh mục của bạn, bạn cần có một tài khoản Finhay (đã xác thực eKYC) và đang có giao dịch/tài sản trên đó.

4. Hướng dẫn cài đặt Finhay Skills từ A-Z (Step-by-Step)

Quy trình tích hợp API Finhay đã được tối ưu hóa đến mức tối giản. Chỉ cần thực hiện chính xác 4 bước theo trình tự dưới đây.

Bước 1: Sao chép và chạy lệnh trong Terminal

Mở cửa sổ Terminal (hoặc Command Prompt) tại thư mục mà bạn đang chứa dự án AI Agent. Gõ (hoặc copy/paste) dòng lệnh duy nhất sau đây và nhấn Enter:

npx skills add finhay-pro/finhay-skills-hub

Điều gì đang xảy ra? Lệnh npx sẽ gọi hệ thống mạng, tìm kiếm gói phần mềm chính thức của Finhay từ kho lưu trữ an toàn, tải mã nguồn về và tự động khởi chạy trình cài đặt giao diện ngay trên màn hình đen của bạn.

Bước 2: Chọn Skill bạn muốn cài đặt

Sau vài giây, màn hình Terminal sẽ hiển thị thông báo: Source: https://github.com/finhay-pro/finhay-skills-hub.git Repository cloned Found 3 skills

Ngay bên dưới, hệ thống sẽ yêu cầu bạn: Select skills to install (space to toggle). Lúc này, bạn sử dụng phím Mũi tên Lên/Xuống trên bàn phím để di chuyển, và nhấn phím Space (Khoảng trắng) để đánh dấu tích [x] vào các kỹ năng bạn muốn AI Agent của mình sở hữu:

• [x] finhay-market

• [x] finhay-portfolio

• [x] finhay-trading

(Lời khuyên: Nếu bạn mới làm quen, hãy chọn cả 3 để trải nghiệm trọn vẹn sức mạnh của tự động hóa đầu tư. Sau khi chọn xong, nhấn Enter để tiếp tục.

Bước 3: Chọn Agent sử dụng Finhay Skills

Tiếp theo, hệ thống cần biết bạn đang muốn “cắm” các kỹ năng này vào phần mềm AI nào. Terminal sẽ hiển thị một danh sách các Agent được hỗ trợ:

• ○ Claude Code (.claude/skills)

• ○ OpenClaw (skills)

• ○ CodeBuddy (.codebuddy/skills)

• ○ Command Code (.commandcode/skills)

• ○ Continue (.continue/skills)

• ○ Cortex Code (.cortex/skills)

• ○ Crush (.crush/skills)

Tiếp tục sử dụng phím Mũi tên để di chuyển đến môi trường bạn đang sử dụng (Ví dụ: Claude Code) và nhấn Enter. Trình cài đặt sẽ tự động viết các tệp cấu hình (config files) tương thích với nền tảng đó, thiết lập luồng giao tiếp MCP mà không cần bạn phải can thiệp thủ công vào code.

Bước 4: Lấy API Key để cài đặt Finhay Skills

Đây là bước bảo mật quan trọng nhất. Sau khi cài đặt các file thành công, Terminal sẽ yêu cầu bạn cung cấp API Key để xác thực danh tính với máy chủ Finhay.

Cách lấy API Key từ ứng dụng Finhay

1. Truy cập website và trang Finhay Skills chính thức: https://www.finhay.com.vn/finhay-skills

2. Đăng nhập vào Tài khoản Finhay của bạn

3. Tìm đến mục Hướng dẫn cài đặt

4. Chọn nút “Lấy API Key” và làm theo hướng dẫn được hiển thị

5. Ứng dụng sẽ hiển thị một chuỗi ký tự dài (Ví dụ: fh_live_8x9A2b...). Lưu ý: Mã này chỉ hiển thị đúng 1 lần duy nhất. Hãy sao chép nó.

Quay trở lại màn hình Terminal trên máy tính, dán (paste) chuỗi API Key này vào mục yêu cầu và nhấn Enter.

(>> Để hiểu rõ hơn về việc tại sao Finhay sử dụng API Key thay vì mật khẩu thông thường, và cách cơ chế Zero Data Retention bảo vệ bạn, hãy đọc bài viết: Đạo đức & Bảo mật AI Agent trong kỷ nguyên tự động hóa.

Hoàn tất: Nếu Terminal báo Installation Successful (Cài đặt thành công), xin chúc mừng! Bạn đã chính thức cấp “giấy thông hành” cho AI Agent bước vào thị trường tài chính.

5. Kiểm thử (Testing) – Đánh thức Trợ lý AI tài chính của chính bạn

Cài đặt xong là một chuyện, nhưng làm sao để biết cỗ máy đã thực sự hoạt động? Đừng vội áp dụng các chiến lược phức tạp, hãy thực hiện một bài test nhỏ (Ping test) để kiểm tra luồng tích hợp API Finhay.

Hãy mở giao diện chat của môi trường AI Agent bạn vừa cài đặt (Ví dụ: Mở Claude Code CLI) và nhập đoạn Prompt sau:

Prompt Kiểm thử 1 (Test finhay-market): “Bạn đã được kết nối với Finhay Skills chưa? Hãy chứng minh bằng cách truy xuất và cho tôi biết điểm số hiện tại của VN-Index và giá cổ phiếu FPT ngay lúc này.”

Kỳ vọng phản hồi: AI Agent sẽ hiển thị biểu tượng đang sử dụng tool (ví dụ: Using tool: finhay-market/get_stock_quote...). Sau khoảng 2-3 giây, nó sẽ trả về cho bạn con số chính xác của thị trường tại phút hiện tại, thay vì một câu xin lỗi “Tôi không có quyền truy cập internet”.

Prompt Kiểm thử 2 (Test finhay-portfolio): “Hãy dùng kỹ năng portfolio để xem tổng tài sản ròng (NAV) trên tài khoản Finhay của tôi hiện tại là bao nhiêu? Không cần liệt kê chi tiết, chỉ cần cho tôi con số tổng.”

Kỳ vọng phản hồi: AI Agent sẽ gọi finhay-portfolio, dùng API Key bạn vừa nhập để xác thực qua máy chủ Finhay, lấy dữ liệu JSON về và trả lời chính xác số dư tài khoản của bạn.

Nếu AI trả lời trơn tru, vòng lặp giao tiếp đã thông suốt. AI Agent chứng khoán của bạn đã sẵn sàng cho những nhiệm vụ cao cấp hơn.

6. Những lỗi thường gặp và Cách khắc phục

Trong quá trình thao tác , đặc biệt với người dùng không chuyên kỹ thuật, việc gặp một số thông báo lỗi ở Terminal là bình thường. Dưới đây là bảng tổng hợp các lỗi phổ biến và cách giải quyết nhanh nhất.

Lưu ý quan trọng về Quản lý API Key

Mã API Key là “chìa khóa két sắt” của bạn. Mặc dù Finhay đã thiết kế cơ chế kỹ năng Đọc (Market/Portfolio) tách biệt với kỹ năng Hành động (Trading) đòi hỏi OTP, bạn vẫn phải tuân thủ nguyên tắc bảo mật:

1. Không bao giờ chia sẻ mã API Key cho người khác.

2. Không bao giờ tải file chứa mã API Key lên các nền tảng public như GitHub hay các diễn đàn mạng.

3. Nếu nghi ngờ máy tính bị nhiễm virus hoặc mất laptop, hãy mở app Finhay trên điện thoại và bấm Thu hồi (Revoke) API Key ngay lập tức. Mọi kết nối của Agent sẽ lập tức bị ngắt.

7. Tổng kết: Bạn đã sở hữu “Đặc quyền” của tương lai

Hoàn thành bài viết này, bạn đã bước qua rào cản kỹ thuật lớn nhất trên hành trình chinh phục công nghệ tài chính thế hệ mới. Việc cài đặt Finhay Skills thông qua giao thức MCP thành công đồng nghĩa với việc bạn đã giải quyết triệt để căn bệnh “mù” dữ liệu và “ảo giác” của các mô hình ngôn ngữ lớn.

Giờ đây, trên máy tính của bạn không còn là một chatbot biết tuốt lý thuyết suông, mà là một AI-Agent chứng khoán thực thụ – được trang bị dữ liệu thị trường real-time và khả năng thấu hiểu sâu sắc dòng tiền của chính bạn. Đây là một đặc quyền công nghệ mà chỉ vài năm trước đây, chỉ có các tổ chức tài chính với đội ngũ kỹ sư hùng hậu mới có thể sở hữu.

Nhưng cài đặt thành công mới chỉ là sự khởi đầu. Có công cụ sắc bén trong tay, vấn đề tiếp theo là làm sao để sử dụng nó hiệu quả nhất? Làm sao để đặt những câu lệnh (Prompt) thông minh khiến AI tự động phân tích hàng trăm báo cáo tài chính thay bạn?

Trong Bài 2: Làm chủ finhay-market, chúng ta sẽ đi sâu vào kỹ năng đầu tiên. Bạn sẽ học được cách hô biến AI thành một nhà phân tích vĩ mô, liên tục cập nhật dòng tiền và đánh giá cổ phiếu 24/7. Mời các bạn tiếp tục theo dõi!

Tuyên bố miễn trừ trách nhiệm: Hướng dẫn kỹ thuật trong bài viết nhằm mục đích giúp người dùng thiết lập kết nối giữa AI Agent cá nhân và hệ thống Finhay. Việc bảo mật thiết bị cá nhân và quản lý API Key thuộc trách nhiệm của người dùng. Mọi dữ liệu tài chính truy xuất qua AI chỉ mang tính chất tham khảo, không phải là lời khuyên đầu tư. Các sản phẩm và nền tảng dữ liệu được cung cấp bởi FHSC. Hãy luôn kiểm chứng thông tin trước khi đưa ra quyết định tài chính.