پرش به محتوای اصلی
پرش به محتوای مقاله

درون ساختار NanoAgent برای سازماندهی خودکار زنجیره‌های ابزاری

·۶ مهر ۱۴۰۵۳ دقیقه مطالعه۱ بازدید
راهنما
هماهنگی چند ابزار در PHP: یک عامل، ابزارهای متعدد، یک پاسخ
هماهنگی چند ابزار در PHP: یک عامل، ابزارهای متعدد، یک پاسخ
اشتراک‌گذاری
واقعاً چه چیز جدید است؟

استفاده از توصیفات ابزار برای توالی‌بندی خودکار در محیط PHP و حل مشکل تبدیل JSON برای ابزارهای بدون پارامتر، نوآوری اصلی این پیاده‌سازی است.

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

طبق گزارش منتشرشده در ۲۷ سپتامبر ۲۰۲۶، راهنمای فنی NanoAgent نشان می‌دهد که یک عامل (Agent) — شبیه به یک مدیر پروژه که ابزارهای مختلف را در اختیار دارد و می‌داند هر کدام را در چه زمانی استفاده کند — می‌تواند در محیط PHP، ترتیب اجرای ابزارها را صرفاً بر اساس توصیفات آن‌ها و هدف کاربر تعیین کند.

بسیاری از توسعه‌دهندگان در حال حاضر از زنجیره‌های صلب استفاده می‌کنند که در آن ترتیب اتفاقات از پیش تعیین شده است. این ساختار در مواجهه با کارهای باز، مثل یک دستیار شخصی که باید ابتدا مکان کاربر را بیابد و سپس آب‌وهوا یا رویدادهای محلی را چک کند، به یک گلوگاه تبدیل می‌شود. با انتقال مدیریت این فرآیند به مدل، سیستم از حالت قطعی (Deterministic) به حالت پویا تغییر می‌کند.

زمینه: مسئله ارکستراسیون (مدیریت اجرا)

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

در نمونه‌ی NanoAgent، کاربر درخواستی چندبخشی ارسال می‌کند: «ببین من کجام، آب‌وهوای اونجا رو بگیر و ببین امشب کنسرت جاز هست یا نه». این درخواست مستلزم ساخت یک خط لوله (Pipeline) در لحظه است، به‌طوری که خروجی ابزار اول، ورودی مورد نیاز برای دو ابزار بعدی باشد. به نقل از گزارش dev.to، پیاده‌سازی NanoAgent از سه شیء FunctionTool مجزا برای مدیریت این درخواست پیچیده استفاده می‌کند.

معماری مجموعه ابزارها

این سیستم از ابزارهای زیر تشکیل شده است:

  • detect_user_location: ابزاری بدون پارامتر که شهر و کشور کاربر را گزارش می‌دهد. در محیط شبیه‌سازی، این ابزار خروجی ['city' => 'Paris', 'country' => 'France'] را برمی‌گرداند.
  • get_current_weather: ابزاری که به یک رشته متنی برای «شهر» نیاز دارد تا پیش‌بینی‌های زنده را دریافت کند. این ابزار از یک آرایه مشاهده (Observation Array) استفاده می‌کند که حاوی داده‌هایی برای پاریس (ابری، ۱۴ درجه)، لندن (بارانی، ۱۱ درجه) و نیویورک (آفتابی، ۲۲ درجه) است.
  • search_local_events: ابزاری که با دریافت نام شهر، رویدادهای فرهنگی را می‌یابد. برای شهر پاریس، این ابزار نتایج خاصی مانند «جشنواره جاز در Le Caveau» در ساعت ۲۰:۰۰ و «نمایش آثار مونه در Grand Palais» از ساعت ۱۰:۰۰ تا ۱۸:۰۰ را برمی‌گرداند.

عامل این وابستگی را به‌طور ضمنی مدیریت می‌کند؛ ابتدا ابزار مکان را فراخوانی می‌کند، کلمه «پاریس» را از نتیجه استخراج کرده و سپس آن مقدار خاص را به ابزارهای آب‌وهوا و رویداد می‌فرستد.

جزئیات پیاده‌سازی فنی

از نظر فنی، برای مدیریت ابزارهایی که پارامتر ورودی ندارند در زبان PHP، توسعه‌دهنده از شیء stdClass() استفاده می‌کند. این یک جزئیات حیاتی است؛ زیرا در JSON Schema، شیئی بدون ویژگی باید به صورت {'type':'object','properties':{}} باشد. استفاده از یک آرایه خالی [] در PHP باعث تبدیل آن به یک آرایه JSON می‌شود و در نتیجه فراخوانی ابزار با شکست مواجه می‌گردد.

این سازوکار بر دو عامل کلیدی استوار است:

اول، توصیفات دقیق (Narrow Descriptions)؛ فیلد description همان چیزی است که مدل برای انتخاب ابزار می‌خواند. توصیفی دقیق مثل «تعیین شهر و کشور فعلی کاربر» به مدل سیگنال می‌دهد که این اولین قدم ضروری است. توصیفات مبهم منجر به انتخاب اشتباه ابزار می‌شوند.

دوم، شکل‌دهی به خروجی (Output Shaping)؛ پرامپت سیستمی شکل پاسخ نهایی را تعیین می‌کند، نه ترتیب فراخوانی ابزارها. با دستور «ابتدا مکان و آب‌وهوا را توصیف کن و سپس رویدادها را لیست کن»، توسعه‌دهنده ترکیب نهایی را هدایت می‌کند اما مدیریت زنجیره (Orchestration) را به مدل می‌سپارد.

برای توسعه‌دهندگان، این یک تغییر در نحوه ساخت خط لوله‌های هوش مصنوعی است. اگر یک جریان کاری (Workflow) ثابت باشد، زنجیره‌های قطعی همچنان برتر هستند. اما برای دستیارهایی که مسیر پاسخ به ورودی کاربر بستگی دارد، دادن ابزارهای متعدد به یک تک‌عامل، الگوی مقیاس‌پذیرتری است.

این رویکرد حجم کد‌های تکراری (Boilerplate) برای مدیریت منطق‌های شرطی را کاهش می‌دهد. به‌جای نوشتن دستورات پیچیده if-else برای مسیریابی داده‌ها بین توابع، توسعه‌دهنده قطعات و هدف را ارائه می‌دهد و اجازه می‌دهد مدل زبانی بزرگ (LLM) — مثل کتابخانه‌داری که میلیاردها صفحه را خوانده و حالا با همان لحن کتاب‌ها جواب می‌دهد — خط لوله را در لحظه بسازد.

برای پیاده‌سازی این مدل، توسعه‌دهندگان باید بر دقت فیلد description در تعریف ابزارهای خود تمرکز کنند، زیرا این اصلی‌ترین سیگنالی است که مدل برای سازماندهی توالی عملیات از آن استفاده می‌کند. توسعه‌دهندگان علاقه‌مند می‌توانند مجموعه مثال‌های کامل NanoAgent را برای مشاهده الگوهای ارکستراسیون پیچیده‌تر و دموهای زنده بررسی کنند.

گام بعدی شما

  • در تعریف ابزارهای خود، روی دقت فیلد description تمرکز کنید تا سیگنال‌های قوی‌تری به مدل برای توالی‌بندی ارسال کنید.
  • برای ابزارهای بدون ورودی در PHP، حتماً از stdClass() استفاده کنید تا خطای تبدیل JSON رخ ندهد.
  • مدل‌های خود را با درخواست‌های چندمرحله‌ای تست کنید تا نقاط ضعف در استخراج داده‌های میانی را شناسایی کنید.

اما داستان سخت‌افزاری این تحول حتی شگفت‌انگیزتر است — به تحلیل ما درباره‌ی تراشه‌های Blackwell مراجعه کنید.

چرا این موضوع مهم است؟

این متدولوژی با تکیه بر تخصص مدل‌های استدلالی در مدیریت ابزارها، هزینه توسعه دستیارهای پیچیده را کاهش می‌دهد. اعتبار این رویکرد در حذف وابستگی به اسکریپت‌های صلب و تبدیل عامل‌ها به موجوداتی پویاست.

تأثیر برای ایران

برنامه‌نویسان PHP در ایران می‌توانند با این متد، بدون نیاز به فریم‌ورک‌های سنگین، دستیارهای هوشمندِ ابزار-محور را روی سرورهای داخلی پیاده کنند.

·نگاه ما
تحریریه دات‌هوش

جایگزینی منطق شرطی سخت‌افزاری با استدلال مدل، ریسک توهم در توالی‌بندی را بالا می‌برد اما مقیاس‌پذیری را به‌شدت افزایش می‌دهد. این تغییر نشان می‌دهد که توسعه‌دهندگان در حال حرکت از «برنامه‌نویسی توابع» به «مدیریت توصیفات» هستند؛ جایی که کیفیت متنِ توصیفی ابزار، جایگزین دقتِ کدنویسیِ مسیر می‌شود.

منابع

این گزارش با خط‌لولهٔ خودکار دات‌هوش از منابع معتبر جهانی تدوین و زیر نظر تحریریه منتشر شده است. روش کار ما

گفتگو

پنج‌شنبه‌های هوش‌محور

بسته‌ی هفتگی دات‌هوش

۵ خبر، ۲ ابزار، ۱ پرامپت در هر شماره. به‌زودی راه‌اندازی می‌شود — هر پنج‌شنبه صبح.

خبر کلیدی
ابزار کاربردی
پرامپت حرفه‌ای
تحلیل پژوهش
به‌زودی
زاویه‌ی ایرانی
به‌زودی
تمرین این هفته
به‌زودی

راهنماهای دات‌هوش

راهنماهای کاربردیِ دات‌هوش برای کار با هوش مصنوعی — از همین‌جا شروع کنید:

دات‌هوش

راهنمای فارسی هوش مصنوعی — با نگاه به ایران

اخبار روزانه، معرفی ابزارها و مدل‌ها، و آموزشِ کار با هوش مصنوعی؛ همیشه با این پرسش که از ایران چه چیزی کار می‌کند و چه چیزی نه.