Khi một tài liệu quá lớn đối với cửa sổ ngữ cảnh, hãy chuyển đổi chỉ phần bạn cần. GroupDocs.Markdown.Mcp cho phép một tác nhân AI chuyển các trang hoặc worksheet đã chọn sang Markdown cục bộ, từ Claude Desktop, Claude Code, Cursor hoặc GitHub Copilot, vì vậy LLM chỉ đọc một chương chứ không phải toàn bộ cuốn sách:

Chuyển đổi các trang 40 đến 52 của handbook.pdf sang Markdown.

Phiên bản từng bước với cấu hình và khắc phục sự cố có trong tài liệu: How to convert just one section of a document to Markdown.

Chuyển đổi có phạm vi giúp tiết kiệm gì?

Mỗi từ bạn nhập vào lời nhắc đều được mô hình đọc, tính phí bởi nhà cung cấp và cạnh tranh để nhận được sự chú ý với các từ khác. Hầu hết các câu hỏi về một tài liệu dài chỉ liên quan đến một phần nhỏ của nó. Việc chuyển đổi toàn bộ trước, sau đó yêu cầu mô hình bỏ qua phần lớn, sẽ khiến bạn phải trả phí cho toàn bộ tài liệu cho mỗi câu hỏi.

Việc tiết kiệm dễ đo lường trên một tài liệu mà bạn sở hữu. Dưới đây là một phép đo thực tế, kèm theo phương pháp. Tệp là nguồn Markdown của trang giấy phép của máy chủ này trong tài liệu. Chúng tôi tách nó sau phần front matter và đếm các từ cách nhau bằng khoảng trắng, các khối code và markup shortcode của Hugo (toàn bộ trang có 810 từ nếu không tính shortcode). Bảng dưới minh họa tỷ lệ giữa một phần và toàn trang; nó không phải là kết quả đo được của tùy chọn pages, tùy chọn này chọn trang, không phải tiêu đề:

Phần của trang Từ
Giới thiệu và ba chế độ cấp phép 167
Giới hạn chế độ đánh giá 93
Áp dụng giấy phép 78
Cấp phép theo mức tiêu thụ (pay‑per‑use) 366
Xác nhận chế độ đang hoạt động 113
Nhận giấy phép 27
Toàn trang 844

Một câu hỏi về chế độ cấp phép đang hoạt động chỉ cần phần 113 từ. Đó là khoảng 13 % của trang, hay ngắn hơn toàn trang khoảng 7,5 lần. Đếm bằng từ vì token phụ thuộc vào tokenizer của mô hình; số token sẽ thay đổi cùng với số từ, và chúng tôi không đưa ra con số token mà không đo được. Trang này được giữ ngắn cố ý. Sổ tay của bạn sẽ lớn hơn, và tỷ lệ này bạn tự tính.

Cách 1: Tôi có thể đặt tên trực tiếp cho các trang nào?

Nếu bạn biết các trang, hãy chỉ rõ. Tham số pages của convert_to_markdown nhận danh sách các số đánh số từ 1 ngăn cách bằng dấu phẩy, ví dụ "40,41,42". Không có cú pháp dải trong tham số; tác nhân sẽ mở rộng “40 đến 52” thành danh sách cho bạn. Bỏ pages ra và toàn bộ tài liệu sẽ được chuyển đổi.

Chuyển đổi các trang 40 đến 52 của handbook.pdf sang Markdown.

Kết quả là một tệp .md đã lưu và nội dung được trả về ngay trong dòng. Đầu ra dài sẽ bị cắt ngắn trong dòng, còn tệp đã lưu chứa toàn văn bản.

Cách 2: Làm sao chuyển đổi chỉ chương 3?

Công cụ không có tùy chọn dựa trên tiêu đề, vì vậy “chương 3” phải được chuyển thành số trang trước. Thực hiện trong hai bước nhỏ:

Handbook.pdf có bao nhiêu trang và tiêu đề là gì?

get_document_info trả lời từ tệp mà không cần chuyển đổi: pageCount, title, author, fileFormat và isEncrypted. Nó cũng thông báo sớm nếu cần mật khẩu. Tiếp theo, chuyển đổi các trang mục lục, đọc chúng, và yêu cầu phạm vi mà chúng chỉ ra.

Phiên làm việc mẫu (rút gọn):

You:   How many pages does handbook.pdf have, and what is its title?
Agent: get_document_info -> pageCount: 212, title: "Operations Handbook".
You:   Convert pages 3 to 4 (the table of contents), then convert chapter 3.
Agent: convert_to_markdown (pages: "3,4") -> contents read: chapter 3 runs pages 61 to 64.
       convert_to_markdown (pages: "61,62,63,64") -> saved chapter 3 as Markdown.

Hai lần chuyển đổi nhỏ thay cho một lần chuyển đổi khổng lồ.

Cách 3: Làm sao lấy một worksheet từ một workbook?

Trong các tệp XLSX, XLS và ODS, các số chọn worksheet, không phải các trang đã in:

Chuyển đổi worksheet 2 của model sang Markdown.

Điều này đưa một bảng vào tài liệu mà không kèm các sheet khác cùng nằm trong cùng workbook.

Khi nào việc chuyển đổi có phạm vi đáng giá bước thực hiện thêm?

  • Ngữ cảnh. LLM nhận được phần trả lời câu hỏi, và các tài liệu dài vẫn nằm trong cửa sổ.
  • Chi phí theo mức tiêu thụ. Khi sử dụng giấy phép tính phí theo mức tiêu thụ, bạn chỉ bị tính phí cho những gì xử lý, vì vậy ít trang hơn đồng nghĩa với hoá đơn thấp hơn.
  • Chất lượng truy xuất. Một chỉ mục chỉ chứa phụ lục liên quan sẽ không bị pha loãng bởi toàn bộ thư viện khi mỗi truy vấn.

Nếu toàn bộ tài liệu là công việc cần thực hiện, đừng áp dụng phạm vi. Chuyển đổi một lần và giữ lại Markdown.

Giới hạn thực tế: các trang trong chế độ đánh giá

Không có giấy phép, máy chủ chạy ở chế độ đánh giá: chỉ 3 trang đầu được xử lý, mỗi trang có watermark đánh giá. Điều này ghi đè lên pages. Yêu cầu các trang 40 đến 52 trong chế độ đánh giá sẽ trả về các trang 1 đến 3 mà không có lỗi, vì vậy không thể thử một chương ở giữa cuốn sách khi chưa có giấy phép. Nếu đầu ra không bắt đầu ở vị trí bạn mong đợi, hãy gọi get_license_status trước.

Mục lục có thể sử dụng nhãn trang đã in. Nếu các trang đã chuyển đổi không bắt đầu ở tiêu đề mong muốn, hãy yêu cầu tác nhân chuyển đổi các trang lân cận và điều chỉnh danh sách; get_document_info cung cấp tổng số trang, giúp giới hạn danh sách.

Câu hỏi thường gặp

Làm sao tôi chuyển đổi chỉ chương 3 sang Markdown?

Đầu tiên tìm số trang của chương, sau đó truyền chúng vào pages. Yêu cầu tác nhân chuyển đổi các trang mục lục, đọc chúng, và yêu cầu phạm vi mà chúng cung cấp.

Tôi phải làm gì khi một tài liệu quá lớn cho cửa sổ ngữ cảnh?

Chuyển đổi phần của tài liệu, không phải toàn bộ. Dùng pages để chọn các trang hoặc worksheet trả lời câu hỏi của bạn, và kiểm tra số trang bằng get_document_info trước khi bắt đầu.

Tôi có thể chuyển đổi các trang PDF 10 đến 20 sang Markdown bằng AI không?

Có. Hãy hỏi bằng ngôn ngữ đơn giản, “Convert pages 10 to 20 of report.pdf to Markdown”, và tác nhân sẽ gửi danh sách các số trang đã được mở rộng. Khi không có giấy phép, chỉ 3 trang đầu được xử lý.

Tìm hiểu sâu hơn