آنتروپیک در 19 اوت Files API را از حالت بتا خارج و مجموعهای از ابزارهای مرورگری جدید منتشر کرد. این ابزار به توسعهدهندگان اجازه میدهد سندی را یکبار آپلود کنند و در درخواستهای بعدی با شناسهٔ فایل به آن ارجاع دهند، بهجای قرار دادن محتوای کامل سند در هر پرامپت. تجربه عملی با مدل claude-sonnet-5 نشان داد Files API فرآیند مدیریت و دسترسی به سند را سادهتر میکند، اما بهتنهایی صرفهجویی توکنی را تضمین نمیکند.
روش آزمایشی
برای ارزیابی عملکرد، مرجع API ساختگیِ 1,200 کلمهای برای سرویس فاکتورسازی Ledgerline تهیه شد که احراز هویت، محدودیت نرخ، ایدمپوتنسی، وبهوکها، نقاط انتهایی دستهای و سندباکس را پوشش میداد. سناریو شبیهسازی یک بات پشتیبانی توسعهدهنده بود که فقط از همین مرجع استفاده میکرد. پنج پرسش مشخص طراحی شد و پاسخ هر کدام دقیقاً در سند آمده بود:
- چگونه دو خطای 403 متفاوت را تشخیص دهیم و هر کدام چگونه رفع میشود
- چگونه بعد از timeout ساخت پرداخت را بهصورت امن دوباره تلاش کنیم
- چگونه امضای وبهوک را تایید و حملات بازپخش را مسدود کنیم (Webhook)
- روش مناسب برای ایجاد 2,000 فاکتور در یک شب
- اقدامات لازم در صورت افشای توکن مخفی API در یک مخزن عمومی
همین پرسشها سهبار اجرا شد، همه روی همان مدل و با همان دستورالعملها:
- گروه 1: مرجع کامل در هر درخواست الصاق شد (چسباندن هر بار)
- گروه 2: مرجع یکبار با Files API آپلود و در هر درخواست با شناسهٔ فایل ارجاع داده شد
- گروه 3: مرجع یکبار در پرامپت سیستمی الصاق و کش پرامپت فعال شد (استفاده از Cache)
راهاندازی و مشکلات اولیه
دو ملاحظهٔ فنی قبل از اجرا ظاهر شد: پارامتر دما (temperature) در claude-sonnet-5 منسوخ شده بود و مقدار صفر توسط API پذیرفته نمیشد؛ همچنین یک بلوک «تفکر» در ابتدای پاسخ باعث خطا در چاپ خروجی میشد. هر دو مورد با اصلاح سادهٔ تنظیمات حل شد. فرایند آپلود با Files API ساده و شامل یک فراخوان که شناسهای بازمیگرداند و شناسه را در همهٔ درخواستها قابل استفاده میکرد.
نتایج عددی و تحلیل
کیفیت پاسخها بین سه گروه تفاوت محسوس نداشت؛ همهٔ پانزده پاسخ با کلیدِ مرجع مطابقت داشتند و جزئیات حساس مثل محدودیت نرخ یا محدودهٔ توکن بهدرستی بیان شد. اما صورتحساب توکنی متفاوت بود:
| روش | توکن ورودی | نوشتن کش | خواندن کش | خروجی |
|---|---|---|---|---|
| چسباندن هر بار (Arm 1) | 15,246 | 0 | 0 | 1,399 |
| Files API (Arm 2) | 15,371 | 0 | 0 | 1,434 |
| کش پرامپت (Arm 3) | 271 | 2,990 | 11,960 | 1,642 |
نکتهٔ کلیدی: Files API کمی بیشتر از روش الحاق مرجع در هر درخواست، توکن ورودی صورتحساب کرد. دلیل آن این است که محتوای فایل همچنان در هر درخواست پردازش میشود و ارجاع به شناسهٔ فایل حدود 25 توکن سربار اضافه میکند. در پنج درخواست، آپلود یکباره حدود 125 توکن ورودی اضافی بههمراه داشت و آزمایش هیچ نشانهای از معکوسشدن این روند نشان نداد.
در مقابل، کش پرامپت رفتار متفاوتی داشت: سند یکبار بهصورت نوشتن کش (2,990 توکن) صورتحساب شد و پرسشهای بعدی از خواندن کش استفاده کردند که هزینهٔ خواندن کش تقریباً یکدهم نرخ ورودی عادی بود. نتیجهٔ عملی آن این است که اگر درخواستها پشتسرِ هم بیایند، کش میتواند هزینهها را بهطور قابلتوجهی کاهش دهد؛ اما کش پس از حدود پنج دقیقه عدم فعالیت منقضی میشود، بنابراین الگوی درخواستها باید متوالی و زمانبندیشده باشد تا بهرهوری حاصل شود.
چه زمانی هر روش مناسب است
چه زمانی از Files API آنتروپیک استفاده کنید
Files API برای مواردی مناسب است که مدیریت سند اولویت دارد: نگهداری فایلهای غیرفرمت متنی مثل PDF یا تصویر، ارجاع با شناسهٔ مجزا، مدیریت نسخه و کنترل انقضا. این رویکرد خوانایی کد را افزایش و مدیریت فایلها را متمرکز میکند. با این حال، انتظار صرفهجویی خودکار در هزینهٔ توکن نباید وجود داشته باشد؛ هدف اصلی مدیریت و ارجاع سادهٔ فایل است.
چه زمانی کش پرامپت مناسبتر است
اگر هدف اصلی کاهش هزینهٔ توکن است و پرسشها بهصورت پشتسرِ هم و در بازهٔ زمانی کوتاه ارسال میشوند، کش پرامپت گزینهٔ برتر است. در این مدل، سند یکبار بهطور کامل صورتحساب میشود و سپس خواندن کش هزینهٔ بسیار کمتری دارد. پیادهسازی نیازمند بازطراحی پرامپت و مدیریت انقضای کش است تا الگوی مصرف از مزایای آن بهرهمند شود.
جمعبندی و راهکار عملی
Files API آنتروپیک کار مدیریت و ارجاع سند را ساده میکند و برای سناریوهای نیازمند ذخیرهٔ فایل و ارجاع مجزا مفید است، اما بهتنهایی صرفهجویی توکنی تضمین نمیکند. برای کاهش واقعی هزینهها باید از کش پرامپت یا مکانیسمهای مشابه استفاده کنید و الگوی درخواستها را طوری طراحی کنید که از خواندن مکرر سند جلوگیری شود. در انتخاب بین این دو رویکرد، نیازهای عملیاتی (فرمت فایل، سیاست نگهداری، دسترسی) را در کنار الگوی مصرفی (پیوستگی درخواستها، حساسیت به هزینه) قرار دهید.
برای مطالعهٔ بیشتر دربارهٔ شرکت آنتروپیک میتوانید به صفحهٔ Anthropic در ویکیپدیا مراجعه کنید. توضیحات بیشتر دربارهٔ مفاهیم کش و وبهوک نیز در منابع Cache و Webhook در دسترس است.
