من تفسير الطلب إلى الفعل المصرح به
بنية وكيل الذكاء الاصطناعي
تصميم عملي يفصل الهوية والأدلة والحالة الدائمة والأوامر المحددة، مع مثال متكامل لمساعد الضمان.
بنية وكيل الذكاء الاصطناعي هي تنظيم البرمجيات والبيانات والهوية وضوابط القرار المحيطة بالنموذج. وأهم حدودها الموضع الذي يتحول فيه التفسير إلى فعل مصرح به. قد يقترح النموذج الخطوة التالية، لكن التطبيق يظل مسؤولاً عن التحقق من صاحب الطلب، وصحة الأدلة، والسماح بالفعل، وإتمامه فعلياً.
بالنسبة إلى معماريي الأنظمة وقادة الهندسة، تفسر البنية المفيدة مسار النجاح ومسار الغموض معاً. يعرض هذا الدليل تصميماً افتراضياً لمساعد ضمان يجمع أدلة المنتج والصيانة، ويشرح شروط الضمان المنطبقة، ويجهّز طلب خدمة. لا يختلق التغطية ولا يعتمد استثناءً ولا يغيّر استحقاق العميل دون تصريح.
ابدأ بالمسؤوليات ثم اختر المكونات
صف المسؤوليات قبل شعارات الموردين: نقطة الدخول، وحدود الهوية، ومتحكم المهمة، وخدمات الأدلة، والأدوات المسموحة، والحالة الدائمة، وواجهة المراجعة، وإشارات التشغيل. قد ينفذ تطبيق واحد عدة مسؤوليات في البداية، لكن فصلها مفاهيمياً يوضح الأخطاء وملكية العمل.
اكتب ما يجب أن يبقى صحيحاً مهما كان مخرج النموذج. في مثال الضمان، لا يصل العميل إلا إلى سجلاته المسموحة، وترتبط الشروط بالمنتج وسياق الشراء الصحيحين، ولا يعني إنشاء طلب الخدمة تأكيد التغطية. مكان هذه الثوابت ضوابط التطبيق واختبارات القبول.
لا تبدأ بعدة وكلاء أو قاعدة متجهات أو ذاكرة طويلة المدى لمجرد شيوعها في التصاميم. قد يجيب سجل منتجات منظم عن الاستعلام مباشرة. يمكن للنموذج تفسير وصف العميل، بينما تنفذ الشفرة البحث الدقيق بالمعرّف ومقارنة التواريخ. تساعد مقارنة الأتمتة على تحديد موضع الحاجة إلى اختيار النموذج.
أبقِ الهوية خارج تأثير المحادثة
تتحقق طبقة الدخول من المتصل وتحدد الجهة ودور المستخدم والحالة المسموحة. يأتي هذا السياق من شفرة موثوقة، ولا يُستنتج من رسالة يدّعي صاحبها أنه مسؤول نظام. وعلى كل خدمة أدلة ونقطة تنفيذ فرض حدود وصولها.
تتلقى أداة مثل get_product_record معرّف منتج أو حالة متحققاً منه ضمن صلاحية المتصل، ولا تقبل معرّف جهة عشوائياً يختاره النموذج. وإذا احتاج الاتصال إلى حساب خدمة، يظل التطبيق مسؤولاً عن فرض صلاحية المستخدم المفوضة بدلاً من كشف صلاحيات الحساب كاملة.
افصل السلطة عن المحتوى. قد يحتوي ملف PDF على حقائق ضمان، لكن نصه لا يمنح صلاحية استبدال منتج. وقد تفيد ملاحظة داخلية في المراجعة دون أن تصبح سياسة معتمدة لمجرد ظهورها في البحث. يشرح دليل البنية الأمنية حدود الثقة بمزيد من التفصيل.
أنشئ مسار أدلة واضح المصدر
ينبغي أن يعيد الاسترجاع دليلاً قابلاً للاستخدام، لا كتلة نص مجهولة. أدرج معرّف المصدر المستقر، وإصداره أو وقت تحديثه، والمقتطف المناسب، وسياق الوصول عند الحاجة. ويجب أن يميّز منشئ الرد شروط الضمان المعتمدة عن رواية العميل لما حدث.
استخدم البحث الدقيق للأسئلة الدقيقة. يجب حل الرقم التسلسلي عبر نظام يحفظ هويته؛ فالتشابه الدلالي وحده أساس ضعيف لاعتبار سجلين منتجاً واحداً. قد يساعد البحث في العثور على الشرح، لكن التطبيق يحافظ على صلته بشروط المنتج الصحيح.
ضع قواعد حداثة لكل مصدر. قد تحتاج ملكية المنتج إلى استعلام آني، بينما تحتاج وثيقة الضمان التاريخية إلى الإصدار الساري عند الشراء. الأحدث ليس دائماً الصحيح. وعند تعارض الأدلة، أظهر التعارض ومسار مراجعته بدلاً من دمج حقائق متناقضة في جواب متماسك ظاهرياً.
امنح متحكم المهمة حالة محددة
يتتبع المتحكم الهدف وما حدث بالفعل. وقد تتضمن الحالة معرّف الطلب، والمنتج المتحقق منه، ومراجع الأدلة، والأسئلة المفتوحة، والنتيجة المقترحة، وسجل الموافقة، وحالة الأمر. افصل مراجع الأدلة الأصلية عن الصياغة المعروضة للمستخدم.
افصل المحادثة العابرة عن حالة العمل الدائمة. يجب ألا يؤدي إغلاق المتصفح والعودة لاحقاً إلى فقد موافقة معلقة أو تكرار طلب. وفي المقابل، لا تتحول ملاحظة عابرة تلقائياً إلى حقيقة دائمة عن العميل. يناقش دليل بنية الذاكرة الاحتفاظ والتصحيح وإعادة الاستخدام بين التفاعلات.
توفّر الأطر أدوات لهذا الفصل. توثّق LangGraph حفظ حالة المحادثة في نقاط تحقق وبيانات التطبيق في مخازن. لكنها مكونات أساسية؛ ويظل تعريف الملكية والاحتفاظ ومعنى السجل مسؤولية التطبيق. انظر توثيق الاستمرارية في LangGraph.
افصل اقتراح الأمر عن تنفيذه
استخدم أمراً محدوداً مثل «إنشاء طلب خدمة لهذه الحالة المتحقق منها»، بدلاً من أداة عامة للكتابة في قاعدة البيانات. تحقّق من الحقول والصلاحية وحالة الطلب والموافقة قبل التنفيذ. أعد إيصالاً صريحاً أو نتيجة معلقة صريحة؛ فقول النموذج إن الطلب أُنشئ ليس إيصالاً.
يفصل نمط CQRS لدى Microsoft أوامر تغيير البيانات عن استعلامات قراءتها. ويمكن الاستفادة من فصل المسؤوليات في تطبيق الوكيل دون اعتماد بنية CQRS موزعة كاملة تلقائياً. انظر إرشادات Azure المعمارية.
في المثال، استرجاع الأدلة استعلام، وحفظ المسودة كتابة محدودة، وإنشاء طلب الخدمة أمر. أما اعتماد استبدال استثنائي فأمر آخر بصلاحية مختلفة. لا تخفِ هذه الفروق داخل أداة مرنة واحدة باسم «إدارة الضمان».
| المكوّن | العقد | التعامل مع الفشل |
|---|---|---|
| البحث عن المنتج | إعادة السجل المسموح وإصداره | طلب إيضاح إذا لم تُحسم الهوية |
| استرجاع الشروط | إعادة الشروط المنطبقة ومصدرها وسياق سريانها | تصعيد الأدلة المتعارضة أو الناقصة |
| مهمة النموذج | شرح الأدلة واقتراح الخطوة المسموحة التالية | إبقاء الأهلية غير المثبتة مجهولة |
| واجهة المراجعة | ربط الموافقة بالمقترح والأدلة المحددة | إبطالها عند تغير المدخلات الجوهرية |
| أمر إنشاء الطلب | التحقق من الصلاحية وإعادة إيصال دائم | حسم النتيجة الغامضة قبل إعادة المحاولة |
صمّم مسار الغموض قبل إعلان اكتمال البنية
لنفترض انتهاء مهلة نقطة إنشاء الطلب بعد استلام الأمر. لا يعرف الوكيل من انتهاء المهلة وحده هل أُنشئ الطلب. وقد تكرره إعادة المحاولة العمياء. يحتاج التطبيق إلى معرّف عملية، أو استعلام حالة، أو طريقة موثقة أخرى لحسم النتيجة يدعمها النظام المستقبل.
إذا لم يوفر النظام حماية موثوقة من التكرار، فيجب أن تعكس البنية هذا القيد. قد يلزم مراجع يفحص الوجهة قبل المحاولة التالية. ولا تنشئ تعليمة «تجنب التكرار» ضماناً للمعاملات تفتقده واجهة البرمجة.
حدّد أيضاً الإلغاء وانتهاء الصلاحية. قد يسحب العميل طلبه أثناء المراجعة، أو يختفي موعد خدمة كان متاحاً. أعد التحقق من الشروط الجوهرية مباشرة قبل الفعل المؤثر، وطابق الحالة المعروضة مع الحالة الدائمة. يناقش دليل تنسيق التنفيذ إعادة المحاولة والاستئناف.
عامل النموذج كمكوّن قرار قابل للاستبدال
عرّف عقد المدخلات والمخرجات بصورة مستقلة عن أسلوب نموذج واحد. تحتاج المقترحات المنظمة إلى حقول متحقق منها وقيم صريحة للمجهول، مع الحفاظ على مراجع الأدلة خلال التحويلات. بذلك يُقيّم النموذج بحسب المهمة ولا يتشابك اختياره مع كل تكامل.
احفظ إصدارات التعليمات ووصف الأدوات وإعدادات الاسترجاع ومخططات المخرجات مع سجل الإصدار المنشور. قد يغيّر تبديل النموذج الأداة المختارة أو طلب الإيضاح رغم ثبات الواجهة. يجب تقييم السلوك الكامل، بما يشمل استدعاءات الأدوات والحالة الناتجة، وليس الفقرة النهائية فقط.
يحتاج البديل عند الفشل إلى الانضباط نفسه. قد تختلف قدرات النموذج البديل وترتيبات معالجة بياناته. وقد لا يصلح جواب عام عند تعطل مصادر الأدلة لقرار ضمان. يمكن لحالة عدم توافر واضحة أن تحافظ على الثقة أكثر من إجابة محتملة بلا سند.
تتبّع القرارات دون نسخ كل مستند
سجّل معرّف التشغيل والإصدارات ومراجع المصادر ونتائج الأدوات وانتقالات الموافقة والحالة النهائية. اجعل الاطلاع على المحتوى عند التحقيق مقيداً. فقد يتحول تسجيل التعليمات والمستندات كاملة دون ضوابط إلى مخزن إضافي لبيانات العملاء لم يصممه أحد أو يديره.
ميّز بين الفشل التقني وعدم اكتمال المهمة. قد يكون طلب الرقم التسلسلي الناقص سلوكاً صحيحاً، بينما يفشل تشغيلياً رد منمق يفقد إيصال طلب الخدمة. يجب أن تسمح البنية بفحص الحالتين؛ ويشرح دليل الاختبار الأدلة المناسبة.
راجع البنية بتتبّع حالات كاملة
مرّر حالة عادية، وأخرى بأدلة متعارضة، وحالة رفض صلاحية، وأمراً انقطع تنفيذه عبر جميع المكونات. اسأل في كل انتقال: ما الموثوق؟ وما المحفوظ؟ ومن يملك الفعل؟ وماذا يرى المستخدم؟ وكيف يتعافى النظام؟ تكشف الإجابات الناقصة العمل المطلوب أفضل من إضافة مربع جديد إلى الرسم.
ينبغي أن تضم الوثيقة هذه المسارات وعقود المكونات وملكية المصادر وحدود الوصول والإصدارات والقيود التشغيلية. وحدّد القدرات المقترحة والمثبتة في البيئة المقصودة والمؤجلة. يجعل ذلك التصميم قابلاً للمراجعة دون تقديم الرسم كضمان إنتاجي.
حدّد ما تثبته المراجعة فعلياً
يثبت تتبع التصميم اتساقه، لا صحة تنفيذه. اطلب أدلة مستقلة على تطبيق الصلاحيات في الخدمات المستقبلة، واسترجاع الإيصال بعد انتهاء المهلة، والتوقف عن استخدام المصدر المسحوب. أدرج ذلك في قبول التسليم حتى لا يُفهم التصميم الجذاب كتقييم ضوابط مكتمل، ولتتضح أعمال التحقق المطلوبة من المهندسين.
يمكن لـOpen for AI تحديد نطاق تطوير وكلاء الذكاء الاصطناعي وفق حدود العمل المطلوبة. ولـمناقشة بنية وكيل لأنظمتك، جهّز مسار عمل محجوبة بياناته الحساسة، ومصادره المعتمدة، ومثالاً لأكثر الأفعال المسموحة تأثيراً. تحدد هذه المدخلات التصميم أفضل من تفضيل إطار برمجي وحده.