وقتی یک سند برای پنجرهٔ زمینه (context window) بیش از حد بزرگ باشد، فقط بخشی که نیاز دارید را تبدیل کنید. GroupDocs.Markdown.Mcp به یک عامل هوش مصنوعی اجازه می‌دهد تا صفحات یا کاربرگ‌های انتخاب‌شده را به صورت محلی به Markdown تبدیل کند، از Claude Desktop، Claude Code، Cursor یا GitHub Copilot، به‌طوری که مدل زبانی فقط یک فصل را می‌خواند و نه کل کتاب:

صفحات ۴۰ تا ۵۲ از فایل handbook.pdf را به Markdown تبدیل کنید.

نسخهٔ گام‌به‌گام با پیکربندی و عیب‌یابی در مستندات موجود است: How to convert just one section of a document to Markdown.

تبدیل محدوده‌ای چه صرفه‌جویی می‌کند؟

هر کلمه‌ای که در یک پرامپت می‌گذارید خوانده می‌شود، توسط ارائه‌دهندهٔ مدل هزینه‌گذاری می‌شود و با تمام کلمات دیگر برای توجه رقابت می‌کند. اکثر سؤالات دربارهٔ یک سند طولانی به بخش کوچکی از آن مربوط می‌شود. ابتدا همهٔ محتوا را تبدیل کنید و سپس از مدل بخواهید تا بیشتر آن را نادیده بگیرد، هزینهٔ کل سند را برای هر سؤال می‌پردازد.

صرفه‌جویی به راحتی می‌تواند روی سندی که مالک آن هستید اندازه‌گیری شود. در اینجا یک اندازه‌گیری واقعی به همراه روش آن آورده شده است. فایل منبع Markdown این صفحهٔ مجوزهای سرور ماست. ما آن را پس از بخش پیش‌مقدمه تقسیم کردیم و کلمات جدا شده با فاصله، بلوک‌های کد و نشانه‌گذاری‌های Hugo shortcode را شمردیم (کل صفحه ۸۱۰ کلمه بدون shortcodes بود). جدول نسبت بین یک بخش و کل صفحه را نشان می‌دهد؛ این نتیجهٔ اندازه‌گیری گزینهٔ pages نیست که صفحات را انتخاب می‌کند، نه عناوین:

بخش صفحه کلمات
مقدمه و سه حالت مجوزدهی ۱۶۷
محدودیت‌های حالت ارزیابی ۹۳
اعمال یک مجوز ۷۸
مجوزدهی متری (پرداخت به ازای استفاده) ۳۶۶
تأیید حالت فعال ۱۱۳
دریافت یک مجوز ۲۷
کل صفحه ۸۴۴

سؤالی دربارهٔ اینکه کدام حالت مجوز فعال است فقط به بخش ۱۱۳ کلمه‌ای نیاز دارد. این حدود ۱۳ درصد از صفحه یا تقریباً ۷٫۵ برابر کوتاه‌تر از کل است. شمارش به صورت کلمه انجام شده چون توکن‌ها به توکنایزر مدل وابسته‌اند؛ شمارش توکن‌ها با شمارش کلمات هم‌راستا می‌شود و ما عدد توکنی که اندازه‌گیری نکرده‌ایم را درج نکرده‌ایم. صفحه عمداً کوتاه است. دفترچهٔ شما بزرگ‌تر خواهد بود و نسبت را خودتان می‌شمارید.

روش ۱: کدام صفحات را می‌توانم مستقیماً نام ببرم؟

اگر صفحات را می‌دانید، بگویید. پارامتر pages در convert_to_markdown لیستی از اعداد ۱‑پایهٔ جداشده با کاما می‌گیرد، مانند "40,41,42". در این پارامتر سینتکس محدوده وجود ندارد؛ عامل «40 تا 52» را برای شما به لیست تبدیل می‌کند. اگر pages را حذف کنید، کل سند تبدیل می‌شود.

صفحات ۴۰ تا ۵۲ از فایل handbook.pdf را به Markdown تبدیل کنید.

نتیجه یک فایل .md ذخیره‌شده و محتوای بازگردانده‌شده به‌صورت درون‌خطی است. خروجی طولانی درون‌خطی کوتاه می‌شود و فایل ذخیره‌شده متن کامل را دارد.

روش ۲: چگونه فقط فصل ۳ را تبدیل کنم؟

ابزار گزینهٔ محدودهٔ عنوانی ندارد، بنابراین «فصل ۳» ابتدا باید به شمارهٔ صفحات تبدیل شود. این کار را در دو گام کوچک انجام دهید:

دفترچهٔ راهنمای handbook.pdf چند صفحه دارد و عنوان آن چیست؟

get_document_info بدون تبدیل فایل، اطلاعاتی مانند pageCount، title، author، fileFormat و isEncrypted را برمی‌گرداند. همچنین اگر رمز عبور لازم باشد، زودتر به شما می‌گوید. سپس صفحات فهرست مطالب را تبدیل کنید، آن‌ها را بخوانید و بازهٔ شمارهٔ صفحاتی که نام‌گذاری می‌کنند را بپرسید.

مثال جلسه (مختصر):

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.

دو تبدیل کوچک جای یک تبدیل عظیم را می‌گیرند.

روش ۳: چگونه یک کاربرگ از یک کتاب کار بگیرم؟

در فایل‌های XLSX، XLS و ODS، اعداد کاربرگ‌ها را انتخاب می‌کنند، نه صفحات چاپی:

کاربرگ ۲ از مدل را به Markdown تبدیل کنید.

این کار یک جدول را بدون سایر شیت‌های موجود در همان کتاب کار به سند اضافه می‌کند.

چه زمانی یک تبدیل محدوده‌ای ارزش گام اضافی را دارد؟

  • زمینه. مدل زبانی فقط بخشی که به سؤال پاسخ می‌دهد دریافت می‌کند و اسناد طولانی در داخل پنجره می‌مانند.
  • هزینهٔ متری. تحت مجوز متری فقط برای آنچه پردازش می‌کنید هزینه می‌گیرید، پس صفحات کمتر هزینهٔ کمتری دارد.
  • کیفیت بازیابی. یک ایندکس که فقط پیوست مرتبط را دارد، توسط بقیهٔ کاتالوگ در هر پرس‌وجو رقیق نمی‌شود.

اگر کل سند کار شماست، محدوده‌بندی نکنید. یک بار تبدیل کنید و Markdown را نگه دارید.

محدودیت‌های صادقانه: صفحات در حالت ارزیابی

بدون مجوز، سرور در حالت ارزیابی اجرا می‌شود: فقط اولین ۳ صفحه پردازش می‌شوند و هر کدام دارای watermark ارزیابی هستند. این رفتار pages را نادیده می‌گیرد. درخواست صفحات ۴۰ تا ۵۲ در حالت ارزیابی، بدون خطا صفحات ۱ تا ۳ را برمی‌گرداند، بنابراین تست یک فصل میانی کتاب بدون مجوز امکان‌پذیر نیست. اگر خروجی از جایی که انتظار داشتید شروع نشد، ابتدا get_license_status را فراخوانی کنید.

فهرست مطالب می‌تواند از برچسب‌های صفحهٔ چاپی استفاده کند. اگر صفحات تبدیل‌شده از عنوان مورد انتظار شروع نشدند، از عامل بخواهید صفحات همسایه را تبدیل کند و لیست را تنظیم کنید؛ get_document_info تعداد کل صفحات را می‌دهد که مرز لیست را تعیین می‌کند.

سؤالات متداول

چگونه فقط فصل ۳ را به Markdown تبدیل کنم؟

ابتدا شمارهٔ صفحات آن فصل را پیدا کنید، سپس در pages بگذارید. از عامل بخواهید صفحات فهرست مطالب را تبدیل کند، آن‌ها را بخواند و بازهٔ شمارهٔ صفحاتی که ارائه می‌دهند را درخواست کنید.

وقتی سند برای پنجرهٔ زمینه بزرگ است چه کار کنم؟

قسمتی از سند را تبدیل کنید، نه همهٔ آن. از pages برای انتخاب صفحاتی یا کاربرگ‌هایی که به سؤال شما پاسخ می‌دهند استفاده کنید و قبل از شروع، شمارش صفحات را با get_document_info بررسی کنید.

آیا می‌توانم صفحات PDF ۱۰ تا ۲۰ را با هوش مصنوعی به Markdown تبدیل کنم؟

بله. به زبان ساده بپرسید: «صفحات ۱۰ تا ۲۰ از report.pdf را به Markdown تبدیل کنید»، و عامل لیست گسترش‌یافتهٔ شمارهٔ صفحات را می‌فرستد. بدون مجوز، فقط اولین ۳ صفحه پردازش می‌شوند.

عمیق‌تر بروید