آموزش DeepSeek Harness؛ نصب و اتصال به API هوش مصنوعی پاستا

مرحله دوم: انتخاب مدل در پاستا

به صفحه اتصال ابزارهای توسعه پاستا بروید و «DeepSeek Harness» را انتخاب کنید. سپس نام یا شناسه مدل‌ها را جست‌وجو کنید. قیمت هر یک میلیون توکن ورودی و خروجی کنار همان مدل نمایش داده می‌شود.

برای اولین آزمایش، یک مدل اقتصادی که توانایی Tool Calling و تولید کد مناسبی دارد انتخاب کنید. وظیفه کوتاه و قابل سنجش بدهید؛ مثلاً اجرای تست و توضیح اولین شکست. پس از اینکه کیفیت مسیر را دیدید، برای کار پیچیده‌تر مدل قوی‌تری انتخاب کنید. نام مدل‌های موجود و قیمت آن‌ها زنده است، بنابراین این مقاله یک نام یا قیمت ثابت و تاریخ‌مصرف‌دار پیشنهاد نمی‌کند.

مرحله سوم: ساخت کلید محدود API پاستا

1. در ابزار اتصال، مدل موردنظر را انتخاب کنید.
2. سقف هزینه روزانه را متناسب با آزمایش خود وارد کنید.
3. روی «ساخت اتصال DeepSeek Harness» بزنید.
4. کلید را همان لحظه در جای امن کپی کنید؛ مقدار کامل آن دوباره نمایش داده نمی‌شود.
5. تنظیم آماده settings.yaml را نیز کپی کنید.

کلید ساخته‌شده ۹۰روزه، محدود به همان مدل و هر زمان از صفحه کلیدهای API قابل لغو است. برای یک ابزار آزمایشی از کلید production برنامه دیگری استفاده نکنید.

مرحله چهارم: اتصال DeepSeek Harness به API پاستا

DeepSeek Harness برای Provider سفارشی از فایل ~/.dsh/settings.yaml استفاده می‌کند. تنظیم تولیدشده توسط پاستا شبیه نمونه زیر است. مقدار YOUR_MODEL_ID را از کاتالوگ زنده بردارید:

llm-pi-ai:
  providers:
    paasta:
      apiKeyEnv: PAASTA_API_KEY
      api: openai-completions
      baseURL: "https://console.paasta.cloud/api/ai/v1"
      models:
        - id: "YOUR_MODEL_ID"

سپس کلید را فقط در متغیر محیطی تعریف کنید.

Windows PowerShell

$env:PAASTA_API_KEY="کلید-دریافتی-از-پاستا"
npx @deepseek-ai/dsh web

macOS و Linux

export PAASTA_API_KEY="کلید-دریافتی-از-پاستا"
npx @deepseek-ai/dsh web

در رابط Harness، Provider پاستا و مدل انتخابی را از فهرست مدل‌ها انتخاب کنید. مستندات رسمی Harness می‌گوید Provider سفارشی باید Base URL، پروتکل، مرجع کلید و حداقل یک Model ID داشته باشد. پروتکل پاستا در این مسیر openai-completions است.

مرحله پنجم: اولین وظیفه امن را اجرا کنید

اولین درخواست را کوچک، برگشت‌پذیر و قابل بررسی نگه دارید. این نمونه مناسب‌تر از درخواست مبهم «کل پروژه را بهتر کن» است:

ساختار پروژه را بررسی کن.
تست‌ها را اجرا کن و فقط علت اولین تست ناموفق را توضیح بده.
هنوز هیچ فایلی را تغییر نده.

پس از بررسی توضیح Agent، وظیفه دوم را برای اصلاح همان مورد بدهید و از آن بخواهید تست مرتبط را دوباره اجرا کند. تغییرات Git را قبل از Commit بخوانید. Agent می‌تواند فرمان اجرا کند؛ بنابراین Repository ناشناس، Secretهای محیط و دسترسی‌های اضافی را در اختیار آن نگذارید.

کدام حالت DeepSeek Harness را انتخاب کنیم؟

حالت	کاربرد مناسب
Standard	Agent کامل برای کار روزمره، فایل، Shell، جست‌وجو، Skill و Workflow
Code	ترکیب چند عملیات ابزار در یک برنامه TypeScript برای وظایف چندمرحله‌ای
Minimal	آزمایش مدل با ابزارهای محدود Shell و ویرایش فایل
Creator	بررسی Runtime و ساخت یا آزمایش Plugin و Preset

برای شروع، Standard کافی است. تغییر حالت زمانی مفید است که دقیقاً بدانید به ابزار کمتر، اجرای برنامه‌پذیر یا توسعه Plugin نیاز دارید.

چطور هزینه Agent را کنترل کنیم؟

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

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

رفع خطاهای رایج

خطای MISSING_CREDENTIAL

Harness متغیر معرفی‌شده در apiKeyEnv را پیدا نکرده است. نام PAASTA_API_KEY را در فایل و محیط دقیقاً یکسان بنویسید و برنامه را از همان Terminal اجرا کنید.

خطای 401 یا Unauthorized

کلید ناقص، لغوشده یا منقضی است. کلید را در خروجی Terminal چاپ نکنید؛ یک اتصال تازه بسازید و مقدار محیطی را جایگزین کنید.

خطای UNKNOWN_MODEL

شناسه مدل داخل settings.yaml با مدل مجاز کلید یکسان نیست. Model ID را از کاتالوگ یا تنظیم آماده پاستا کپی کنید، نه نام نمایشی مدل را.

مدل نمایش داده می‌شود اما درخواست رد می‌شود

پروتکل را روی openai-completions و Base URL را دقیقاً روی مسیر /api/ai/v1 قرار دهید. اگر فایل YAML را دستی نوشته‌اید، فاصله‌گذاری آن را نیز بررسی کنید.

مصرف بیشتر از انتظار است

وظیفه را به مراحل کوچک تقسیم کنید، Context را محدود کنید و گزارش مصرف هر درخواست را ببینید. سقف روزانه کلید را پایین بیاورید تا آزمایش بدون هزینه کنترل‌نشده متوقف شود.

پاستا چه چیزی را برای DeepSeek Harness ساده می‌کند؟

پاستا جای Harness را نمی‌گیرد؛ مدل و مسیر API موردنیاز آن را فراهم می‌کند. به‌جای نگه‌داری چند حساب ارزی و چند کلید پراکنده، مدل‌های موجود را در یک کاتالوگ می‌بینید، قیمت نهایی را به تومان مقایسه می‌کنید و برای Harness یک کلید مستقل با مدل مجاز، Rate Limit، تاریخ انقضا و سقف هزینه می‌سازید.

اگر بعداً ابزار دیگری مانند OpenCode، Codex یا Hermes Agent را آزمایش کنید، همان حساب پاستا می‌تواند برای هر ابزار یک اتصال جدا بسازد. هر کلید مستقل قابل لغو و قابل گزارش است؛ در نتیجه لازم نیست کلید اصلی یک برنامه را بین Agentهای مختلف به اشتراک بگذارید. جزئیات فنی endpoint، Streaming و خطاها در مستندات API هوش مصنوعی پاستا آمده است.

API مدل DeepSeek را از کجا تهیه کنیم؟

برای دیدن مدل‌های فعال، قیمت تومانی و نمونه اتصال سازگار با OpenAI، صفحه خرید API دیپ‌سیک را ببینید. قیمت و موجودی را همان صفحه از کاتالوگ زنده بررسی کنید.