
Equity Research Agent thực hiện những gì
Equity Research Agent chuyển đổi dữ liệu tài chính công khai đã được cập nhật thành báo cáo phân tích cổ phiếu bằng tiếng Anh, với đầu ra Word có thể chỉnh sửa và bản PDF tương ứng. Công cụ hỗ trợ cổ phiếu Mỹ, cổ phiếu hạng A Thượng Hải và cổ phiếu Hồng Kông, đồng thời giữ nguyên các điểm chính về số liệu và giải thích các yếu tố thúc đẩy khả năng sinh lời, chuyển đổi tiền mặt và định giá.
Dự án tách riêng các bước thu thập dữ liệu, tính toán tài chính, rà soát giả định và định dạng tài liệu. Công cụ tài chính xác định thực hiện tính toán kết quả định giá cục bộ, trong khi DeepSeek có thể hỗ trợ phản biện luận điểm và đề xuất các giả định DCF khả thi.

Tính năng chính
- Hỗ trợ ba thị trường: Chọn mã cổ phiếu Mỹ, mã sáu chữ số của Thượng Hải hoặc mã cổ phiếu Hồng Kông.
- Đầu vào định giá rõ ràng: Cấu hình các giả định về tăng trưởng, biên lợi nhuận, thuế, tái đầu tư, WACC, tăng trưởng vĩnh viễn, ROIC và cầu nối vốn chủ sở hữu.
- DCF ba kịch bản: Xem xét các trường hợp tăng trưởng, cơ sở và giảm với mức tăng trưởng, biên lợi nhuận, chi tiêu vốn và thay đổi vốn lưu động riêng cho từng kịch bản.
- Đầu ra có thể chỉnh sửa: Xuất báo cáo Word và, trên các bản cài đặt Windows được hỗ trợ, bản PDF tương ứng.
- Bằng chứng và nguồn gốc dữ liệu: Lưu giữ ảnh chụp nguồn, ngày tháng, đơn vị tiền tệ, mã băm và bản tóm tắt xác thực.
- Phát lại ngoại tuyến: Tính toán lại các ảnh chụp dữ liệu tài chính đi kèm mà không cần gửi yêu cầu đến LLM.
Cài đặt và khởi động không gian làm việc
Bạn cần Python 3.10 trở lên. Từ thư mục kho mã đã giải nén, hãy tạo môi trường ảo, cài đặt dự án cùng các phần phụ thuộc kiểm thử, rồi khởi động không gian làm việc cục bộ.
python -m venv .venv
.venv/Scripts/python.exe -m pip install -e ".[test]"
.venv/Scripts/python.exe -m equity_research_agent.cli serve --port 8766
Mở http://127.0.0.1:8766 trong trình duyệt. Trên Windows, bạn cũng có thể khởi chạy Start Workspace.cmd sau khi cài đặt.
Việc thu thập dữ liệu công khai trực tiếp cần kết nối internet, nhưng không yêu cầu khóa API dữ liệu riêng. DeepSeek là tùy chọn. Để bật tính năng này, hãy sao chép .env.example thành .env và thêm khóa của bạn trên máy cục bộ. Thông tin xác thực vẫn nằm trong môi trường cục bộ của bạn.

Tạo báo cáo cơ bản về công ty
Trong không gian làm việc, hãy chọn thị trường và mã chứng khoán chính xác. Kiểm tra danh tính công ty, đơn vị tiền tệ báo cáo, đơn vị tiền tệ báo giá, phạm vi dữ liệu và các trường định giá khả dụng đã được tải trước khi tạo báo cáo.
Để thực hiện ví dụ ngoại tuyến có thể tái lập, hãy sử dụng ảnh chụp NVIDIA cố định được cung cấp:
.venv/Scripts/python.exe -m equity_research_agent.cli company --market US --symbol NVDA --snapshot examples/nvda/company_snapshot.json --skip-pdfLệnh này sử dụng ảnh chụp công ty đã lưu, không gửi yêu cầu đến mô hình và tạo báo cáo Word mà không thử chuyển đổi sang PDF. Quy trình tương tự có thể áp dụng cho các mã chứng khoán được hỗ trợ khác bằng cách sử dụng thị trường, mã và ảnh chụp tương ứng hoặc dữ liệu công khai trực tiếp.
Cấu hình các giả định DCF

Thiết lập trực tiếp trong không gian làm việc các giả định thúc đẩy việc định giá. Các đầu vào khả dụng gồm tăng trưởng doanh thu, biên lợi nhuận hoạt động, thuế, tái đầu tư, WACC, tăng trưởng vĩnh viễn, ROIC và cầu nối từ giá trị doanh nghiệp sang vốn chủ sở hữu. Các điều khiển kịch bản cho phép bạn điều chỉnh tăng trưởng, biên lợi nhuận, chi tiêu vốn và biến động vốn lưu động cho các trường hợp tăng và giảm.
Công cụ tài chính sử dụng các đầu vào đã được rà soát này để tính toán ba kịch bản dòng tiền. Báo cáo trình bày các giả định, phép tính FCFF hằng năm, dòng tiền chiết khấu, tái đầu tư cuối kỳ và cầu nối từ giá trị doanh nghiệp sang vốn chủ sở hữu, thay vì che giấu logic định giá phía sau một con số mục tiêu duy nhất.

Thảo luận về các giả định với DeepSeek
Sử dụng giao diện thảo luận khi bạn muốn kiểm tra một luận điểm đầu tư thay vì chỉ nhập các giả định. Nhập câu hỏi hoặc luận điểm của bạn và tùy chọn cung cấp các liên kết nguồn công khai. DeepSeek xem xét bằng chứng được truy xuất, phản biện quan điểm và đề xuất các giả định kèm phạm vi, lý do, tài liệu tham khảo và lập luận phản biện.
- Nhập luận điểm hoặc câu hỏi định giá của bạn.
- Thêm các liên kết nguồn công khai liên quan nếu có.
- Rà soát các phạm vi, bằng chứng và lập luận phản biện được đề xuất.
- Chỉ chọn những đề xuất bạn muốn áp dụng.
- Kiểm tra thay đổi định giá tạo ra trong công cụ tài chính cục bộ.
- Chỉnh sửa thủ công bất kỳ trường nào trước khi tạo báo cáo.
Mô hình đề xuất và ghi nhận; công cụ cục bộ thực hiện tính toán số liệu. DeepSeek mặc định sử dụng chế độ suy luận cao và giới hạn ngân sách cộng dồn là 100 CNY. Giao diện không tự động áp dụng các đề xuất vào mô hình: việc áp dụng vẫn là hành động rõ ràng của người dùng.

Rà soát báo cáo đã tạo
Một báo cáo hoàn chỉnh bao gồm phân tích tài chính, hình minh họa DCF, các bảng tính toán, thông tin độ nhạy, những hạn chế của nguồn dữ liệu và các giả định kịch bản được công bố. Trang định giá kết hợp ba kịch bản dòng tiền với giá đóng cửa cổ phiếu theo ngày, cầu nối vốn chủ sở hữu và các giả định cuối kỳ.

Hãy kiểm tra rằng các loại tiền tệ dùng để báo cáo và định giá đã rõ ràng, ngày đóng cửa của cổ phiếu đã được ghi nhận, và các giả định khớp với kịch bản bạn dự định xem xét. Trên các thiết lập Windows được hỗ trợ, việc xuất PDF yêu cầu Microsoft Word và pdftoppm của Poppler có trong PATH, hoặc biến môi trường EQUITY_PDFTOPPM. Các hệ thống khác có thể tạo tài liệu Word bằng --skip-pdf.
Xác thực cài đặt
Chạy bộ kiểm thử công khai của kho mã sau khi cài đặt:
.venv/Scripts/python.exe -m pytest tests -qKho mã ghi nhận 35 bài kiểm thử công khai bao phủ công cụ tài chính, báo cáo công ty, bố cục, thảo luận về giả định, các tuyến HTTP cục bộ và kiểm soát ngân sách. Quy trình xác thực bản phát hành cũng kiểm tra việc tính toán lại tài chính, đẳng thức DuPont, chuyển đổi tiền tệ, giá trị biểu đồ, tính nhất quán của tài liệu và nguồn dữ liệu.
Việc xác thực đảm bảo tính nhất quán của phép tính và tài liệu, nhưng không thay thế việc đối chiếu với hồ sơ công bố của tổ chức phát hành hoặc nghiên cứu đầu tư dành riêng cho từng công ty.
Cách sử dụng nâng cao và các giới hạn quan trọng

Sử dụng snapshot cố định để tái lập kết quả
Các ví dụ đi kèm hỗ trợ phát lại ngoại tuyến những snapshot tài chính và kịch bản đã lưu. Điều này hữu ích cho việc kiểm thử, xem xét bố cục báo cáo và tái tạo các ví dụ được cung cấp mà không cần gửi yêu cầu mô hình mới.
Kiểm tra bằng chứng trước khi chấp nhận giả định
Các đề xuất của DeepSeek cần được xem xét cùng với phạm vi, lý do, tài liệu tham chiếu và lập luận phản biện. Các giả định chung cần được xem xét riêng cho từng công ty, còn các trường dữ liệu thứ cấp có thể cần được đối chiếu với hồ sơ công bố của tổ chức phát hành.
Hiểu phạm vi ngành
FCFF doanh nghiệp bị vô hiệu hóa đối với ngân hàng, công ty bảo hiểm, REIT và các lựa chọn khác thuộc lĩnh vực tài chính. Số dư hằng năm cũng có thể cần được cập nhật để phản ánh các khoản cổ tức, hoạt động tài trợ và sự pha loãng phát sinh về sau.
Kiểm tra trực quan các bản xuất mới
Kho mã có sẵn các bước xác thực cho những báo cáo được cung cấp, nhưng các bản xuất mới về nội dung diễn giải và bố cục vẫn cần được xem xét trực quan riêng. Hãy xác nhận rằng biểu đồ, bảng tính toán, tiền tệ, ngày tháng và các tệp đã tải xuống nhất quán với các đầu vào được chọn.
Kết luận
Equity Research Agent cung cấp một quy trình có cấu trúc, từ các dữ kiện công khai có ngày tháng đến nghiên cứu minh bạch và có thể chỉnh sửa. Hãy cài đặt công cụ cục bộ, chọn một mã chứng khoán được hỗ trợ, xem xét hoặc thảo luận về các giả định DCF, tính toán các kịch bản bằng công cụ xác định và kiểm tra báo cáo Word hoặc PDF tạo ra. Hãy xem các kết quả này là bản nháp nghiên cứu có điều kiện, không phải xếp hạng đầu tư hay mức giá mục tiêu được đảm bảo.
