Laravel AI SDK 1.4: خطای ابزار دیگه ایجنت رو نمیکشه
خلاصهٔ کاملتر
Laravel AI SDK به نسخهٔ 1.4.0 رسیده و مهمترین تغییرش اینه که خطای یه tool (یعنی تابعی که ایجنت میتونه وسط کار صداش کنه) دیگه کل اجرا رو خراب نمیکنه. قبلاً هر exception داخل tool اجرا رو تموم میکرد و رویداد AgentFailed رو میزد. حالا SDK خطا رو میگیره و پیامش رو بهعنوان یه نتیجهٔ ناموفق به مدل میده. مثلاً اگه ابزار RefundOrder بگه سفارش دیگه قابل برگشت نیست، مدل همینو میبینه و میتونه به کاربر توضیح بده یا یه ابزار دیگه رو صدا بزنه.
خطا هنوزم از طریق report() به exception handler میرسه و ToolFailed هم fire میشه. تو حالت stream هم یه رویداد ToolResult با successful برابر false میاد. فقط خطای خود tool اینجوری مدیریت میشه؛ اگه یه event listener خطا بده، اجرا هنوزم fail میشه. پس اگه رفتار قبلی رو میخوای، کافیه تو listener مربوط به ToolFailed خطا رو دوباره throw کنی:
Event::listen(ToolFailed::class, fn (ToolFailed $event) => throw $event->exception);تغییر بعدی مربوط به تسته. قابلیت human-in-the-loop (یعنی اجرا وایمیسه تا یه آدم صدا زدن ابزار رو تأیید یا رد کنه) زیر Agent::fake() درست کار نمیکرد و ابزار تأییدشده اصلاً اجرا نمیشد. حالا fake هم مثل provider واقعی ادامه میده: ابزار تأییدشده اجرا میشه و نتیجهش ذخیره میشه، ابزار ردشده هم نتیجهٔ denied میگیره. یعنی میشه کل جریان تأیید رو از اول تا آخر تست کرد. فقط حواست باشه رد کردن بدون دلیل حالا turn رو تموم میکنه، پس تو تست یه دلیل مثل Decision::reject('Not now.') بده.
پراپرتی raw که پاسخ HTTP خود provider رو نگه میداره، قبلاً فقط روی پاسخهای متنی بود. حالا روی classification، embeddings، transcription، image و reranking هم هست؛ مثلاً میتونی مقدار usage.cost رو که OpenRouter برمیگردونه بخونی. این پراپرتی بعد از serialize شدن null میشه و تو embeddings اگه همهٔ بردارها از کش بیان هم null هست.
OpenAI برای محدودیت نرخ و مشکلات پرداخت (مثل insufficient_quota) هر دو کد 429 برمیگردونه و SDK همه رو rate limit حساب میکرد و حتی retry میکرد. حالا این خطاهای پرداخت InsufficientCreditsException میدن و retry نمیشن. خطاهای stream provider هم حالا همیشه با اسم ثابت error broadcast میشن تا فرانتاند بدونه دنبال چی گوش بده. ساخت عنوان مکالمه هم حالا رویدادهای ایجنت رو fire میکنه، پس مصرف توکنش تو گزارشها دیده میشه.
نکات کلیدی:
- خطای داخل tool دیگه AgentFailed نمیزنه و بهجاش به مدل برمیگرده
- Agent::fake() حالا ابزارهای تأییدشده رو واقعاً اجرا و نتیجه رو ذخیره میکنه
- پراپرتی raw به پنج نوع پاسخ دیگه اضافه شده
- خطاهای پرداخت OpenAI حالا InsufficientCreditsException هستن، نه RateLimitedException
- خطاهای stream با اسم ثابت error broadcast میشن
- آپدیت با composer update laravel/ai انجام میشه




