3. Công cụ & hàm

Algolab MCP có 12 công cụ trong danh sách của AI (10 công cụ dữ liệu + search + call_function) và danh mục chuyên sâu gọi qua call_function. Nhóm công cụ giao dịch chỉ hiện với khoá đã bật quyền giao dịch — xem Giao dịch qua MCP.

3.1 Công cụ trực tiếp

get_market_overview

Tổng quan thị trường — toàn cảnh thị trường trong một lượt: chỉ số, độ rộng, dẫn dắt, khối ngoại, phái sinh, tổng kết phiên.

Toàn cảnh thị trường chứng khoán Việt Nam trong MỘT lượt: chỉ số (điểm, % thay đổi, P/E–P/B), top tăng/giảm, độ rộng kỹ thuật, 5 mã RS dẫn đầu, combo tín hiệu đang khớp, khối ngoại toàn thị trường, hợp đồng phái sinh gần nhất và bản tổng kết phiên mới nhất.

Dùng khi: "thị trường hôm nay", "VN-Index thế nào", cần bối cảnh trước khi phân tích mã. · Không dùng khi: cần chuỗi giá (→ get_price_history) hoặc khối ngoại từng mã chi tiết (→ call_function get_foreign_flows_detail).

Tham số: as_of (YYYY-MM-DD, mặc định phiên mới nhất); index (mặc định VNINDEX; VN30, HNX, UPCOM…).

Kết quả: chỉ số tính điểm; giá trị VND; khối lượng cổ phiếu; trong phiên là số realtime.

Xem thêm: get_technical_signals, get_news, get_intelligence.

Ví dụ:

get_market_overview()

get_price_history

Lịch sử giá (nến) — nến OHLCV mọi mã, khung 1 phút đến 1 tháng.

Chuỗi nến OHLCV của một mã bất kỳ: cổ phiếu (từ 2013), ETF, chứng quyền, chỉ số (từ 2017), phái sinh liên tục VN30F1M/VN30F2M (lưu từ 2017) hoặc từng hợp đồng; khung ngày/tuần/tháng và phút–giờ (cổ phiếu 50 phiên gần nhất có nến ATC 14:45, phái sinh từ 04/2026, chỉ số ~55 phiên gần nhất). Truy vấn được toàn bộ lịch sử.

Dùng khi: xu hướng, hỗ trợ/kháng cự, hiệu suất theo thời gian, khối ngoại theo ngày của một mã. · Không dùng khi: chỉ cần giá hiện tại (→ get_quotes).

Tham số: symbol; interval 1m|5m|15m|30m|1h|1d|1w|1mo; from_date/to_date; limit (mặc định 250, tối đa 1000); cursor lấy trang CŨ hơn.

Kết quả: bars dạng bảng — limit nến MỚI NHẤT trong khoảng, cũ trước mới sau; nến ngày là giá điều chỉnh (VND), nến phút là giá thô; cổ phiếu kèm khối ngoại ròng và sự kiện quyền.

Xem thêm: get_company_profile, get_technical_signals.

Ví dụ:

get_price_history(symbol="HPG", interval="1d", limit=120)

get_quotes

Giá realtime nhiều mã — giá realtime tối đa 50 mã một lượt (cổ phiếu, CW, ETF, chỉ số, phái sinh).

Giá realtime của tối đa 50 mã trong MỘT lượt — cổ phiếu, ETF, chứng quyền, chỉ số và phái sinh (kể cả VN30F1M/VN30F2M): giá khớp, % thay đổi, khối lượng, tốc độ khớp (RVOL), basis và OI phái sinh.

Dùng khi: "giá HPG bây giờ", so sánh nhanh nhiều mã, soi danh mục. · Không dùng khi: cần lịch sử (→ get_price_history) hoặc hồ sơ doanh nghiệp (→ get_company_profile).

Tham số: symbols — danh sách mã, vd ["HPG","VN30F1M","VNINDEX"].

Kết quả: mỗi mã một dòng; giá VND, chỉ số và phái sinh tính điểm; updated_at theo giờ sàn.

Xem thêm: get_market_overview, get_price_history.

Ví dụ:

get_quotes(symbols=["HPG", "VCB", "VNINDEX"])

get_company_profile

Hồ sơ doanh nghiệp — hồ sơ, sở hữu, định giá tự tính, hiệu suất, giá mục tiêu của một doanh nghiệp.

Hồ sơ một doanh nghiệp niêm yết: thông tin chung và ngành ICB 4 cấp, cơ cấu sở hữu, định giá (P/E, P/B, EPS, BVPS do AlgolabX tự tính với số cổ phiếu đúng thời điểm, kèm số của nhà cung cấp), hiệu suất giá, thanh khoản, giá mục tiêu đồng thuận CTCK và AlgolabX, sự kiện quyền/cổ tức.

Dùng khi: "HPG là công ty gì", "định giá VCB", bắt đầu phân tích một mã. · Không dùng khi: cần số liệu BCTC chi tiết (→ get_financial_statements).

Tham số: symbol; sections — chọn trong overview, ownership, valuation, performance, targets, events (mặc định tất cả trừ events).

Kết quả: mỗi section một khối; tiền VND, tỷ lệ % (hậu tố _pct).

Xem thêm: get_financial_statements, get_research_reports.

Ví dụ:

get_company_profile(symbol="HPG")

get_financial_statements

Báo cáo tài chính — BCTC theo mẫu ngành (KQKD, CĐKT, LCTT) + dự phóng AlgolabX.

Báo cáo tài chính theo đúng mẫu ngành (doanh nghiệp, ngân hàng, chứng khoán, bảo hiểm) của hơn 1.500 mã từ 2016: kết quả kinh doanh, cân đối kế toán, lưu chuyển tiền tệ theo quý hoặc năm; KQKD kèm dự phóng các quý tới của AlgolabX (tách riêng, không trộn với số đã công bố).

Dùng khi: tăng trưởng doanh thu/lợi nhuận, biên lợi nhuận, nợ vay, dòng tiền. · Không dùng khi: chỉ cần P/E, P/B, vốn hoá (→ get_company_profile).

Tham số: symbol; statement income|balance|cash (mặc định income); period quarter|annual; limit số kỳ (mặc định 8, tối đa 20); detail summary (dòng chính) | full (cả cây).

Kết quả: lines dạng bảng dòng × kỳ, đơn vị tỷ VND; dòng EPS tính đồng.

Xem thêm: search(kind="field") để tra mã chỉ tiêu.

Ví dụ:

get_financial_statements(symbol="VCB", statement="income", limit=4)

get_research_reports

Báo cáo phân tích CTCK — báo cáo 50 CTCK + AlgolabX, đồng thuận giá mục tiêu, upside.

Báo cáo phân tích của 50 CTCK và AlgolabX (gần 7.000 báo cáo từ 2022): danh sách kèm khuyến nghị, giá mục tiêu và link đọc; khi có symbol thì kèm đồng thuận giá mục tiêu, khuyến nghị mới nhất của từng CTCK, AlgolabX theo kỳ hạn và upside so với giá hiện tại.

Dùng khi: "CTCK nói gì về VCB", "giá mục tiêu HPG", báo cáo ngành/vĩ mô mới. · Không dùng khi: cần đọc toàn văn (→ call_function get_report_content với id).

Tham số: symbol; broker (vd SSI, VCI, HSC, ALGOLABX); from_date; limit (mặc định 20); cursor.

Kết quả: reports dạng bảng; giá VND; url là trang đọc trên algolab.vn — dùng link này khi dẫn nguồn.

Xem thêm: get_company_profile.

Ví dụ:

get_research_reports(symbol="VCB", limit=10)

get_news

Tin tức — tin doanh nghiệp có sentiment, tổng kết phiên, tin trong phiên.

Tin tức chứng khoán Việt Nam: tin doanh nghiệp kèm chấm điểm sentiment (Tích cực/Trung tính/Tiêu cực), bản tổng kết phiên cuối ngày và bản tin cập nhật trong phiên của AlgolabX; khi có symbol thì lọc theo mã.

Dùng khi: "tin mới về HPG", "hôm nay thị trường có gì", tìm chất xúc tác/rủi ro. · Không dùng khi: cần báo cáo phân tích (→ get_research_reports).

Tham số: symbol; kind company|recap|intraday|expert (recap + intraday); from_date; limit (mặc định 20 tin doanh nghiệp / 5 bản tin, tối đa 100); cursor.

Kết quả: items mới nhất trước; published_at dạng ISO.

Xem thêm: get_market_overview.

Ví dụ:

get_news(symbol="HPG", limit=10)

get_technical_signals

Tín hiệu kỹ thuật — RS đa khung, MACD, bắt đáy, độ rộng, combo tín hiệu đã backtest.

Phân tích kỹ thuật định lượng của AlgolabX: xếp hạng sức mạnh giá RS đa khung, MACD, tín hiệu bắt đáy, beta, độ lệch chuẩn lợi suất; độ rộng thị trường; các combo tín hiệu đã backtest từ 2020 (tỉ lệ thắng, lợi suất vượt VN-Index) kèm danh sách mã đang khớp hôm nay.

Dùng khi: tìm mã mạnh/yếu, xác nhận xu hướng, quét cơ hội theo bằng chứng lịch sử. · Không dùng khi: cần chuỗi giá (→ get_price_history).

Tham số: symbol (một mã) hoặc top (mặc định 20, tối đa 200); as_of; min_adtv (sàn thanh khoản VND, mặc định 10 tỷ); detail summary|full.

Kết quả: tickers dạng bảng (RS là percentile 0–100, lợi suất %); signal_combos; market_breadth.

Xem thêm: get_market_overview.

Ví dụ:

get_technical_signals(top=20)

get_macro

Vĩ mô nhanh — vĩ mô Việt Nam & thế giới (14 chuỗi chính) + FedWatch.

Vĩ mô nhanh: Việt Nam (CPI, GDP, M2, tỷ giá trung tâm, IIP, bán lẻ) và thế giới (vàng, dầu Brent/WTI, S&P 500, Nasdaq, lợi suất TPCP Mỹ 10 năm, DXY, USD/VND) kèm FedWatch — xác suất Fed cắt/giữ/tăng lãi suất các kỳ họp tới.

Dùng khi: bối cảnh vĩ mô, tác động tỷ giá/lãi suất lên thị trường. · Không dùng khi: cần chỉ tiêu khác — kho có hơn 1.300 chỉ tiêu (→ search kind="macro" rồi call_function get_macro_series).

Tham số: scope vietnam|world|all; symbols (vd ["CPI","GOLD"]); from_date/to_date; limit số quan sát MỚI NHẤT mỗi chuỗi (mặc định 24).

Kết quả: series có latest, previous và obs dạng bảng; fed_outlook.

Xem thêm: call_function browse_macro.

Ví dụ:

get_macro(scope="all")

get_intelligence

★ AlgolabX Intelligence — ★ dự báo VN-Index các tháng tới, tín hiệu phái sinh 4 mô hình, danh mục AlgolabX (độc quyền).

★ Sản phẩm độc quyền AlgolabX (không phải dữ liệu thô): dự báo VN-Index các tháng tới (đường dự báo + dải tin cậy 50/80/95%) kèm luận điểm và kịch bản — cập nhật định kỳ, không phải mỗi phiên (luôn nêu as_of của bản đang dùng); tín hiệu phái sinh VN30F từ 4 mô hình (xu hướng, hồi quy, carry, chênh lệch); 2 danh mục mô hình đang công bố (Cơ bản và AlphaLab định lượng) với tỷ trọng, hiệu suất, alpha.

Dùng khi: "VN-Index cuối năm bao nhiêu", "AlgolabX đang nghĩ gì", khẩu vị rủi ro trung hạn. · Không dùng khi: cần giá hiện tại (→ get_quotes).

Tham số: as_of (mặc định bản mới nhất); section — đọc toàn văn một mục luận điểm (số mục hoặc từ khoá); detail summary|full.

Kết quả: forecast (chỉ số chính + đường dự báo lấy mẫu, điểm), thesis (tóm tắt + mục lục), derivatives_signals, suggested_portfolios — tham khảo, không phải khuyến nghị cá nhân.

Xem thêm: get_market_overview.

Ví dụ:

get_intelligence()

search

Tìm dữ liệu — tìm hàm, mã, ngành, chỉ tiêu BCTC, chỉ tiêu vĩ mô (có/không dấu).

Tìm mọi thứ trong kho dữ liệu Algolab bằng từ khoá tiếng Việt (có/không dấu) hoặc tiếng Anh: hàm dữ liệu (kèm tham số và ví dụ gọi), mã chứng khoán (toàn bộ mã đang niêm yết: cổ phiếu, ETF, chứng quyền, phái sinh, chỉ số), ngành ICB, chỉ tiêu BCTC (hơn 3.300), chỉ tiêu vĩ mô (hơn 1.300).

Dùng khi: không chắc tên mã/hàm/chỉ tiêu; muốn biết Algolab có dữ liệu gì về một chủ đề. · Không dùng khi: đã biết công cụ cần gọi.

Tham số: query; kind auto|function|symbol|sector|field|macro; limit (mặc định 10).

Kết quả: nhóm functions / symbols / sectors / fields / macro; hàm danh mục gọi qua call_function.

Xem thêm: call_function.

Ví dụ:

search(query="lãi suất liên ngân hàng")

call_function

Gọi hàm chuyên sâu — chạy hàm trong danh mục chuyên sâu theo tên.

Chạy một hàm trong danh mục dữ liệu chuyên sâu của Algolab theo tên, với tham số dạng object. Sai tên → gợi ý tên gần nhất; sai tham số → trả danh sách tham số và ví dụ đúng.

Dùng khi: cần dữ liệu ngoài 10 công cụ chính (danh mục bên dưới). · Không dùng khi: công cụ trực tiếp đã đủ.

Tham số: name; arguments (object).

Kết quả: cùng dạng {status, data, meta} như mọi công cụ.

Xem thêm: search.

Ví dụ: call_function(name="get_warrants", arguments={"underlying": "HPG"}).

Ví dụ:

call_function(name="get_warrants", arguments={"underlying": "HPG"})

3.2 Danh mục chuyên sâu (qua call_function)

get_index_intraday

Chuỗi điểm chỉ số trong phiên — chuỗi điểm trong phiên của chỉ số (mỗi phút).

Chuỗi điểm trong phiên của một chỉ số (điểm cuối mỗi phút, các phiên trong 5 ngày gần nhất; nến phút lâu hơn → get_price_history interval="1m") kèm giá trị hiện tại và định giá P/E–P/B của chính chỉ số.

Dùng khi: cần diễn biến chi tiết từng thời điểm trong phiên. · Không dùng khi: cần nến phút/giờ gọn (→ get_price_history interval="5m") hoặc chỉ cần điểm hiện tại (→ get_quotes).

Tham số: index (mặc định VNINDEX); from_date, to_date (ngày hoặc ISO datetime).

Kết quả: points dạng bảng {ts (giờ VN), value, change, change_pct, volume}.

Xem thêm: get_market_overview.

Ví dụ:

call_function(name="get_index_intraday", arguments={"index": "VN30"})

get_foreign_flows_detail

Khối ngoại toàn thị trường — khối ngoại toàn thị trường một phiên, top mua/bán ròng.

Khối ngoại toàn thị trường một phiên: tổng mua/bán/ròng (khối lượng, giá trị) và xếp hạng các mã bị bán ròng / được mua ròng mạnh nhất; phiên đang chạy lấy số trong phiên từ feed SSI.

Dùng khi: "khối ngoại hôm nay bán ròng mã nào", tiền ngoại đang dồn vào đâu. · Không dùng khi: cần khối ngoại theo ngày của MỘT mã (→ get_price_history, cột foreign_net).

Tham số: date (YYYY-MM-DD, mặc định phiên mới nhất); top (mặc định 20, tối đa 50).

Kết quả: khối lượng cổ phiếu, giá trị VND (âm = bán ròng); value_is_estimate cho biết có phần ước tính.

Xem thêm: get_market_overview.

Ví dụ:

call_function(name="get_foreign_flows_detail", arguments={"top": 10})

get_corporate_events

Sự kiện quyền & cổ tức — sự kiện quyền, cổ tức, ĐHCĐ, giao dịch nội bộ của một mã.

Sự kiện quyền và cổ tức của một mã: cổ tức tiền (đồng/cp) và cổ phiếu (%), đại hội cổ đông, phát hành, công bố KQKD, giao dịch nội bộ, thay đổi sở hữu.

Dùng khi: "HPG chia cổ tức khi nào", lịch sự kiện sắp tới, giải thích biến động giá quanh ngày GDKHQ. · Không dùng khi: cần tin tức (→ get_news).

Tham số: symbol; from_date (mặc định 12 tháng trước); to_date (mặc định 6 tháng tới).

Kết quả: events theo ngày tăng dần.

Xem thêm: get_company_profile, get_price_history.

Ví dụ:

call_function(name="get_corporate_events", arguments={"symbol": "HPG"})

list_symbols

Danh sách mã — danh sách mã theo loại, sàn, ngành ICB.

Danh sách mã chứng khoán lọc theo loại (cổ phiếu, ETF, chứng quyền, phái sinh, chỉ số), sàn, tiền tố hoặc ngành ICB cấp 1–4 (tên có/không dấu, Việt hoặc Anh); cổ phiếu xếp theo vốn hoá.

Dùng khi: "các mã ngành ngân hàng", "chứng quyền đang lưu hành", lấy danh sách để so sánh. · Không dùng khi: tìm một mã theo tên công ty (→ search kind="symbol").

Tham số: kind (mặc định stock); exchange HOSE|HNX|UPCOM; prefix; sector + icb_level (mặc định 2); limit (mặc định 100, tối đa 2000); cursor.

Kết quả: symbols dạng bảng + total.

Xem thêm: search, get_quotes.

Ví dụ:

call_function(name="list_symbols", arguments={"sector": "Ngân hàng", "limit": 30})

screen_stocks

Lọc cổ phiếu — lọc cổ phiếu theo định giá, sinh lời, hiệu suất giá, RS, thanh khoản, khối ngoại, ngành, cờ tín hiệu.

Lọc cổ phiếu đang niêm yết: điều kiện AND trên chỉ tiêu, sàn, ngành ICB, cờ tín hiệu phiên gần nhất; P/E, P/B do AlgolabX tự tính.

Dùng khi: "cổ phiếu P/E dưới 10, ROE trên 15%", "ngân hàng tăng mạnh nhất 3 tháng", "mã có tín hiệu P/E rẻ hơn lịch sử". · Không dùng khi: xem chi tiết một mã (→ get_company_profile).

Tham số: conditions — [{field, op (>, >=, <, <=, =, between), value}], field: price, change_pct, market_cap, pe, pb, eps_ttm, roe, roa, gross_margin, net_margin, debt_to_equity, revenue_growth_yoy, profit_growth_yoy, return_1w, return_1m, return_3m, return_6m, return_ytd, return_1y, rs_score, rs_1m, rs_3m, adtv_1m, foreign_net_value; exchange HOSE|HNX|UPCOM; sector; flags (khoá cờ, sai → gợi ý); sort_by, order; limit (mặc định 50, tối đa 500); cursor.

Kết quả: stocks dạng bảng (mã, tên, sàn, ngành + chỉ tiêu đã lọc/sắp) + total; đơn vị ở meta.units.

Xem thêm: get_company_profile, get_technical_signals, list_symbols.

Ví dụ:

call_function(name="screen_stocks", arguments={"conditions": [{"field": "pe", "op": "<", "value": 10}, {"field": "roe", "op": ">", "value": 15}], "sort_by": "roe", "limit": 20})

get_report_content

Toàn văn báo cáo — toàn văn báo cáo phân tích (markdown) theo id.

Toàn văn một báo cáo phân tích dạng markdown (bảng số liệu giữ nguyên) kèm khuyến nghị, giá mục tiêu, link PDF — không cần tải PDF.

Dùng khi: tóm tắt, so sánh, trích số liệu từ một báo cáo cụ thể. · Không dùng khi: chưa có id (→ get_research_reports trước).

Tham số: report_id (id từ get_research_reports); part (mặc định 1 — báo cáo dài chia phần ~60.000 ký tự).

Kết quả: content markdown của phần đó, part/parts (còn phần sau thì gọi part kế tiếp), content_source, pdf_url.

Xem thêm: get_research_reports.

Ví dụ:

call_function(name="get_report_content", arguments={"report_id": 12345})

get_warrants

Chứng quyền — bảng giá chứng quyền kèm giá thực hiện, đáo hạn, ITM/OTM, hoà vốn.

Bảng giá chứng quyền có bảo đảm realtime kèm đặc tả: mã cơ sở, tổ chức phát hành, giá thực hiện, tỷ lệ chuyển đổi, ngày đáo hạn, số ngày còn lại, giá cơ sở hiện tại, trạng thái ITM/ATM/OTM, điểm hoà vốn.

Dùng khi: "chứng quyền của HPG", CW thanh khoản nhất, chọn CW theo moneyness. · Không dùng khi: cần lịch sử giá CW (→ get_price_history).

Tham số: underlying (mã cơ sở) hoặc symbol (một CW); limit (mặc định 60, tối đa 200), sắp theo giá trị giao dịch.

Kết quả: warrants dạng bảng; giá VND.

Xem thêm: get_quotes.

Ví dụ:

call_function(name="get_warrants", arguments={"underlying": "HPG"})

get_derivatives_snapshot

Phái sinh realtime — mọi hợp đồng tương lai: giá, basis, OI, CVD mua/bán chủ động.

Ảnh chụp realtime mọi hợp đồng tương lai chỉ số đang giao dịch: giá, % thay đổi, basis so với chỉ số cơ sở, OI, khối lượng, giá chào mua/bán tốt nhất, hợp đồng tháng gần; kèm CVD mua/bán chủ động VN30F 5 phiên gần nhất.

Dùng khi: "basis phái sinh hôm nay", vị thế phe mua/bán chủ động. · Không dùng khi: cần lịch sử (→ get_price_history symbol="VN30F1M").

Tham số: không có.

Kết quả: contracts dạng bảng (điểm, hợp đồng); orderflow_cvd.

Xem thêm: get_quotes, get_intelligence.

Ví dụ:

call_function(name="get_derivatives_snapshot", arguments={})

browse_macro

Duyệt cây chỉ tiêu vĩ mô — duyệt cây chỉ tiêu vĩ mô theo nhóm.

Duyệt cây chỉ tiêu vĩ mô Việt Nam + thế giới theo nhóm: không tham số → danh sách nhóm (tăng trưởng, lạm phát, lãi suất, tỷ giá, thương mại, đầu tư, ngân sách, lao động, BĐS CBRE, hàng hoá…); category → đầu cây của nhóm; parent_key → các chỉ tiêu con.

Dùng khi: muốn biết Algolab có những chỉ tiêu vĩ mô nào về một chủ đề. · Không dùng khi: đã biết tên chỉ tiêu (→ search kind="macro").

Tham số: category; parent_key; region.

Kết quả: items {key, name, unit, is_group, has_children}; dùng key với get_macro_series.

Xem thêm: get_macro_series.

Ví dụ:

call_function(name="browse_macro", arguments={"category": "rates"})

get_macro_series

Chuỗi chỉ tiêu vĩ mô — chuỗi số liệu một chỉ tiêu vĩ mô bất kỳ theo key.

Chuỗi số liệu của MỘT chỉ tiêu vĩ mô bất kỳ trong kho hơn 1.300 chỉ tiêu (lưu từ 1985, có cả số dự báo) theo key; truy vấn được toàn bộ lịch sử, đặt to_date ở tương lai để lấy số dự báo.

Dùng khi: cần lịch sử một chỉ tiêu cụ thể (lãi suất liên ngân hàng, FDI, xuất khẩu, giá thép…). · Không dùng khi: chưa có key (→ search kind="macro" hoặc browse_macro).

Tham số: key; from_date, to_date; limit số quan sát MỚI NHẤT (mặc định 90, tối đa 2000).

Kết quả: obs dạng bảng {date, value} tăng dần; unit, frequency.

Xem thêm: get_macro.

Ví dụ:

call_function(name="get_macro_series", arguments={"key": "vn-cpi-yoy-headline-cpi-yoy", "limit": 24})

get_quota

Hạn mức khoá API — hạn mức của khoá đang dùng: đã dùng, còn lại, giờ đặt lại.

Hạn mức của khoá đang dùng: gói, số lượt đã dùng hôm nay / hạn mức ngày, còn lại, giới hạn tốc độ mỗi phút, giờ đặt lại; free và lite dùng chung một pool toàn hệ thống.

Dùng khi: người dùng hỏi về quota, hạn mức, vì sao bị chặn. · Không dùng khi: cần dữ liệu thị trường.

Tham số: không có.

Kết quả: plan_code, daily_quota, used_today, remaining, rate_limit_per_minute, reset_at.

Xem thêm: https://algolab.vn/account/upgrade.

Ví dụ:

call_function(name="get_quota", arguments={})

report_issue

Báo lỗi cho Algolab — báo lỗi hoặc dữ liệu sai cho đội AlgolabX, kèm ngữ cảnh lượt gọi gần nhất.

Gửi báo cáo lỗi / dữ liệu sai cho đội AlgolabX; máy chủ tự đính kèm tối đa 10 lượt gọi gần nhất của khoá (tên hàm, tham số, mã lỗi) để tái hiện.

Dùng khi: một hàm lỗi lặp lại (INTERNAL, UPSTREAM_ERROR, TIMEOUT), số liệu rõ ràng sai, thiếu dữ liệu, người dùng muốn góp ý. · Không dùng khi: lỗi tham số (INVALID_ARGUMENT) — sửa theo error.hint.

Tham số: description (10–2000 ký tự); function (tuỳ chọn); severity low|normal|high.

Kết quả: id báo cáo + status received. Tối đa 5 báo cáo mỗi giờ.

Xem thêm: get_quota.

Ví dụ:

call_function(name="report_issue", arguments={"description": "get_quotes trả giá HPG = 0 trong phiên sáng 25/09", "function": "get_quotes", "severity": "normal"})

3.3 Quy ước kết quả

Mọi công cụ trả một khối JSON:

{"status": "ok", "data": {...}, "meta": {"function": "get_price_history", "source": "...", "as_of": "...",
 "units": {...}, "count": 250, "next_cursor": null, "truncated": false, "related": [...], "quota": {"used": 12, "limit": 1000}}}

• status: ok · partial (một phần nguồn lỗi, vẫn có dữ liệu) · empty (hợp lệ nhưng không có dữ liệu) · error.
• Bảng (≥ 5 dòng) trả dạng {columns, rows}; object con nhỏ làm phẳng thành cột cha.con.
• Phân trang: truyền nguyên meta.next_cursor vào tham số cursor, giữ các tham số khác.
• Tham số vượt trần bị kẹp và ghi trong meta.clamped; kết quả quá 200 KB bị cắt (meta.truncated).

Bản Markdown · llms.txt