أفكار وأدوات رقمية بلغة مفهومة.
1201 مقال
وصف الأداة وربط الدالة المنفذة جانبان منفصلان في إعداد مساعد يستعمل دوال. قد يقرأ النموذج عبارة «اجمع العددين»، بينما يحتاج التطبيق إلى كود ينجز الحساب ويعيد الناتج. نحدد صاحب التنفيذ في مسار Functions الخاص بـAgents API ثم نؤلف دالة صغيرة للشرح، دون تشغيلها.
أجزاء معاملات الأداة المتدفقة قد تعرض لنا اتجاه الطلب قبل اكتماله، لكنها ليست بالضرورة كائنات مستقلة جاهزة للتنفيذ. نقرأ مسار Responses الموثق ونؤلف جزأين يكونان عددا واحدا، كي لا يتحول ظهور رقم مبكر إلى مدخل مختلف عما اكتمل لاحقا.
ربط نتيجة الأداة بمعرف الاستدعاء يمنع نسبة جواب إلى الطلب الخطأ حين تتكرر الأداة. اسم read_card وحده لا يميز محاولة قراءة بطاقة من محاولة أخرى. نستعمل عقد call_id المسمي في دليل OpenAI ونؤلف طلبين ونتيجتين مختلفتين، دون إرسال عمل خلفي أو اختبار توازي.
ناتج الأداة والإجابة النهائية قد يتشابهان على الشاشة، لكنهما ليسا المرحلة نفسها. قد تختار جهة التطبيق عرض قيمة كما عادت، أو استعمالها في طلب تال للنموذج. نميز المسارين على ورقة معلنة، حتى لا ننسب جملة محررة إلى الأداة أو نفترض أن كل ناتج مر بدور إضافي.
استجابات النموذج وتنفيذ الأدوات حدثان يمكن أن يتجاورا في سجل وكيل. إذا وصف المحرر «ثلاث خطوات»، فقد يقصد مرات استجابة النموذج أو مرات عودة الأدوات أو عناصر الورقة كلها. نضع تعريفا للعد ثم نتتبع مثالا صغيرا، دون ربط أعداده بمدة أو رسوم أو تجربة خدمة.
الفرع الثابت واختيار النموذج يمكن أن يجتمعا في تصميم واحد. قد يعالج نموذج نصا، ثم يطبق التطبيق قاعدة معلنة على رقم، فينقل العمل إلى مسار محدد. نرسم مثالا مستقلا كي نعرف صاحب قرار الانتقال، دون بناء وكيل أو تفسير كل سهم بأنه تفكير من النموذج.
إعداد اختيار الأداة في الطلب يجيب عن سؤال مختلف عن سؤال «ما الأدوات المتاحة؟». قد تبقى القائمة نفسها بينما يتغير التحكم في الاستدعاء. نقرأ أوضاعا موثقة ونضع بطاقتي إعداد مؤلفتين، دون إرسال طلب أو اعتبار إلزام الاختيار ضمانا أن الأداة مناسبة للمهمة.
خطأ الأداة وفشل دور الوكيل ليسا وصفين متطابقين في عقد Agents API الذي نقرأه. قد ترسل نتيجة للأداة تخبر الوكيل بمشكلة، وقد يسجل النظام فشل الدور نفسه. نرسم حالتين مؤلفتين كي يبقى نوع الدليل واضحا قبل القول إن الوكيل توقف أو أصلح المشكلة.
رفض المخرجات المنظمة حالة يجب تمييزها من جواب ذي حقول، لا خانة نملؤها حتى يبدو الجدول كاملا. نقرأ مسار الرفض في مثال Chat Completions الذي تعرضه OpenAI، ثم نقارن بطاقات مؤلفة لا تتضمن طلبا حساسا أو استجابة حقيقية من نموذج.
حد أدوار ذاكرة الوكيل يحتاج إلى تعريف ما يعد دورا. نقرأ تنفيذ TrimmingSession التعليمي المنشور في OpenAI Cookbook، حيث يختار max_turns أجزاء من سجل المحادثة. لا نعامل هذا الخيار كحد تشغيل لكل وكيل، ولا كعدد رسائل أو كلمات. المثال الحسابي التالي من تأليفنا.
تحميل سجل جلسة الوكيل يتعلق بما يمرره التطبيق في الطلب الجديد. قد نرى محادثة محفوظة ونفترض أن النموذج يعرفها كلها، بينما لم نحدد مسار وصولها. نقرأ استراتيجيات الاستمرار في دليل OpenAI Agents SDK، ونقارن ثلاث بطاقات إعداد مؤلفة دون تشغيل خدمة.
حذف عنصر من جلسة الوكيل عبارة تحتاج إلى تحديد العملية والسجل. نقرأ تنفيذ TrimmingSession التعليمي المنشور، ونقارن إزالة آخر عنصر بإفراغ قائمته. قد يكون آخر عنصر نتيجة أداة، وليس رسالة المستخدم أو التبادل كله. المثال التالي قائمة مؤلفة نفحصها على الورق، ولا نمسح محادثة فعلية.
تصفية تاريخ تسليم الوكيل تغير المادة التي نقدمها للمسار التالي. قد نحتفظ برسائل المستخدم ونستبعد نتيجة أداة، لكن المتخصص لا يرى هذه النتيجة لمجرد أن الوكيل السابق كان يملكها. نرسم اختيارا معلنا على قائمة مؤلفة، لا إعداد مرشح جاهز يعمل تلقائيا في كل لغة.
أداة النص الحر في الوكيل تحتاج إلى قراءة نوع المدخل، لا شكل طلب الشبكة وحده. قد يضم الطلب تعريف أداة في JSON، بينما يستقبل معالج الأداة سلسلة نصية. نقرأ المثال التعليمي الرسمي لـ OpenAI على Amazon Bedrock، ثم نؤلف ملاحظة قصيرة لشرح أثر الفاصل دون استدعاء نموذج أو محلل فعلي.
لقطة ARIA للمساعد قد تعرض أسماء أزرار وعناوين وحالات في نص منظم، فتساعد على قراءة بنية واجهة. لكنها ليست صورة الصفحة. إذا سألنا عن لون زر أو موضعه، لا نخترع بكسلات من اسم العنصر. نقرأ توثيق Playwright ونكتب تمثيلا مؤلفا للمقارنة، دون زيارة واجهة أو تشغيل اختبار.
معرف مرفق الوكيل مهم حين يقول المساعد: أعددت التقرير. قد يظهر اسم report.csv في الكلام وفي أكثر من مكان حفظ. نحتاج معرفة الملف الذي تشير إليه الرسالة، ثم مراجعة محتواه. نبني مثالا بورقتين تعريفيتين لملفين، دون إنشاء حاويات أو تشغيل أداة أو تنزيل بيانات.
صورة في ناتج الأداة قد تبدو موجودة لأن الجواب يذكر اسمها. لكن السؤال عن الصورة نفسها يحتاج مسارا يتيح محتواها، لا اسمها فقط. نقارن بطاقتي ناتج معلنتين داخل واجهة مسماة، ونترك فحص الوصول وملاءمة الصورة للمهمة مستقلا. لا نرسل صورة إلى نموذج في هذا المثال.
السياق المحلي للوكيل قد يحمل معرف بطاقة أو مساعدا برمجيا يحتاجه التطبيق. يختلف سؤال وجود المعلومة عند التطبيق عن سؤال تقديمها للنموذج. نرسم بطاقة حالة ورسالة وناتجا افتراضيا، ونقارن حدود كل منها. لا نفحص حسابا أو نعطي نموذجا سياقا فعليا في المقال.
