بتل کد Battle Codeدارد باز می‌شود…

جلسه‌ی 70: پروژه: دستیار درس Project: Study Assistant

یک دستیار درس با دو ابزار می‌سازیم: ماشین‌حساب امن (بدون eval) و جست‌وجو در جزوه‌ی درس. مدل شبیه‌سازی‌شده ابزار را انتخاب می‌کند، کد ما اجرا می‌کند، و یک نگهبان جلوی جواب ساختگی را می‌گیرد.

در این جلسه یاد می‌گیری

درس

پروژه‌ی امروز: دستیار درس. دانش‌آموز می‌پرسد «۱۵ ضرب در ۴ چند می‌شود؟» یا «درباره‌ی فتوسنتز بگو». دستیار دو ابزار دارد: calc برای حساب دقیق و lookup برای خواندن جزوه‌ی خود کلاس (نه حدس مدل). مدل انتخاب می‌کند کدام ابزار، کد ما اجرا می‌کند. شش قدم داریم؛ هر قدم روی قدم قبلی ساخته می‌شود.

ابزار جست‌وجو: جزوه یک دیکشنری است: موضوع → متن. کاربر ممکن است بنویسد Photosynthesis یا gravity ؛ پس قبل از جست‌وجو متن را یکسان کن: strip() و lower(). اگر موضوع نبود، صادقانه بگو not found؛ هرگز چیزی نساز.

ماشین‌حساب امن: وسوسه می‌شوی بنویسی eval("15 * 4"). نکن! eval هر کد پایتونی را اجرا می‌کند، و آرگومان را مدل نوشته (که ممکن است خودش از یک متن آلوده خوانده باشد). به جایش متن را به سه تکه بشکن: عدد، عملگر، عدد؛ و عملگر را از یک دیکشنری مجاز بردار.

OPS = {"+": lambda a, b: a + b, "-": lambda a, b: a - b,
       "*": lambda a, b: a * b, "/": lambda a, b: a / b}

def calc(expr):
    a, op, b = expr.split()
    return OPS[op](float(a), float(b))

print(calc("15 * 4"))    # 60.0

lambda a, b: a + b یک تابع کوچک بی‌اسم است، درست مثل def add(a, b): return a + b. دیکشنری OPS یک فهرست مجاز است: هر چیزی جز این چهار عملگر رد می‌شود. همین ایده را در جلسه‌ی ۶۹ با TOOLS دیدی.

شکستن ممنوع: ماشین‌حساب باید برای هر ورودی جواب بدهد، نه این‌که برنامه را بشکند. "5 / 0"، "two + 2" یا "rm -rf" باید پیام خطای روشن بدهند. خطا را به عنوان نتیجه‌ی ابزار به مدل برمی‌گردانیم تا مدل بتواند به کاربر توضیح بدهد.

⚠️ توهم بعد از ابزار: حتی وقتی ابزار می‌گوید not found، مدل ممکن است با اعتمادبه‌نفس یک جواب بسازد. در قدم آخر یک نگهبان می‌گذاری: اگر نتیجه‌ی ابزار not found بود، جواب مدل دور ریخته می‌شود و دستیار صادقانه می‌گوید جزوه‌ای ندارد. ⚠️ و یادت باشد: دستیار درس برای فهمیدن است؛ ماشین‌حساب برای چک کردن جوابِ خودت، نه به جای فکر کردن. اسم و نمره‌ی کسی را هم در جزوه نگذار.

🏁 اگر زود تمام کردی: ابزار سوم define(word) با یک دیکشنری کوچک لغت اضافه کن، و به fake_model یاد بده وقتی سؤال با define شروع شد آن را انتخاب کند. در خانه می‌توانی همین ابزارها را با tools واقعی به DeepSeek بدهی.

مثال‌های این جلسه

چالش‌ها

  1. Step 1: Look Up the Notes (آسان)
  2. Step 2: A Calculator Without eval (آسان)
  3. Step 3: A Calculator That Never Crashes (متوسط)
  4. Step 4: Connect the Tools (متوسط)
  5. Step 5: The Full Assistant (سخت)
  6. Step 6: The Honesty Guard and the Log (سخت)

بیشتر بخوان

← جلسه‌ی 69: ابزار دادن به مدل جلسه‌ی 71: RAG کوچک (۱): تکه‌ی درست را پیدا کن →