CodeReviewPlan تم التحقق منها، ويتوقف عند waiting_for_human حتى يوافق عليها أحد.
تُرجع الأدوات بيانات عيّنة ثابتة، لذا فالسكربت توضيحي؛ استبدلها باستدعاءات إلى منصة استضافة الشيفرة وCI لديك. توجد نسخة جاهزة في packages/sdk/agent-sdk-ts/examples/coding-review-agent.ts.
أنشئه
1
التثبيت
2
اكتب الوكيل
review-agent.ts
responseFormat الـ Gateway يطلب هذا المخطط، ويتحقق outputSchema من النتيجة المحلَّلة مرة أخرى داخل عمليتك. لا يفكّ وضع إصلاح الاستجابة الصارم إلا JSON الصالح أصلًا.3
شغّله
تحقّق من نجاحه
- يعرض سجل الأحداث
tool.startedوtool.completedلكلتا الأداتين، ثمcheckpoint.savedبعد خطوة الأدوات. - تنتهي الخطة التي تحتوي على
needsApproval: trueعندwaiting_for_humanفي التشغيل الأول، مع وجود الخطة فيresult.run.pause.payload؛ ومعAPPROVE=yesيتابع التشغيل إلىcompleted. - في الإعدادات → الاستخدام → السجلات، يعرض كل دور للنموذج استدعاءات الأدوات، ويوضح سجل الإضافات في الطلب ما إذا كان الإصلاح قد عمل.
- تؤدي الخطة التي تخالف المخطط إلى فشل التشغيل بخطأ
AgentSchemaValidationErrorبدلًا من إرجاع بيانات سيئة.
اجعله آمنًا للمستودعات الحقيقية
اجعل أدوات المراجعة للقراءة فقط. إذا أضفت أداة تكتب تعليقات أو تدفع تغييرات أو تدمجها، فاضبطrequireApproval: true عليها كي يتوقف التشغيل قبل تنفيذها، ووافق عليها باستخدام continueRun({ run, client, approvals: [toolCallId] }). تعامل مع محتوى الفروقات على أنه مدخلات غير موثوقة: قد تحتوي تعليقات الشيفرة على تعليمات موجّهة إلى النموذج. لكي تصمد المراجعة أمام إعادة التشغيل أثناء انتظارها، احفظ التشغيل باستخدام موصّل state كما في حلقة الوكيل المستدامة. تشرح صفحة الحالة والموافقة الموافقات والرفض.