سرفصل‌ها درس 173 از 250 · عامل‌های سازنده (استفاده از ابزار و واکنش مجدد)
عامل‌های سازنده (استفاده از ابزار و واکنش مجدد)

هدف -> استخراج ابزار و آرگومان

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

شما خواهید ساخت route(query) که یک درخواست متن آزاد را به یک ساختار‌یافته نگاشت می‌کند {"tool": ..., "args": {...}} تصمیم. سه ابزار واقعی به‌علاوه یک ابزار همه‌منظوره:

  • محاسبه‌ای - درخواستی مانند "12 * 3" شامل دو عدد در اطراف یک عملگر است. آن را به {"a": 12, "op": "*", "b": 3}.
  • weather - کلمه weather ظاهر می‌شود. شهر را از آن استخراج کنید "... in <City>" به {"city": "Paris"}.
  • dictionary - عبارت‌هایی مانند define X یا meaning of X. واژه را ازبه {"term": "photosynthesis"}.
  • fallback - هیچ تطابقی یافت نشد، بنابراین مسیر را به پیش‌فرض امن با متن اصلی در {"query": ...}.

بیان‌های منظم (Regular expressions) کار اصلی را انجام می‌دهند. الگوی ماشین‌حساب یک عدد، یک عملگر و یک عدد دیگر را در بر می‌گیرد:

import re
m = re.search(r"(-?\d+(?:\.\d+)?)\s*([+\-*/])\s*(-?\d+(?:\.\d+)?)", text)
if m:
    a, op, b = m.group(1), m.group(2), m.group(3)
    # turn "12" into 12 (an int) so the calculator gets real numbers

برای شهر، به دنبال کلمه بگردید in که با کلمات بزرگ دنبال می‌شود؛ برای عبارت، پس از define / meaning of / definition of. ترتیب اهمیت دارد: ابتدا الگوی ماشین‌حساب را بررسی کنید، سپس آب‌وهوا، سپس فرهنگ لغت، و اگر هیچ‌کدام مطابقت نداشتند، به گزینهٔ پشتیبان (fallback) بروید.

اعداد را ساده نگه دارید int وقتی که عددها صحیح هستند (پس 12، نه 12.0) - تست‌ها واژه‌نامهٔ دقیق را بررسی می‌کنند. در یک عامل کامل، این تصمیم مسیریابی مستقیماً از ماژول structured-tools به دیسپچر ارسال می‌شود. برای مسیریابی چهار درخواست مختلف، دکمهٔ Run را فشار دهید.

نوبت شما

نوشتن route(query) که بازمی‌گرداند {"tool": ..., "args": {...}}. به ترتیب تشخیص دهید: یک درخواست ماشین‌حساب ("12 * 3" -> {"a": 12, "op": "*", "b": 3}، اعداد صحیح به‌عنوان int)، یک درخواست آب‌وهوا (شهر را پس از in)، یک درخواست فرهنگ لغت (اصطلاح را پس از define/meaning of)، و یک fallback برای هر چیز دیگر با متن اصلی در {"query": ...}.

مشکلی در این درس دیدید؟ گزارشش کنید · دربارهٔ این درس بپرسید

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

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