الانتقال إلى المحتوى الرئيسي

تقييم Patronus AI

نظرة عامة

يوفر Patronus AI إمكانيات تقييم ومراقبة شاملة لوكلاء CrewAI، مما يمكّنك من تقييم مخرجات النماذج وسلوكيات الوكلاء والأداء العام للنظام. يتيح لك هذا التكامل تنفيذ سير عمل تقييم مستمر يساعد في الحفاظ على الجودة والموثوقية في بيئات الإنتاج.

الميزات الرئيسية

  • التقييم الآلي: تقييم فوري لمخرجات وسلوكيات الوكلاء
  • معايير مخصصة: حدد معايير تقييم محددة مصممة لحالات الاستخدام الخاصة بك
  • مراقبة الأداء: تتبع مقاييس أداء الوكلاء بمرور الوقت
  • ضمان الجودة: ضمان جودة مخرجات متسقة عبر سيناريوهات مختلفة
  • السلامة والامتثال: مراقبة المشكلات المحتملة وانتهاكات السياسات

أدوات التقييم

يوفر Patronus ثلاث أدوات تقييم رئيسية لحالات استخدام مختلفة:
  1. PatronusEvalTool: يسمح للوكلاء باختيار المقيّم والمعايير الأنسب لمهمة التقييم.
  2. PatronusPredefinedCriteriaEvalTool: يستخدم مقيّماً ومعايير محددة مسبقاً من قبل المستخدم.
  3. PatronusLocalEvaluatorTool: يستخدم دوال تقييم مخصصة محددة من قبل المستخدم.

التثبيت

لاستخدام هذه الأدوات، تحتاج إلى تثبيت حزمة Patronus:
ستحتاج أيضاً إلى إعداد مفتاح API الخاص بـ Patronus كمتغير بيئة:

خطوات البدء

لاستخدام أدوات تقييم Patronus بفعالية، اتبع الخطوات التالية:
  1. تثبيت Patronus: ثبّت حزمة Patronus باستخدام الأمر أعلاه.
  2. إعداد مفتاح API: عيّن مفتاح API الخاص بـ Patronus كمتغير بيئة.
  3. اختيار الأداة المناسبة: حدد أداة تقييم Patronus المناسبة بناءً على احتياجاتك.
  4. إعداد الأداة: هيئ الأداة بالمعاملات اللازمة.

أمثلة

استخدام PatronusEvalTool

يوضح المثال التالي كيفية استخدام PatronusEvalTool، التي تسمح للوكلاء باختيار المقيّم والمعايير الأنسب:
Code

استخدام PatronusPredefinedCriteriaEvalTool

يوضح المثال التالي كيفية استخدام PatronusPredefinedCriteriaEvalTool، التي تستخدم مقيّماً ومعايير محددة مسبقاً:
Code

استخدام PatronusLocalEvaluatorTool

يوضح المثال التالي كيفية استخدام PatronusLocalEvaluatorTool، التي تستخدم دوال تقييم مخصصة:
Code

المعاملات

PatronusEvalTool

لا تتطلب PatronusEvalTool أي معاملات أثناء التهيئة. تقوم تلقائياً بجلب المقيّمين والمعايير المتاحة من API الخاص بـ Patronus.

PatronusPredefinedCriteriaEvalTool

تقبل PatronusPredefinedCriteriaEvalTool المعاملات التالية أثناء التهيئة:
  • evaluators: مطلوب. قائمة من القواميس تحتوي على المقيّم والمعايير المراد استخدامها. مثال: [{"evaluator": "judge", "criteria": "contains-code"}].

PatronusLocalEvaluatorTool

تقبل PatronusLocalEvaluatorTool المعاملات التالية أثناء التهيئة:
  • patronus_client: مطلوب. مثيل عميل Patronus.
  • evaluator: اختياري. اسم المقيّم المحلي المسجل للاستخدام. القيمة الافتراضية هي سلسلة نصية فارغة.
  • evaluated_model_gold_answer: اختياري. الإجابة المرجعية للاستخدام في التقييم. القيمة الافتراضية هي سلسلة نصية فارغة.

الاستخدام

عند استخدام أدوات تقييم Patronus، تقدم مدخلات النموذج ومخرجاته وسياقه، وتعيد الأداة نتائج التقييم من API الخاص بـ Patronus. بالنسبة لـ PatronusEvalTool وPatronusPredefinedCriteriaEvalTool، المعاملات التالية مطلوبة عند استدعاء الأداة:
  • evaluated_model_input: وصف مهمة الوكيل بنص بسيط.
  • evaluated_model_output: مخرجات الوكيل للمهمة.
  • evaluated_model_retrieved_context: سياق الوكيل.
بالنسبة لـ PatronusLocalEvaluatorTool، نفس المعاملات مطلوبة، لكن المقيّم والإجابة المرجعية يتم تحديدهما أثناء التهيئة.

الخلاصة

توفر أدوات تقييم Patronus طريقة قوية لتقييم وتسجيل درجات مدخلات ومخرجات النماذج باستخدام منصة Patronus AI. من خلال تمكين الوكلاء من تقييم مخرجاتهم أو مخرجات وكلاء آخرين، يمكن لهذه الأدوات المساعدة في تحسين جودة وموثوقية سير عمل CrewAI.