در این مقاله
برای اینکه ایجنت درباره اتفاق تازه یا محتوای یک سایت پاسخ بدهد، داشتن مدل زبانی کافی نیست. جستوجو باید منبع مناسب را پیدا کند، دریافت صفحه باید محتوای آن را برگرداند و مدل باید پاسخ را با همان شواهد بسازد. Search و Fetch دیپسیک دو ابزار مستقل برای این مرحله‌ها هستند. این راهنما مکمل آموزش نصب و اتصال DeepSeek Harness به پاستا است؛ نصب هارنس را دوباره تکرار نمی‌کند، بلکه روی ابزار وب، تفکیک کلیدها، هزینه و اعتبار منبع تمرکز دارد. نکته زمانی مهم: مستندات سازنده، شروع دریافت هزینه فراخوانیهای سمت سرور این ابزارها در Harness را اول نوامبر ۲۰۲۶ اعلام کرده‌اند.
مدل، Search، Fetch و Harness چه تفاوتی دارند؟
مدل زبانی متن را پردازش می‌کند؛ Search صفحه‌های مرتبط را پیدا می‌کند؛ Fetch محتوای یک نشانی مشخص را دریافت می‌کند؛ Harness جریان کار ایجنت و ابزارهایش را هماهنگ می‌کند. تغییر مدل لزوماً ابزار جستوجو را تغییر نمی‌دهد و موفقیت ابزار نیز صحت پاسخ نهایی را تضمین نمی‌کند. اگر پاسخ درباره یک نسخه تازه است، باید بدانید ایجنت واقعاً منبع جدید را خوانده یا فقط از دانسته قبلی مدل استفاده کرده است. در گزارش هر اجرا این مرحله‌ها را جدا نام‌گذاری کنید. عبارت کلی «درخواست هوش مصنوعی موفق بود» برای تشخیص محل خطا و هزینه کافی نیست.
قرارداد رسمی ابزارها را از قرارداد مدل جدا بخوانید
طبق راهنمای رسمی Search و Fetch، این ابزارها JSON API مستقل دارند. Search به مسیر /v1/tools/search و Fetch به مسیر /v1/tools/fetch روی دامنه دیپسیک ارسال می‌شود. این مسیرها همان Chat Completions نیستند و نام مدل نیز جای نشانی ابزار قرار نمی‌گیرد. اگر ارائهدهنده دیگری مدلی از خانواده DeepSeek عرضه می‌کند، ابتدا ببینید ابزار مستقل را هم مستند کرده است یا نه. در این مقاله عرضه این دو مسیر از طریق پاستا را تأیید نمی‌کنیم؛ نقش پاستا در نمونه معماری، تأمین مدل متنیِ موجود و اجرای بک‌اند مستقل است.
کلید پاستا و کلید دیپسیک قابل جابه‌جایی نیستند
نمونه مستقیم ابزار به کلید حساب همان سرویس نیاز دارد. کلید پاستا را در درخواست به api.deepseek.com قرار ندهید و کلید سرویس جستوجو را هم داخل مرورگر یا درخواست مدل نفرستید. برای هر سرویس متغیر محیطی و گزارش هزینه جدا داشته باشید. اگر یک ابزار یا کلاینت فقط یک محل برای تنظیم Base URL دارد، تصور نکنید تغییر آن، همه مسیرهای جانبی را نیز سازگار می‌کند. مستندات API پاستا قرارداد بخش مدل را مشخص می‌کند؛ تنظیم ابزارهای مستقل باید از مستندات خود همان ابزار بررسی شود.
یک درخواست کوچک Search بسازیم
قبل از فراخوانی، کلید معتبر دیپسیک را فقط در محیط بک‌اند قرار دهید. فرمان زیر نمونه مستقیم سازنده سرویس است و اجرای واقعی آن می‌تواند هزینه داشته باشد؛ در آماده‌سازی این مقاله، فراخوانی پولی انجام نشده است. پرسش را روی یک دامنه عمومی و محدود نگه می‌داریم و دریافت متن همه نتایج را در نخستین مرحله نمی‌خواهیم. برای جزئیات فیلدها، مرجع Search را ملاک قرار دهید. کوتاه‌بودن پرسش و محدودکردن دامنه معمولاً ارزیابی نتیجه را ساده‌تر می‌کند، اما کیفیت یا کمترین هزینه را به‌صورت خودکار تضمین نمی‌کند.
curl --fail-with-body https://api.deepseek.com/v1/tools/search \
-H "Authorization: Bearer ${DEEPSEEK_API_KEY}" \
-H "Content-Type: application/json" \
-d '{"query":"API documentation site:paasta.cloud","count":3,"need_content":false}'به‌جای پذیرش اولین نتیجه، عنوان، نشانی و ارتباط آن با سؤال را بررسی کنید. نتیجه خالی را به پاسخ خیالی تبدیل نکنید؛ برنامه باید بتواند نبود منبع کافی را اعلام کند. نشانی‌های مشابه ممکن است صفحه قدیمی، ترجمه ناقص یا محتوای کپی باشند. اگر یک سؤال برای پاسخ دقیق به سند اصلی نیاز دارد، رتبه بالاتر نتیجه به‌تنهایی معیار کافی نیست. در آزمون اولیه، نتیجه مورد انتظار را از قبل مشخص کنید تا روشن شود ابزار واقعاً صفحه عمومی مناسب را پیدا می‌کند، نه صرفاً چند نتیجه با واژه‌های مشابه.
نظرات کاربران (۰)
هنوز نظری ثبت نشده است. اولین نفر باشید.