openclaw-egp-plugin/skills/fetch-raw-file/SKILL.md

name	description
fetch-raw-file	Lấy URL download file PDF/XLSX/DOCX gốc theo file_id. Dùng khi user muốn xem hoặc tải file nguồn để kiểm tra nội dung.

Fetch Raw File URL

Khi nào dùng

• "Cho tôi xem file gốc của tài liệu X"
• "Tôi muốn download PDF này"
• "Link tải file gốc?"
• "Mở file để tôi check lại"

Workflow

1. Cần file_id (integer). Cách lấy:
   • Từ kết quả describe_entity (mỗi file có id).
   • Từ payload của search_procurement_docs (chứa file metadata).
2. Gọi fetch_raw_file_url(file_id=<id>).
3. Xử lý lỗi:
   • public_base_url not configured → "Server chưa config public URL, liên hệ admin."
   • file_not_found → "Không tìm thấy file_id <id>, vui lòng kiểm tra lại."
4. Nếu OK: trả URL dạng clickable link kèm filename và content_type để user biết file gì trước khi click.

Ví dụ

Agent:

→ fetch_raw_file_url(file_id=42)
← {url: "http://100.123.9.15:8000/files/42/raw", filename: "tender.pdf", content_type: "application/pdf"}

Reply: "📄 tender.pdf — PDF, click để download."

Anti-patterns

• ❌ Đừng tự bịa URL — phải gọi tool để lấy URL đúng (URL phụ thuộc cấu hình PUBLIC_BASE_URL của server, không cố định).
• ❌ Đừng giấu URL — luôn show để user click được.
• ❌ Đừng gọi tool này nếu user chỉ hỏi nội dung — dùng search_procurement_docs thay vì.
• ❌ Đừng đoán file_id — phải có từ describe_entity hoặc search results trước.