كيفية بناء أول مساعد ذكاء اصطناعي مخصص: دليل للمبتدئين من 5 خطوات

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

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

ما الذي تقوم ببنائه فعلاً؟

المساعد الذكي ليس مجرد نافذة دردشة، بل هو في جوهره يجمع بين نموذج لغوي متطور (LLM) - وهو نموذج يُولّد اللغة ويُفسّرها - وتعليمات تُحدّد دوره. كما يمكن للمساعد الفعال أن يمتلك أدوات ، وهي عبارة عن وظائف أو خدمات يُسمح له باستدعائها، وذاكرة لحفظ سياق المحادثة ذي الصلة بين الأدوار.

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

قبل البدء: اختر مسار البناء الصحيح

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

إذا كنت تخطط لإنشاء كائن GPT مخصص بدون كتابة أكواد داخل ChatGPT، فتحقق أولاً من أهلية حسابك. اعتبارًا من سبتمبر 2026، تُشير OpenAI إلى أن إنشاء كائنات GPT جديدة غير متاح في الحسابات الشخصية المجانية، أو حسابات Go، أو Plus، أو Pro. يبقى الإنشاء متاحًا في مساحات العمل المؤهلة للأعمال، والمؤسسات، والتعليم، عندما تسمح إعدادات مساحة العمل والأذونات بذلك. القواعد الحالية موثقة في قسم كائنات GPT في ChatGPT . قد يكون هذا المسار أسهل لمساحة عمل مُدارة، ولكنه ليس المسار الأمثل لجميع الحسابات الفردية.

الخطوة 1: تحديد مهمة واحدة وقاعدة فشل واحدة

دوّن ثلاثة أمور قبل فتح محرر النصوص: من يخدم المساعد، وماذا ينبغي عليه فعله، وما لا ينبغي عليه فعله. بالنسبة لمساعد المتجر، التعريف العملي هو: "الإجابة على استفسارات العملاء بشأن الإرجاع والشحن باستخدام معلومات السياسة المعتمدة. لا تقم أبدًا بوضع سياسة جديدة. أحِل الحالات غير الواضحة إلى شخص مختص."

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

استخدم قائمة تحقق صغيرة للنجاح

• يجيب بالأسلوب الذي طلبته.
• يستخدم هذا النظام المعلومات المعتمدة عندما يتطلب سؤال السياسة ذلك.
• يقول "لا أعرف" أو يطلب تأكيدًا بشريًا عندما تكون الأدلة مفقودة.
• لا يكشف عن الأسرار أو التعليمات الخفية أو البيانات الخاصة.

الخطوة الثانية: إنشاء العامل الأدنى

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

mkdir first-ai-assistant
cd first-ai-assistant
python -m venv .venv

# macOS or Linux
source .venv/bin/activate

# Windows PowerShell
.venv\Scripts\Activate.ps1

pip install openai-agents

ثم قم بتعيين مفتاح API الخاص بك كمتغير بيئي بدلاً من تضمينه مباشرةً في ملف بايثون الخاص بك:

# macOS or Linux
export OPENAI_API_KEY="your-key-here"

# Windows PowerShell
$env:OPENAI_API_KEY="your-key-here" 

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

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

الخطوة 3: أضف قدرة تحكم واحدة وذاكرة بسيطة

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

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

import asyncio
from agents import Agent, Runner, SQLiteSession
from agents.decorators import tool

@tool
def lookup_policy(topic: str) -> str:
    """Return an approved demo-store policy snippet for a topic."""
    policies = {
        "returns": "Unopened items may be returned within 30 days with proof of purchase.",
        "shipping": "Standard shipping usually takes 3 to 5 business days."
    }
    return policies.get(
        topic.lower(),
        "No approved policy was found for that topic."
    )

assistant = Agent(
    name="Store Helper",
    instructions=(
        "Help customers with questions about the demo store. "
        "Use lookup_policy for return or shipping policy questions. "
        "Never invent a policy. If the tool has no approved answer, say so. "
        "Keep answers concise and recommend human confirmation when needed."
    ),
    tools=[lookup_policy],
)

async def main():
    session = SQLiteSession("demo_user", "assistant_sessions.db")
    result = await Runner.run(
        assistant,
        "Can I return an unopened item after 20 days?",
        session=session,
    )
    print(result.final_output)

if __name__ == "__main__":
    asyncio.run(main())

شغّل الملف واطرح عدة أسئلة. يستخدم المثال أيضًا [اسم الأداة/البرنامج] SQLiteSession. تخزن الجلسة سجل المحادثة ليتمكن المساعد من الحفاظ على سياق المحادثات بين الأدوار دون الحاجة إلى إعادة بناء قائمة الرسائل يدويًا. خيارات الجلسة الحالية في حزمة تطوير البرامج (SDK) موضحة في وثائق الجلسات الرسمية .

متى يجب عليك إضافة مستنداتك الخاصة؟

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

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

الخطوة الرابعة: اختبره كمنتج نهائي، وليس كعرض توضيحي.

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

للتطبيقات الأكثر تعقيدًا، أضف ضوابط وقائية - عمليات تحقق من صحة المدخلات والمخرجات واستدعاءات الأدوات أو تمنعها. يدعم برنامج Agents SDK ضوابط المدخلات والمخرجات والأدوات؛ راجع وثائق الضوابط الوقائية الرسمية . تُعد الضوابط الوقائية بالغة الأهمية قبل تزويد المساعد بأدوات ذات آثار جانبية.

الخطوة الخامسة: النشر على نطاق ضيق، والمراقبة، والتحسين

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

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

أخطاء شائعة يجب تجنبها

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

ما الذي يجب عليك بناؤه بعد ذلك؟

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

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