التثبيت
pydantic-ai-slim 2.0 إلى 3.0. أزال الإصدار 2.0 Agent(instrument=...) وأدخل بروتوكول الإمكانيات الذي يُبنى عليه هذا المحول، لذلك لا يمكن تجسيد 1.x بهذه الطريقة.
التجسيد
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 أو سلسلة لكل تشغيل.
التحكم في الجلسة
تم حلها بهذا الترتيب، أولى المطابقات تفوز:instrument("pydantic_ai", session_id=...)- نطاق
failproofai_sdk.session()المضمن conversation_idللتشغيل، ثمrun_idالخاص به- معرف UUID مولّد
uuid4().hex
الخيارات
المشاكل الشائعة
التشغيل يعمل ولكن لا تظهر أحداث
التشغيل يعمل ولكن لا تظهر أحداث
تم بناء
Agent قبل تشغيل instrument(). انظر التحذير أعلاه، وتحقق من agent.root_capability.capabilities.استثناء عادي في أداة يقتل التشغيل
استثناء عادي في أداة يقتل التشغيل
تنتشر
raise العارية؛ هذا هو تصميم Pydantic AI. للسماح للنموذج بالعمل حوله، ارفع ModelRetry برسالة يمكنه التصرف بناءً عليها. يتم تسجيل الفشل بأي حال.هناك امتداد وكيل متداخل لم أنشئه
هناك امتداد وكيل متداخل لم أنشئه
هذا الطفل هو امتداد التشغيل الخاص بـ Pydantic AI، وهذا هو المكان الذي يتعلق به أحداث النموذج والأداة. أسقط نطاقك الخاص إذا كنت تريد امتداداً واحداً، على حساب الاسم المخصص.
Tracebacks تبدأ برمز اختزال
Tracebacks تبدأ برمز اختزال
رسم بياني غير المتزامن من Pydantic AI أطول من حد حقل الحمولة، والسطر الأخير من التتبع هو الاستثناء نفسه. يتم قص هذا الحقل من الأمام وليس من الخلف، لذا يبقى السطر الذي تحتاجه.
التالي
كيف يعمل
الأزواج والمعرفات ودورة حياة الجلسة والتسليم.
قراءة تتبع
اتبع السببية من خلال الجلسة التي التقطتها للتو.
أطر عمل أخرى
LangGraph و CrewAI و LlamaIndex والوكلاء المخصصين.

