أحداث دورة الحياة
استخدمrun_with_events(...) أو continue_with_events(...) لتلقي الأحداث بشكل متزامن:
run.startedmodel.request.startedmodel.response.completedtool.startedtool.completedrun.pausedrun.resumedrun.completedrun.stopped
إعادات محاولة النموذج
max_retries المحاولات الإضافية بعد الطلب الأول. ويسجّل RunStep.model_attempts عدد المحاولات التي سبقت الحصول على استجابة ناجحة من النموذج.
الاستخدام
يجمعRunResult.usage ما يلي:
input_tokensoutput_tokenscached_tokenstotal_tokens- تتضمن
costعندما يملأها عميل النموذج
RunStep أيضًا ملخص الاستخدام الخاص بها ومعرّف الطلب والمزوّد والنموذج وسبب الإنهاء.
لا يعيّن محوّل Gateway المضمّن 0.1 قيمتي cost_nanos أو cost_cents من Gateway إلى UsageSummary.cost. راجع استجابة Gateway أو سجل التوليد عند الحاجة إلى معرفة التكلفة الدقيقة.
الأخطاء
تستخدم جميع إخفاقات وقت التشغيلAgentError:
PhaseoError من Gateway إلى AgentError. إذا احتاج التطبيق إلى حالة Gateway الأصلية ونص الاستجابة، فاستدعِ عميل phaseo مباشرةً أو نفّذ ModelClient مخصصًا يحتفظ بهذه الحقول في معالجة الأخطاء.
تُعاد أخطاء منفّذ الأدوات المحلي إلى النموذج بوصفها نتائج أدوات بدلًا من إنهاء التشغيل فورًا.
حدود الخطوات
يحدّدAgentDefinition::max_steps(...) الحد الافتراضي لأدوار النموذج. ويمكن تغييره لعملية تشغيل واحدة:
run.status هي stopped وقيمة run.stop_reason هي max_steps:<limit>.