كيفية بناء وكيل ذكاء اصطناعي عملي خطوة بخطوة

ما هو وكيل الذكاء الاصطناعي فعلياً

وكيل الذكاء الاصطناعي هو نموذج يعمل داخل حلقة عمل (work loop). يتلقى هدفاً، ويقرر الإجراء التالي، ويستخدم أداة مسموحاً بها عند الحاجة، ويقرأ النتيجة، ثم يستمر أو يتوقف.

فكر في الأمر وكأنك توظف مشغلاً مبتدئاً. التعليمات هي الوصف الوظيفي. يزودك النموذج بالتقدير واتخاذ القرار. الأدوات هي بطاقات وصول المشغل إلى نظام الطلبات، أو التقويم، أو قاعدة المعرفة، أو المتصفح، أو مخزن الملفات الخاص بك. الذاكرة هي دفتر الملاحظات. وحواجز الحماية والموافقات هي المشرف الإداري.

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

تصف نظرة OpenAI العامة الحالية على الوكلاء الوكلاء بأنهم تطبيقات تخطط، وتستدعي الأدوات، وتحتفظ بالحالة، وأحياناً تتعاون عبر متخصصين متعددين. داخل حزمة الـ SDK، لا يزال الكائن الأساسي صغيراً ومحدداً عن عمد: نموذج يتضمن تعليمات، وأدوات، وضوابط اختيارية مثل حواجز الحماية والتسليم إلى البشر (handoffs).

حزمة Agents SDK أم Responses API؟

استخدم Agents SDK عندما تريد من بيئة التشغيل إدارة استدعاءات الأدوات المتكررة، والحالة، وحواجز الحماية، وعمليات التسليم، والموافقات. واستخدم Responses API مباشرة عندما تريد كتابة تلك الحلقة والتحكم فيها بنفسك. توصي OpenAI بمسار Responses للتحكم المباشر في النموذج، وحزمة SDK لمهام سير العمل التفاعلية أو المعاملات المحدودة ذات التنسيق المتكرر.

إذا كنت تفضل أدوات البناء دون برمجة (no-code)، فإن البنية الهيكلية تظل متطابقة. تأكد من أن المنصة تمنحك أدوات واضحة، وخطوة موافقة بشرية، وسجلات تشغيل، وطريقة لإيقاف الحلقة. وجود واجهة مرئية لا يلغي الحاجة إلى تلك الضوابط الأساسية.

كيفية بناء وكيل ذكاء اصطناعي: أول إصدار عملي

أسرع طريق هو تقليص نطاق المهمة قبل التوسع في استخدام التكنولوجيا.

1. اكتب عقداً للمهمة في جملة واحدة

حدد المستخدم، والمحفز للبدء، والإجراء، وخط النهاية. عبارة "المساعدة في دعم العملاء" واسعة جداً. أما عبارة "الإجابة على أسئلة حالة الطلب باستخدام واجهة برمجة تطبيقات الطلبات، وإحالة أي مسألة تتضمن استرداد الأموال أو تغيير العنوان إلى موظف" فهي قابلة للبناء والاختبار.

حدد أيضاً الإجراءات المحظورة. هذا يحول الاستقلالية الغامضة إلى قرار منتج منضبط بحدود دقيقة.

2. تحقق مما إذا كانت المهمة تحتاج إلى وكيل أصلاً

تبرر حلقة الوكلاء تعقيدها عندما يتطلب العمل تقديراً بشرياً، ولغة أو مستندات غير منتظمة، واستثناءات تجعل مجموعات القواعد البرمجية الثابتة هشة وعاجزة. يوصي دليل OpenAI العملي بالاعتماد على الأنظمة المحددة سلفاً (deterministic) عند غياب هذه الظروف.

حساب الضرائب، أو التحقق الثابت من صحة النماذج، أو النسخ المجدول للبيانات يجب أن يظل عادة برمجيات تقليدية. أما طلب استرداد الأموال الذي يتطلب قراءة المحادثة، والتحقق من السياسة، وفحص الطلب، والبت فيما إذا كان يلزم مراجع بشري، فهو مهمة مثالية للوكيل.

3. اختر النموذج المناسب للمهمة وليس للعرض التقديمي

تعتمد حزمة SDK حالياً بشكل افتراضي على gpt-5.4-mini دون جهد استدلال وتوليد نصوص منخفض لمهام سير العمل منخفضة زمن الاستجابة. ويوصي دليل النماذج الخاص بها بنموذج gpt-5.6-sol عندما تكون الجودة العالية مطلوبة ولديك حق الوصول إليه.

ابدأ بالخيار الأقل تكلفة الذي يجتاز حالات الاختبار المحفوظة لديك. لا تنتقل إلى طراز أعلى إلا عندما ينبع الفشل من جودة التقدير والتحليل، وليس بسبب أداة مفقودة أو تعليمات غامضة أو بيانات رديئة. لن يتمكن النموذج الأقوى من إصلاح واجهة برمجة تطبيقات تُرجع حالات طلبات قديمة وغير محدثة.

4. امنح الوكيل أداة واحدة للقراءة فقط

يجب أن تقوم أداتك الأولى باسترجاع المعلومات لا تعديلها. فحص حالة الطلب، أو البحث في السياسات، أو التحقق من المخزون، أو معرفة المواعيد المتاحة في التقويم هي مهام أسهل في التقييم وأكثر أماناً في إعادة المحاولة من إجراءات استرداد الأموال، أو الإلغاء، أو الدفع، أو إرسال رسائل بريد إلكتروني خارجية.

تستطيع حزمة SDK تحويل دالة Python محددة الأنواع إلى أداة وتوليد مخطط المدخلات تلقائياً. كما توفر أدوات مستضافة مثل البحث في الويب، والبحث في الملفات، ومفسر التعليمات البرمجية، وMCP، وتوليد الصور. أما أدوات التحكم المحلي بالحاسوب، وسطر الأوامر (shell)، وتعديل الملفات فتتطلب بيئة تنفيذ تخضع لتحكمك الكامل.

إليك أصغر نمط عملي قابل للتطبيق:

from agents import Agent, Runner, function_tool

@function_tool
def lookup_order(order_id: str) -> str:
    """Return the current order status from the order system."""
    return "Order 123 is packed and awaiting carrier pickup."

agent = Agent(
    name="Order status agent",
    instructions=(
        "Answer order-status questions with lookup_order. "
        "Never change or cancel an order. Escalate anything else."
    ),
    tools=[lookup_order],
)

result = Runner.run_sync(agent, "Where is order 123?")
print(result.final_output)

قم بتثبيت حزمة Python SDK عبر الأمر pip install openai-agents واحتفظ بمفتاح API داخل متغير البيئة OPENAI_API_KEY. تتوفر نفس بنية المنتج عبر حزمة TypeScript SDK الحالية إذا كانت تناسب بنيتك التقنية بشكل أفضل.

5. دع الحلقة تتوقف

يقوم المشغل (Runner) باستدعاء النموذج، وتنفيذ أي أداة مطلوبة، وإرسال نتيجة الأداة مجدداً، وتكرار العملية. تنتهي الحلقة عندما يرجع النموذج المخرجات النهائية دون استدعاء أي أداة. كما يمكنه التوقف عند الوصول إلى الحد الأقصى من الجولات وإرجاع استثناء MaxTurnsExceeded.

يحتاج كل وكيل إنتاجي إلى حد أقصى للخطوات، ومهلة زمنية محددة (timeout)، ونتيجة فشل واضحة. عبارة "تعذر التحقق، أُحيلت المسألة إلى موظف" هي خط نهاية سليم تماماً. تكرار المحاولة إلى ما لا نهاية ليس إصراراً، بل هو عطل تشغيلي وحادث نظام.

6. اختر استراتيجية ذاكرة واحدة

الذاكرة تعني نقل السياق ذي الصلة إلى الجولة التالية. يمكن لـ SDK تخزين السجل من جانب العميل في جلسة (session)، أو يمكنك استخدام الاستئناف الذي تديره OpenAI عبر conversation_id أو previous_response_id.

اختر استراتيجية واحدة لكل محادثة. تمنع حزمة SDK صراحة الجمع بين جلسة العميل وخيارات الحالة المدارة عبر الخادم في نفس التشغيل، لأن تداخل السجلات قد يضاعف السياق دون داعٍ. حدد أيضاً كمية السجل التي يحتاجها الوكيل بالفعل؛ فوكيل الدعم الفني قد يحتاج فقط إلى بيانات التذكرة الحالية، وليس النص الكامل لكل محادثات العميل السابقة.

7. ضع ضوابط حول كل حد تشغيلي خطير

استخدم حاجز حماية للمدخلات (input guardrail) لرفض الطلبات الخارجة عن نطاق المهمة. واستخدم حاجز حماية للأدوات (tool guardrail) حول كل دالة مخصصة يمكنها قراءة أو تعديل بيانات العمل الحساسة. واستخدم حاجز حماية للمخرجات (output guardrail) لفحص الإجابة النهائية. واشترط موافقة بشرية صريحة قبل تنفيذ أي إجراءات مكلفة أو غير قابلة للإلغاء.

هناك تفصيل محوري: حواجز حماية المدخلات تعمل بالتوازي افتراضياً. هذا يقلل زمن الاستجابة، لكن الوكيل قد يستهلك رموزاً برمجية أو يبدأ في تشغيل أداة قبل أن يفشل فحص الأمان. استخدم وضع الحظر الإلزامي (blocking mode) عندما يحتمل أن يتسبب الطلب في تأثير جانبي أو تسريب بيانات حساسة.

للحصول على نمط إنتاجي أكثر عمقاً، راجع دليل حواجز حماية وكلاء الذكاء الاصطناعي وتقليص نطاق التأثير. الفكرة الأساسية بسيطة: مرر كل إجراء مدفوع، أو مُعدِّل للبيانات، أو مقيد الصلاحيات عبر نقطة تحكم واحدة يمكن مراقبتها.

8. تتبع الأداء وقيم النتائج، ثم أضف بيئة العزل عند الحاجة

ميزة التتبع (tracing) مفعلة افتراضياً في حزمة Agents SDK. فهي تسجل استجابات النماذج، واستدعاءات الدوال، وحواجز الحماية، وإحالات العمليات لمعرفة أسباب نجاح التشغيل أو فشله. راجع سجلات التتبع وقارنها بمجموعة محفوظة من الطلبات الواقعية والنتائج المتوقعة قبل إضافة المزيد من الأدوات.

قد تتضمن سجلات التتبع مدخلات ومخرجات النماذج والدوال، لذا احرص على تعطيل التقاط البيانات الحساسة حيثما يلزم. تذكر أن ميزة تتبع OpenAI غير متاحة بموجب سياسة عدم الاحتفاظ بالبيانات (Zero Data Retention).

لا تستخدم بيئة العزل (sandbox) إلا إذا تطلبت المهمة فعلياً ملفات، أو أوامر سطرية، أو حزم برمجية، أو الاحتفاظ بحالة مساحة العمل على المدى الطويل. أضاف تحديث SDK في April 2026 بيئات متحكم بها محلياً، وبيانات تعريفية متنقلة لمساحات العمل، ولقطات حالة (snapshots)، ودعماً للعديد من مزودي بيئات العزل. وكيل استعلامات الدعم الفني لا يحتاج إلى حاوية تشغيل، بينما يحتاجها محلل المستندات أو وكيل البرمجة في أغلب الأحيان.

تكاليف التشغيل الفردية

لا تفرض حزمة SDK أو واجهة Responses API رسوم منصة منفصلة. أنت تدفع فقط مقابل استهلاك رموز (tokens) النموذج المحدد وأي أدوات مستضافة مستخدمة.

وفقاً للأسعار القياسية الحالية للنصوص القصيرة، تبلغ تكلفة gpt-5.6-sol حوالي $5 لكل مليون رمز إدخال و$30 لكل مليون رمز إخراج. بينما تبلغ تكلفة gpt-5.6-terra حوالي $2 و$12. ويكلف gpt-5.6-luna حوالي $0.20 و$1.20. تبلغ تكلفة البحث في الويب $10 لكل 1,000 استدعاء يضاف إليها استهلاك رموز محتوى البحث. استدعاءات البحث في الملفات عبر Responses تكلف $2.50 لكل 1,000، مع تكلفة تخزين تبلغ $0.10 لكل GB يومياً بعد أول 1 GB مجاني. وتبدأ حاوية تشغيل الأوامر البرمجية أو مفسر التعليمات سعة 1 GB من $0.03 لجلسة عمل مدتها 20 دقيقة.

لا تعكس أسعار الوحدات هذه التكلفة الحقيقية لإنجاز مهمة كاملة واحدة، بل سجل التتبع الخاص بك هو ما يحدد ذلك بدقة. قس جولات النموذج، واستدعاءات الأدوات، ومحاولات الإعادة، والإحالات البشرية لكل نتيجة ناجحة، ثم اختر ميزانية النماذج والأدوات التي تضمن الجودة المطلوبة.

سبع مهام تستحق بناء وكيل لها، مرتبة حسب الجدوى

أفضل مهام الوكلاء هي التي تمتلك مشترياً واضحاً، وسير عمل منضبطاً، ونتيجة نهائية يمكن التحقق منها.

1. وكيل حل مشكلات العملاء

يمكن لفريق دعم التجارة الإلكترونية تزويد الوكيل بمحتوى المساعدة المعتمد وبيانات الطلبات للقراءة فقط. يستطيع الوكيل تحديد هوية العميل، واسترجاع حالة الشحن، وشرح الخطوة التالية، وتمرير طلبات استرداد الأموال أو تغيير العنوان إلى موظف بشري. الميزة تكمن في سرعة الاستجابة الأولى وملاحظات التسليم الواضحة، وليس الاستغناء التام عن البشر في الدعم.

2. وكيل البحث المعتمد على الأدلة

يمكن لفريق الاستراتيجية وضع مجموعة من التقارير في مساحة عمل خاضعة للرقابة وطلب مقارنة منهجية مع ربط أسماء ملفات المصادر بكل ادعاء. يستطيع الوكيل البحث، والاستخراج، والتحقق المتقاطع، وصياغة تقرير منظم. تكمن القيمة في تحويل المحللين من إضاعة الوقت في البحث عن الملفات إلى التركيز على التقييم وصنع القرار.

3. وكيل تأهيل المبيعات والتحضير للاجتماعات

يمكن لفريق مبيعات B2B إسناد قراءة الرسائل الواردة إلى وكيل، ليقوم بإثراء بيانات الشركة من مصادر معتمدة، وفحص شروط التأهيل، وصياغة موجز للاجتماع. يقوم بحجز الموعد فقط عندما يستوفي العميل المحتمل معايير واضحة. القيمة هنا هي التحضير المتسق وتخفيف الإدخال اليدوي في CRM، مع بقاء مسؤول المبيعات مالكاً للعلاقة.

4. وكيل استلام وإدارة العمليات التشغيلية

يمكن لمدير العقارات توجيه رسائل البريد الإلكتروني الخاصة بالصيانة عبر وكيل يستخرج المبنى، ورقم الوحدة، ونوع المشكلة، ومستوى الاستعجال، والوقت المفضل للزيارة. يفحص سجل المستأجر، وينشئ مسودة تذكرة، ويصعد مشاكل السلامة فوراً. الفائدة هي تقليل إعادة إدخال البيانات والحد من تذاكر العمل الناقصة.

5. وكيل مقارنة العقود والسياسات

يمكن لفريق المشتريات الاستعانة بوكيل لمقارنة عقد المورد مع البنود القياسية للشركة، وتحديد الاختلافات بدقة، والاستشهاد بالصفحات ذات الصلة. يستطيع تجهيز ملف المراجعة دون اعتماد الشروط. هذا يختصر المراجعة الأولية مع إبقاء الحكم القانوني بيد المستشار المختص.

6. وكيل فرز طلبات الدعم الفني الداخلي

يمكن لفريق تقنية المعلومات ربط وكيل داخلي للموظفين بمخزون الأجهزة، وحالة الخدمات، وأدلة حل المشكلات المعتمدة. يجمع البيانات التشخيصية، ويقترح خطوات آمنة، ويفتح تذكرة مرفقة بكافة الأدلة. الفائدة هي اختصار المحادثات المكررة ذهاباً وإياباً قبل أن يبدأ الفني عمله.

7. وكيل معالجة الملفات والبرمجة في بيئة معزولة

يمكن لفريق المالية أو الهندسة وضع المستندات أو مستودع الأكواد البرمجية داخل بيئة عزل، والسماح بمجموعة محددة من الأوامر، وتعيين مجلد للمخرجات. يفحص الوكيل الملفات، ويجري التحليل، ويعدل المسودة، ويقدم المخرجات للمراجعة. هنا تبرز أهمية بيئة العزل الحديثة، لأن العمل يتطلب مساحة عمل حقيقية وتوثيقاً مسجلاً للخطوات.

ثلاثة منتجات تجارية يمكنك بناؤها استناداً إلى هذا

العبارة العامة "وكيل ذكاء اصطناعي" لا تشكل سوقاً بذاتها. هذه المهام الثلاث تمتلك نية شراء مثبتة وقابلة للقياس.

الفرصة الأقوى: وكيل متخصص لحل قضايا العملاء في قطاع محدد

ابنِ وكيل دعم فني مخصصاً لنظام تشغيل أعمال معين، مثل متاجر Shopify، أو مديري العقارات، أو شركات الخدمات الميدانية. يدفع المشتري هنا مقابل الحالات التي تم حلها وسلاسة الإحالة للبشر، وليس مقابل واجهة دردشة عامة.

المؤشرات التجارية قوية جداً. يحصد مصطلح "AI customer service agent" حوالي 720 عملية بحث شهرياً على Google، بنية تجارية واضحة وسعر نقرة (CPC) يبلغ $264.61. كما يسأل المستخدمون مساعدي الذكاء الاصطناعي عن نفس المهمة نحو 69 مرة شهرياً. يبلغ المعيار السعري الحالي لدى Intercom حوالي $0.99 لكل محادثة أو استجابة بريدية ناجحة، أو إحالة وفق إجراء معتمد، أو استبعاد عميل غير مؤهل.

يحتاج الإصدار الأصغر القابل للبيع إلى قناة تواصل واحدة، ومصدر معرفة معتمد، وأداة حسابية للقراءة فقط، وآلية تسليم للموظفين، ولوحة تحكم بالنتائج. النقطة المحورية هي أن ميزتك التنافسية ليست استدعاء النموذج، بل التكاملات القطاعية، ومجموعات الاختبار، وتصميم التصعيد، وإثبات أن "الحل" المقدم كان إيجابياً للعميل بالفعل.

هذه هي الفرصة الأقوى نظراً لضيق نطاق المهمة، ووضوح هوية المشتري، وإمكانية قياس النجاح بدقة. كما يشير سعر النقرة المرتفع للغاية إلى شراسة منافسة الشركات الحالية على هذا العميل.

وكيل بحث موثق بالأدلة لمهنة متخصصة

أنشئ مساحة عمل بحثية لشريحة محددة، مثل محللي الامتثال، أو كُتاب المنح، أو باحثي أسواق الرعاية الصحية، أو فرق الفحص النافي للجهالة. يجب أن يبحث الوكيل في مجموعة نصوص معتمدة، ويربط المصادر بالادعاءات، ويقارن الأدلة المتضاربة، ويصدر موجزاً متسقاً وقابلاً للتكرار.

يحصد مصطلح "AI powered research assistant" حوالي 18,100 عملية بحث شهرياً على Google بنية تجارية. ويحصل المصطلح الأوسع "AI research assistant" على 2,400 عملية بحث أخرى. تسعر منصة Elicit حالياً خطة Pro بمبلغ $49 لكل مستخدم شهرياً وخطة Scale بمبلغ $169، ما يثبت استعداد المشترين للدفع مقابل أتمتة مهام البحث المنظم.

يتطلب النموذج الأولي نوعاً واحداً من مصادر البيانات، وقالب تقرير موحد، وجدول أدلة موثق بالمصادر، وقائمة مراجعة للموافقة. التحدي الأساسي هو الاتساع الزائد؛ فالمساعد البحثي العام يضعه في مواجهة مباشرة مع المنتجات الكبرى. النسخة القابلة للاستمرار تجارياً هي التي تسيطر على مصادر بيانات تخصصية، أو أسلوب عمل دقيق، أو معايير جودة لا تقدمها الأدوات العامة.

وكيل تأهيل ومتابعة المبيعات

ابنِ وكيلاً للمحادثات الواردة يجيب على الأسئلة التقنية للمنتج، ويتحقق من ملاءمة العميل، وينشئ سجلاً في CRM، ويصيغ ملخصاً للمقابلة، ويحجز موعداً في التقويم فقط عند استيفاء الشروط. ابدأ دائماً بالزيارات الواردة، فالرسائل الصادرة المؤتمتة بالكامل دون إشراف تزيد من مخاطر الامتثال وسمعة العلامة التجارية.

يحصد مصطلح "AI sales agent" قرابة 1,000 عملية بحث شهرياً على Google بنية تجارية، مع سعر نقرة يبلغ $74.89. تحدد Intercom حالياً سعر نتيجة التأهيل الناجحة بمبلغ $9.99، ما يوفر مرجعاً تسعيرياً واضحاً في السوق.

يحتاج النموذج الأولي إلى واجهة دردشة للموقع أو بريد إلكتروني، وربط مع CRM للقراءة فقط، وقواعد تأهيل واضحة، والوصول إلى التقويم، ومراجعة بشرية قبل أي متابعة حساسة. الخطر الأكبر هو رداءة البيانات المصدرية؛ فالوكيل الذكي الذي يعمل على سجلات CRM غير مكتملة سيقوم بتأهيل أشخاص غير مناسبين بثقة مطلقة خاطئة.

الحدود التشغيلية التي تصنع الفارق

الوكيل الذكي لا يحول البرمجيات الاحتمالية إلى برمجيات حتمية، بل ينقل عدم اليقين إلى حلقة عمل يمكنك مراقبتها والسيطرة عليها.

• لا تستخدم وكيلاً لمنطق برمجي ثابت يتعامل معه الكود البرمجي العادي بكفاءة أفضل.
• لا تمنح الوكيل صلاحيات الكتابة أو التعديل قبل اجتياز إصدار القراءة فقط لحالات اختبار حقيقية.
• لا تعتمد على حاجز حماية واحد في المستوى الأعلى. حواجز حماية الوكلاء لا تغطي كل الأدوات المدمجة أو المستضافة، لذا يجب أن تتواجد فحوصات الأذونات في طبقة التطبيق والأدوات الخاصة بك أيضاً.
• لا تخلط بين أنظمة إدارة الذاكرة دون تخطيط. يؤدي تكرار السياق إلى سلوك مشوش واستهلاك مهدر للرموز البرمجية.
• لا تبدأ بنظام يعتمد على عدة وكلاء متزامنين. توصي OpenAI بتحقيق أقصى استفادة من وكيل فردي مدعوم بالأدوات قبل الانتقال إلى تنظيم وتنسيق عدة وكلاء.
• لا تسمح للنموذج باعتماد إجراءات لا رجعة فيها. تتطلب الخطوات عالية الخطورة تدخلاً بشرياً حتى تثبت الأدلة إمكانية وضع سياسة موافقة آلية أكثر ضيقاً.

يمكن لأدوات الأمان المساعدة في ذلك، لكن البنية الهيكلية للنظام تتحمل العبء الأكبر دائماً. يعد دليل مقارنة أدوات أمان الذكاء الاصطناعي مفيداً بمجرد معرفة المخاطر الحقيقية التي ينشئها وكيلك.

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

إذا كنت ترغب في بناء أحد هذه الحلول المصممة خصيصاً لتناسب أنظمتك وقواعد الموافقات المعتمدة لديك، فتعرف على خدمات تطوير وكلاء الذكاء الاصطناعي.