الانتقال إلى المحتوى الرئيسي
أنشئ وكيلًا بلغة TypeScript يفحص طلب سحب باستخدام أدوات محلية، ويُرجع خطة مراجعة بصيغة JSON صارمة، ويتوقف بانتظار شخص عندما تقول الخطة إنها تحتاج إلى موافقة. في النهاية يكون لديك سكربت واحد يطبع 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 كما في حلقة الوكيل المستدامة. تشرح صفحة الحالة والموافقة الموافقات والرفض.
آخر تعديل في ٥ نوفمبر ٢٠٢٦