ساخت ایجنت هوش مصنوعی با پایتون از صفر (کد کامل)

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

چرا بدون فریم‌ورک؟ به همان دلیلی که آموزشگاه رانندگی با دنده‌دستی شروع می‌کند: فریم‌ورک‌ها (که کم هم نیستند و بعضی‌هایشان عالی‌اند) جزئیات را از شما پنهان می‌کنند. تا وقتی ندانید زیر کاپوت چیست، نه می‌توانید عیب‌یابی کنید نه می‌توانید فریم‌ورک درست را انتخاب کنید. بعد از این درس، هر فریم‌ورکی برایتان «آشنا» خواهد بود — چون همه، همین هشتاد خط با لباس بهترند.

آنچه در این درس یاد می‌گیرید

• معماری مینیمال ایجنت: پیام‌ها، ابزارها، حلقه — و دیگر هیچ
• نوشتن دو ابزار واقعی و معرفی‌شان به مدل با قرارداد JSON
• ساخت حلقهٔ اصلی با سقف گام و دروازهٔ تأیید انسانی
• اجرای یک مأموریت واقعی و خواندن ردپای فکر ایجنت

پیش‌نیاز و نصب

پایتون ۳٫۱۰ به بالا و یک کلید API از هر ارائه‌دهنده‌ای که رابط سازگار با OpenAI دارد (تقریباً همه دارند). فقط یک کتابخانه لازم است:

pip install openai

کلید را در متغیر محیطی بگذارید — یادتان هست؟ کلید هرگز داخل کد و حافظه و پروفایل نمی‌رود:

export OPENAI_API_KEY="sk-..."

قدم اول — ابزارها: دو تابع ساده

ایجنت ما دو ابزار دارد: خواندن فهرست فایل‌های یک پوشه، و خواندن محتوای یک فایل. کوچک اما واقعی — همین دوتا برای مأموریت «پوشه‌ام را تحلیل کن» کافی است. فایل agent.py را بسازید: