درخواست
هدف را مشخص میکنی.
آموزش تصویری امیر یوسفی
از گفتوگو
تا انجام کار
به ایجنتت یک کار مشخص بسپار.
با DeepSeek Harness، از مفهوم تا اولین اجرا همراهت هستم.
مدلفهمیدن و تصمیمگرفتن
ابزارهاقدم بعدی، انجامدادن است.
یک مدل، با امکانات بیشتر
MODEL → TOOLS → ACTIONفکر، ابزار، انجام کار
مسیر این آموزش
بفهم. وصل کن. تجربه کن.
این صفحه، جزوهٔ توست. از اول همراه شو یا مستقیم سراغ قدمی برو که لازم داری.
اول، تصویر بزرگتر
هوش دارد.
حالا امکانات میخواهد.
برای فهم ایجنت، از یک تفاوت ساده شروع کنیم: فهمیدن یک درخواست و انجامدادن آن.
مدل، بخش فکرکردن است.
درخواست را میخواند، اطلاعات را کنار هم میگذارد و قدم بعدی را پیشنهاد میدهد. اما برای کار با فایلها یا اجرای یک دستور، به ابزار و محیط اجرا نیاز دارد.
مثلاً میپرسی:
این فایل را چطور خلاصه کنم؟
مدل
نمایش سادهشدهٔ مفهوم؛ نه تصویر یک محصول
یک قدم جلوتر
به مدل،
دستِ کار بده.
هارنس، مدل را به ابزارها و محیط کار متصل میکند؛ نتیجهٔ هر کار را به مدل برمیگرداند تا بتواند ادامه بدهد.
فایلهاخواندن، ساختن و ویرایش
ترمینالاجرای فرمان و دیدن نتیجه
ابزارها و اطلاعاتکمک برای پیشبردن کار
مدل + امکانات کار
مدلهارنس و ابزارها
هارنس، سازوکار کار است؛ فقط ظاهر صفحه نیست.
کنار هم، میشوند ایجنت.
دستیاری که با دیدن نتیجهٔ هر قدم، قدم بعدی را انتخاب میکند.
مدل+هارنس=ایجنت
تصمیم
مدل قدم بعدی را انتخاب میکند.
اجرا
ابزار، کار را انجام میدهد.
بررسی
نتیجه دیده میشود؛ ادامه یا پایان.
این یک مدل ساده برای فهم موضوع است. در عمل، کیفیت مدل، ابزارها، اطلاعات و بازخورد تو همگی روی نتیجه اثر دارند.
قابلیتها از پلاگینها میآیند.
ابزارها، مدل، ذخیرهسازی و حتی بخشهایی از رابط میتوانند قطعات قابل ترکیب باشند.
کدش در دسترس است.
با مجوز MIT میتوان کد هارنس را دید، استفاده کرد و تغییر داد. هزینهٔ API مدل موضوع جداگانهای است.
در حال تکامل
معرفی رسمی پروژه این پروژه هنوز در مرحلهٔ پیشنمایش توسعهدهندگان است. ممکن است نام گزینهها یا رفتار بخشها در نسخههای بعد تغییر کند.
از اینجا، دستبهکار میشویم
چند قدم تا
اولین اجرا.
سیستمعاملت را انتخاب کن و مراحل را بهترتیب جلو برو.
Windows · PowerShell
رابط در مرورگر باز میشود. آدرس چاپشده در ترمینال را ببین؛ معمولاً 127.0.0.1:3080 است.
برای بازماندن محیط، پنجرهٔ ترمینال را باز نگه دار. Ctrl + C برنامه را متوقف میکند.
راهنمای رسمی اجرامحیط آماده است.
مدل را وصل کن.
کلید API، راه اتصال هارنس به حساب مدل توست. برنامه روی دستگاهت اجرا میشود و درخواست مدل از طریق API فرستاده میشود.
کامپیوتر تو
سرویس مدل
- ۱
مسیر دریافت مدل را انتخاب کن.
مدل رایگان برای تمرین، پرداخت ریالی یا API رسمی دیپسیک؛ در بخش بعد انتخاب کن.
- ۲
از همان سرویس، کلید API بگیر.
کلید مثل مجوز استفاده از حساب توست. رایگان یا پولیبودن مصرف را در پنل همان سرویس بررسی کن.
- ۳
تنظیمات اتصال را وارد کن.
در Harness به Settings → Models برو. هر مسیر، آدرس و مدل خودش را دارد؛ راهنمای دقیق هر سه را پایین میبینی.
کلید API شخصی است؛ در ویدیو یا تصویر عمومی نمایش نده.
نوبت انتخاب مسیر اتصال است
مدل را از کجا بگیری؟
از بین سه مسیر، گزینهٔ مناسب خودت را انتخاب کن. تنظیمات و لینکهای همان سرویس را اینجا میبینی.
کلید API را فقط در تنظیمات Harness وارد کن. این صفحهٔ آموزشی، کلیدت را دریافت یا ذخیره نمیکند.
deepseek-demo
هر پروژه، جای خودش
یک پوشه.
یک فضای کار.
Workspace همان پوشهٔ پروژه است؛ فایلها و کارهایی که میخواهی ایجنت روی آنها کار کند.
در محیط Harness
پوشهٔ تمرین را اضافه و انتخاب کن، بعد یک جلسه شروع کن. تا Workspace انتخاب نشده باشد، کادر شروع کار فعال نیست.
deepseek-demo/
index.htmlفایل صفحه
notes.mdیادداشت پروژه
نمونهٔ ساختار یک پروژه؛ پوشهٔ تازهساختهشده هنوز خالی است.
پوشهٔ کار با مرز امنیتی فرق دارد؛ مجوزها و محدودیت دسترسی جداگانه تنظیم میشوند.
درخواستت را
قابل انجام کن.
لازم نیست پرامپت بینقص بنویسی. روشن شروع کن، نتیجه را ببین و بازخورد بده.
چه چیزی را مشخص کنیم؟
هر جزء را انتخاب کن و تغییر درخواست را ببین.
درخواست تو۱ از ۴ جزء
این صفحهٔ وب را بررسی کن.
مثال آموزشی برای یک پروژهٔ موجود
کیفیت نتیجه به درخواست، اطلاعات، مدل، ابزارها و بازخورد تو بستگی دارد.
ابزار مناسب، برای کار مناسب
یک محیط.
چند روش کار.
حالتها، ترکیب امکانات ایجنت را عوض میکنند. برای شروع این آموزش، Standard را انتخاب کن.
شروع پیشنهادی
ابزارهای عمومی برای انجام کار
خواندن و ویرایش فایل، اجرای فرمان، جستوجو و برنامهریزی، در یک ترکیب عمومی از امکانات.
برای اولین کار روی پوشهٔ پروژه، از اینجا شروع کن.
اول نقشهٔ کار را ببین.
با /plan از ایجنت میخواهی پیش از اجرا بررسی و برنامهریزی کند. Plan به ایجنت میگوید چطور کار کند؛ محدودیت دسترسی را باید جداگانه تنظیم کنی.
قابلیت اضافه کن.
روش کار را یاد بده.
این سه مفهوم، نقشهای متفاوتی در محیط ایجنت دارند.
Plugin
یک قابلیت نرمافزاری
قطعهای که بخشی از امکانات هارنس را فراهم میکند؛ مثل ابزار فایل، اتصال مدل یا ذخیرهسازی.
Skill
راهنمای انجام یک کار
دستورالعملی قابل استفادهٔ دوباره که ایجنت هنگام نیاز میخواند؛ مثل روش بررسی یک صفحهٔ وب.
MCP
اتصال ابزارهای بیرونی
راهی استاندارد برای در دسترس قرارگرفتن ابزارهای یک سرویس بیرونی.
برای دیدن اجزای محیط، برو به Settings → Plugins → Plugin list.این تب فقط فهرست افزونهها را نشان میدهد. از این فهرست، افزونهای نصب یا فعال نمیشود.
راهنمای رسمی
یادگیری با تجربه ادامه پیدا میکند
در تلگرام هم
همراهم باش.
من امیر یوسفیام. این راهنما را ساختم تا از اولین آشنایی، قدمبهقدم به اولین اجرای خودت برسی.
این صفحه را برای مرور نگه دار. برای دنبالکردن من، به کانال تلگرام سر بزن.
رفتن به کانال تلگرام@amireusefi_aiکانال امیر یوسفی
این صفحه، جزوهٔ توست
هر وقت لازم شد،
برگرد به همینجا.
لینکهای مورد نیاز
دانلود Node.js LTSنسخهٔ ویندوز یا مک را انتخاب کن.
مخزن رسمی Harnessکد، تغییرات و راهنمای شروع
پنل API دیپسیکدریافت کلید و مدیریت اعتبار
مدلها و هزینهٔ APIتعرفه و اطلاعات بهروز مدلها
مستندات کاملبرای قدمهای بعدی و قابلیتهای بیشتر
کلید API در OpenRouterدریافت کلید برای مدلهای رایگان یا پولی
AvalAI؛ مسیر پرداخت ریالیمدلها، تعرفه و شرایط اعتبار شروع
مبنای این راهنما: مستندات بررسیشده در ۷ سپتامبر ۲۰۲۶ و نسخهٔ 0.1.2-rc.1. برای تغییرات جدید، منابع رسمی را ببین.
اگر جایی گیر کردی
اولین کار را کوچک انتخاب کن.
یک پوشه انتخاب کن. یک کار کوچک و روشن بخواه.
نتیجه را باز کن و بررسی کن.