You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

This repo is archived. You can view files and clone it, but cannot push or open issues/pull-requests.

name	description
describe-entity	Xem chi tiết một hồ sơ theo entity_code — metadata, danh sách files, trạng thái index. Dùng khi user hỏi sâu về một record cụ thể.

Describe Entity

Khi nào dùng

Cần entity_code chính xác. Nếu user nói mơ hồ ("hồ sơ A", "cái gói thầu hôm qua"):
- Hỏi lại để clarify, hoặc
- Dùng list_entities để tìm trước rồi xác nhận với user.
Gọi describe_entity(entity_code="<mã>").
Xử lý lỗi:
- Tool raise entity_not_found → thông báo user "Không tìm thấy hồ sơ <mã>", gợi ý dùng list_entities để xem danh sách.
Nếu OK: trả lời gồm:
- Metadata: type, status, ngày tạo / cập nhật.
- Bảng files: mỗi row có id (cần cho fetch-raw-file), file_name, file_type, size.

User: "Chi tiết hồ sơ TBMT-2026-001"

Agent:

→ describe_entity(entity_code="TBMT-2026-001")
← {entity: {...}, files: [{id: 10, file_name: "main.pdf", ...}, ...]}

Reply: metadata + bảng files với cột id để user/agent có thể tham chiếu khi cần download.

❌ Đừng đoán entity_code — phải hỏi nếu user mơ hồ.
❌ Đừng tóm tắt nội dung file dựa vào file_name — đó là việc của search_procurement_docs.
❌ Đừng giấu id của file — agent/user cần id để tải file gốc qua fetch_raw_file_url.