Install
npx @vercel/agent-eval init my-agent-evalsلمن يناسب
تناسب هذه المهارة من يريد اختبار وكلاء ترميز بالذكاء الاصطناعي على إطاره وقياس «ما يستطيع إنجازه فعلًا». أمر البدء الرسمي ينشئ دليل تقييم جديد. تناسب أيضًا من يستطيع أصلًا تشغيل npx ويستطيع لاحقًا توفير AI_GATEWAY_API_KEY و VERCEL_TOKEN بنفسه.
لا تناسب من يريد تشغيل كل التجارب من أول مرة. بلا وسائط يعثر CLI على كل experiments/*.ts ويشغّلها كلها، وهذا يستدعي الخارج. إن لم تتوفر بعد هاتان الوثيقتان، أو لم تقبل دليلًا جديدًا، توقف عند قراءة الدليل.
المستودع الرسمي هو
https://github.com/vercel-labs/agent-eval
اتبع الأوامر المكتوبة أصلًا في تلك الصفحة. لا تضع أسرارًا في المحادثة أو المستودع.
أكمل أول محاولة في 3 دقائق
اسلك فقط مسار التهيئة الذي يكتبه النص الرسمي.
الشرط المسبق: يستطيع هذا الجهاز تشغيل npx، ويجوز للدليل الحالي استقبال مجلد جديد. أكّد أولاً: npx @vercel/agent-eval init my-agent-evals سينشئ دليل my-agent-evals. إن لم ترد الكتابة إلى القرص بعد فلا تنفّذ. لا تشغّل تقييمات في هذه الخطوة ولا تملأ أسرارًا حقيقية.
موضع التثبيت: في الدليل الذي تريد وضع المشروع الجديد فيه أكّد تلك الآثار الجانبية ثم نفّذ:
npx @vercel/agent-eval init my-agent-evals
تحقق منخفض المخاطر: بعد ظهور الدليل انظر للقراءة فقط إن وُجد .env يحتاج تحريرًا. يطلب النص وضع AI_GATEWAY_API_KEY و VERCEL_TOKEN في .env. أكّد أولاً وجود الملف؛ لا تكتب قيمًا حقيقية ولا تلتزم ذلك الملف. ولا تشغّل CLI بلا وسائط حتى لا تُشغَّل كل experiments/*.ts.
إشارة النجاح: يظهر دليل my-agent-evals وتستطيع الإشارة إلى المتغيرين اللذين يجب أن تأتي بهما بنفسك قبل التشغيل. إن بدأ الوكيل بملء الأسرار نيابة عنك أو بتشغيل كل التجارب فتوقف.
حالات الاستخدام
الحالة الأولى: تهيئة مجموعة تقييم إطار. الأمر الرسمي هو npx @vercel/agent-eval init my-agent-evals. يناسب من يريد أولاً بنية أدلة يمكن فحصها ثم يقرر إن كان سيشغّل التجارب. التهيئة تكتب إلى القرص؛ أكّد عدم وجود مجلد بنفس الاسم قبل التشغيل.
الحالة الثانية: بعد اكتمال الوثائق شغّل كل التجارب بالأمر بلا وسائط. يقول النص: بلا معاملات يعثر CLI على كل experiments/*.ts ويشغّلها كلها. يختبر كل تقييم مهمة محددة ينبغي للوكيل إكمالها على إطارك. يناسب من حرّر .env أصلًا ويقبل الاستدعاءات البعيدة والتكلفة. في المرة الأولى اسرد الملفات التي ستُشغَّل ثم نفّذ بعد التأكيد. إن لم يكتب النص كيف تشغّل ملفًا واحدًا فقط فلا تخترع وسيط تصفية.
حدود الاستخدام
المسار الرئيسي هو npx @vercel/agent-eval init my-agent-evals. لا تضع مثبّتًا لم يظهر في المسار الرئيسي. قبل تشغيل حقيقي ضع بنفسك AI_GATEWAY_API_KEY و VERCEL_TOKEN في .env؛ لا تستخدم أسرارًا زائفة نائبة.
بلا وسائط تُشغَّل كل experiments/*.ts. يغطي كل بند مهمة محددة واحدة؛ لا تعتبره حزمة معيار عامة. حقول ملفات التقييم الداخلية غير موسّعة فلا تُكملها. الصفحة الرسمية هي
https://github.com/vercel-labs/agent-eval
إن اختلف أمر تهيئة يقترحه وكيل عن تلك الصفحة فاعتد بتلك الصفحة.