Skip to main content

التثبيت

مدعوم: pydantic-ai-slim 2.0 إلى 3.0. أزال الإصدار 2.0 Agent(instrument=...) وأدخل بروتوكول الإمكانيات الذي يُبنى عليه هذا المحول، لذلك لا يمكن تجسيد 1.x بهذه الطريقة.

التجسيد

يجب أن يتم تشغيل instrument() قبل بناء Agent. تُضاف الإمكانية عند البناء، لذا فإن وكيل مبني مسبقاً لا يحمل أي إمكانية ولا يسجل شيئاً، بدون خطأ لأنه لم يحدث شيء خاطئ. هذا هو السبب الأكثر شيوعاً للحصول على تتبع فارغ مع هذا المحول.
الوكلاء في نطاق الوحدة هم حيث يحدث المشكلة:
تأكد من أنه نجح:
يدمج Pydantic AI القائمة التي تمررها في root_capability واحد، لذا لا توجد خاصية agent.capabilities للقراءة. الوكلاء المبنيون أثناء التجسيد يحافظون على الإمكانية، لذا يمكنك uninstrument() وإعادة التجسيد دون إعادة بناء.

ما يتم تسجيله

لا توجد زوج خطاف ولا زوج موارد بشرية هنا. Pydantic AI لا يحتوي على حد عقدة أو خطوة ليتم وضع قوس حوله ولا توقف بشري مدمج، لذا لا يوجد شيء للتعيين. إذا بنيت أياً منهما، أطلق الأحداث بنفسك — انظر Custom agents. output_type لا يختلف عن التتبع. تشغيل مكتوب وتشغيل سلسلة ينتجان نفس الأحداث.

مثال

في التتبع، تظهر restock_eta كـ tool_result تحمل خطأ، متبوعة باستدعاء نموذج آخر حيث يعمل الوكيل حوله، والتشغيل ينتهي بـ success. يتم الاحتفاظ بالحقائق.

الأخطاء والمحاولات المتكررة والتحكم في التدفق

يرفع Pydantic AI استثناءات لثلاثة أشياء مختلفة، والمحول يفصل بينها: ModelRetry في المجموعة الأولى عن قصد. يعني أن محاولة فشلت بحقيقة وطُلب من النموذج المحاولة مجدداً، وهذا هو المقصود من حقل خطأ نطاق الأداة. تصنيفها كتحكم في التدفق سيخفي أخطاء الأداة الحقيقية خلف تشغيل أخضر.

سمّ امتدادات الأحداث الخاصة بك

امتداد التشغيل الخاص بـ Pydantic AI نفسه باسم agent. قم بالتفاف الاستدعاء لإعطاؤه تسمية اخترتها:
امتداد الإطار ثم يتداخل تحت inventory، وهذا هو المكان الذي يتعلق به أحداث النموذج والأداة. احتفظ بـ agent_id بتنوع منخفض. إنه الجانب الأساسي على كل سطح لوحة معلومات، لذا استخدم اسم دور، لا تستخدم UUID أو سلسلة لكل تشغيل.

التحكم في الجلسة

تم حلها بهذا الترتيب، أولى المطابقات تفوز:
  1. instrument("pydantic_ai", session_id=...)
  2. نطاق failproofai_sdk.session() المضمن
  3. conversation_id للتشغيل، ثم run_id الخاص به
  4. معرف UUID مولّد uuid4().hex

الخيارات

المشاكل الشائعة

تم بناء Agent قبل تشغيل instrument(). انظر التحذير أعلاه، وتحقق من agent.root_capability.capabilities.
تنتشر raise العارية؛ هذا هو تصميم Pydantic AI. للسماح للنموذج بالعمل حوله، ارفع ModelRetry برسالة يمكنه التصرف بناءً عليها. يتم تسجيل الفشل بأي حال.
هذا الطفل هو امتداد التشغيل الخاص بـ Pydantic AI، وهذا هو المكان الذي يتعلق به أحداث النموذج والأداة. أسقط نطاقك الخاص إذا كنت تريد امتداداً واحداً، على حساب الاسم المخصص.
رسم بياني غير المتزامن من Pydantic AI أطول من حد حقل الحمولة، والسطر الأخير من التتبع هو الاستثناء نفسه. يتم قص هذا الحقل من الأمام وليس من الخلف، لذا يبقى السطر الذي تحتاجه.

التالي

كيف يعمل

الأزواج والمعرفات ودورة حياة الجلسة والتسليم.

قراءة تتبع

اتبع السببية من خلال الجلسة التي التقطتها للتو.

أطر عمل أخرى

LangGraph و CrewAI و LlamaIndex والوكلاء المخصصين.