Knaph

عامل‌های هوش مصنوعی

نقشه

پیکان‌ها از آنچه اول می‌آموزید به آنچه باز می‌کند اشاره دارند. نشانگر را روی یک مفهوم ببرید تا زنجیرهٔ آن و جایی که عمیق‌تر برمی‌گردد روشن شود. برای دیدن درس‌ها و داستان‌های یک مفهوم، روی آن راست‌کلیک کنید (یا انگشت خود را روی آن نگه دارید).

  • ثابت‌شده تا عمق123
  • باز
  • قفل
  • عمیق‌تر برمی‌گردد

مسیر یادگیری

به ترتیبی که مفاهیم بر هم بنا می‌شوند.

  1. عامل هوش مصنوعیقفلیک مدل زبانی درون برنامه‌ای که به آن ابزار و یک حلقه می‌دهد، تا بتواند در چند گام به سوی یک هدف کار کند: کاری را درخواست کند، ببیند چه شد و گام بعدی را خودش انتخاب کند، تا کار تمام شود.باز می‌شود پس از: مدل زبانی
  2. استفاده از ابزارقفلاینکه مدلی که فقط متن می‌نویسد چطور کاری انجام می‌دهد. برنامه فهرستی از ابزارها را در درخواست می‌گذارد (نام، شرح، ورودی‌ها). مدل یک فراخوانی ابزار در قالبی ثابت می‌نویسد و می‌ایستد. برنامه ابزار را اجرا می‌کند و نتیجه‌ی ابزار را برمی‌گرداند تا مدل بخواند. به آن فراخوانی تابع هم می‌گویند.باز می‌شود پس از: عامل هوش مصنوعی, پرامپت سیستمی
  3. حلقه‌ی عاملقفلچرخه‌ای که فراخوانی‌های ابزار را به یک عامل تبدیل می‌کند: درخواست را بفرست، هر ابزاری را که پاسخ خواسته اجرا کن، نتیجه‌ها را اضافه کن، و تکرار کن تا پاسخی هیچ ابزاری نخواهد. هر دور یک نوبت است و در هر نوبت همه‌چیز دوباره فرستاده می‌شود.باز می‌شود پس از: استفاده از ابزار
  4. نتیجه‌ی ابزارقفلپیامی که برنامه بعد از اجرای ابزارِ درخواستیِ مدل برمی‌گرداند. هر نتیجه یک بلوک tool_result است که شناسه‌ی همان فراخوانی‌ای را که به آن پاسخ می‌دهد دارد، خروجیِ ابزار را به صورت متن، و اگر ابزار شکست خورده باشد is_error را. همه‌ی نتیجه‌های یک نوبت با هم در یک پیامِ کاربر می‌آیند، درست بعد از پاسخِ مدل، تا مدل ببیند چه شد و تصمیم بگیرد قدمِ بعدی چیست.باز می‌شود پس از: استفاده از ابزار
  5. بررسیِ کارِ عاملقفلاینکه گزارشِ عامل را ادعایی برای بررسی بدانیم، نه اثبات: شواهدِ واقعی را بخواهیم (دستور و خروجی‌اش)، دیف را بخوانیم، خودمان اجرایش کنیم یا از یک عاملِ تازه بخواهیم بازبینی‌اش کند. و از آن بهتر، به عامل تست یا اسکریپت بدهیم تا خودش در حلقه کارش را بسنجد، بر اساسِ معیارِ تمام شدنی که از پیش روی آن توافق شده.باز می‌شود پس از: حلقه‌ی عامل, گواهی
  6. زیرعاملقفلعاملی که عامل دیگری برای یک کار فرعی راه می‌اندازد. یک شرح کار می‌گیرد، در زمینه‌ی تازه‌ی خودش و با حلقه‌ی خودش کار می‌کند، و فقط گزارش نهایی‌اش را پس می‌فرستد، تا آنچه خوانده هیچ‌وقت زمینه‌ی عامل اصلی را پر نکند.باز می‌شود پس از: مدیریت زمینه, حلقه‌ی عامل
  7. هارنس عاملقفلهمه‌چیزِ یک عامل به‌جز خودِ مدل: حلقه، ابزارها و کدی که اجرایشان می‌کند، پرامپت سیستمی، ساختنِ زمینه، اجازه‌ها، صفحه‌ای که با آن کار می‌کنید و جلسه‌های ذخیره‌شده. مدل تصمیم می‌گیرد چه کند. هارنس تصمیم می‌گیرد چه چیزی مجاز است، آن را انجام می‌دهد و به خاطر می‌سپارد.باز می‌شود پس از: حلقه‌ی عامل
  8. آزمودنِ عاملقفلبررسیِ عامل از دو راه. آزمون‌های واحد مدل را با مدلی ساختگی عوض می‌کنند که پاسخ‌های از پیش نوشته را پس می‌دهد، تا کدِ خودِ هارنس بی‌هزینه و هر بار به همان شکل آزموده شود. evalها به عاملِ واقعی کارهایی در رونوشتی تازه از یک پروژه می‌دهند، نتیجه‌ی هر کار را با یک فرمان بررسی می‌کنند، نه با گزارشِ خودِ عامل، و نرخِ قبولی و هزینه را در چند اجرا می‌سنجند.باز می‌شود پس از: بررسیِ کارِ عامل, حلقه‌ی عامل
  9. اجازه‌های عاملقفلبررسیِ برنامه‌ی دورِ مدل روی هر درخواستِ ابزار پیش از اجرای آن: اجازه دادن، پرسیدن از شما، یا رد کردن. این را یک حالتِ اجازه و قاعده‌های اجازه، پرسش و رد تعیین می‌کنند (رد برنده است). محیطِ ایزوله محدود می‌کند که یک کار، وقتی اجرا شد، به چه چیزهایی برسد.باز می‌شود پس از: هارنس عامل
  10. پروتکل زمینه‌ی مدل (MCP)قفلMCP استانداردی باز برای وصل کردنِ عامل‌ها به ابزارها و داده‌هاست. یک سرویس یک سرور MCP می‌نویسد که ابزار، منبع و پرامپت عرضه می‌کند، و هر عاملی که MCP بلد است می‌تواند از آن‌ها استفاده کند. عامل از سرور می‌پرسد چه ابزارهایی دارد و بعد آن‌ها را مثل هر ابزار دیگری صدا می‌زند.باز می‌شود پس از: استفاده از ابزار, هارنس عامل
  11. چارچوبِ عاملقفلکدِ آماده‌ای که عامل را برایتان می‌گرداند، از فقط حلقه تا کلِ هارنس. tool runner در SDK تابع‌های خودتان را به ابزار تبدیل می‌کند و حلقه را دورِ آن‌ها می‌گرداند؛ Claude Agent SDK هارنسِ Claude Code است به شکلِ یک کتابخانه، با ابزارهای فایل، اجازه‌ها، هوک‌ها و فشرده‌سازیِ آماده. کوچک‌ترین چیزی را برمی‌گزینید که کار را انجام دهد، و می‌دانید کدام تصمیم‌ها را به جای شما می‌گیرد.باز می‌شود پس از: هارنس عامل
  12. فایلِ دستورهاقفلفایلی متنی با یادداشت‌هایی درباره‌ی یک پروژه، مثل CLAUDE.md در Claude Code یا قالبِ بازِ AGENTS.md، که برنامه‌ی عامل در آغاز هر نشست می‌خواند و در زمینه می‌گذارد، تا فرمان‌ها، قراردادها و کارهای ممنوع هر بار از نو به عامل گفته شوند.باز می‌شود پس از: پرامپت سیستمی, هارنس عامل
  13. برنامه‌ریزی پیش از کارقفلاینکه عامل پیش از تغییرِ هر چیزی بگردد و برنامه‌ای بنویسد که بتوانید بررسی‌اش کنید (حالتِ برنامه‌ریزی در Claude Code)، چون درست کردنِ برداشتِ نادرست از کار پیش از آنکه گامی بر پایه‌اش برداشته شود از همه ارزان‌تر است. اگر باز هم کار خراب شد، نقطه‌های بازگشت امکانِ برگشتن را می‌دهند.باز می‌شود پس از: اجازه‌های عامل
  14. تزریق دستورقفلمتنی درون محتوایی که عامل می‌خواند - یک صفحه‌ی وب، ایمیل، فایل یا نتیجه‌ی یک ابزار - که می‌کوشد به عامل دستور بدهد. مدل دستورها و داده را به شکل یک رشته‌ی واحد از توکن‌ها می‌خواند، پس نمی‌شود آن را مطمئن کرد. دفاع‌ها کاری را که یک عاملِ فریب‌خورده می‌تواند بکند محدود می‌کنند، و مهم‌تر از همه هیچ‌وقت به یک عامل داده‌ی خصوصی، محتوای نامطمئن و راهی برای بیرون فرستادنِ داده را با هم نمی‌دهند.باز می‌شود پس از: اجازه‌های عامل, استفاده از ابزار
  15. حافظه‌ی عاملقفلیادداشت‌هایی که عامل در یک نشست در فایل‌ها می‌نویسد و در نشست‌های بعد دوباره می‌خواند، تا آنچه یاد گرفته از یک نشست به نشست بعد برسد. خودِ مدل هیچ چیز به یاد نمی‌آورد؛ یک فهرستِ حافظه‌ی کوتاه در هر نشست بارگذاری می‌شود و یادداشت‌های کامل فقط وقتی به کار مربوط باشند باز می‌شوند.باز می‌شود پس از: فایلِ دستورها, مدل بی‌حافظه
  16. مهارتِ عاملقفلپوشه‌ای که یک روش کار را به عامل یاد می‌دهد: فایلی به نام SKILL.md با یک نام، یک توصیف و دستورها، به‌اضافه‌ی هر فایلی که لازم دارد. تا وقتی کاری با آن جور نشده، فقط توصیفش در زمینه است؛ بعد دستورهای کامل خوانده می‌شوند (آشکارسازیِ گام‌به‌گام).باز می‌شود پس از: فایلِ دستورها, مدیریت زمینه
  17. هوکقفلفرمانی که برنامه‌ی دورِ عامل در لحظه‌ای معین (پیش از اجرای ابزار، پس از اجرای آن، وقتی عامل می‌خواهد کار را تمام کند) به‌طور خودکار اجرا می‌کند، هر بار، مدل هر چه در سر داشته باشد. دستورها معمولاً دنبال می‌شوند؛ هوک‌ها همیشه اجرا می‌شوند.باز می‌شود پس از: اجازه‌های عامل
  18. شرح کار برای عاملقفلسپردنِ کاری به عامل طوری که بتواند بدون حدس زدن انجامش دهد: هدف و دلیلش، زمینه‌ای که نمی‌تواند بداند، اینکه تمام شدن چه شکلی است و چطور بررسی‌اش کنیم، و خط قرمزها. اندازه‌ی کار هم باید با شیوه‌ی کارِ عامل‌ها جور باشد: برای کارهای بزرگ اول برنامه، و برای هر کار یک جلسه.باز می‌شود پس از: برنامه‌ریزی پیش از کار, پنجره‌ی زمینه, بررسیِ کارِ عامل

پیوند با حوزه‌های دیگر