مساعدات الذكاء الاصطناعي المخصصة عمليًا: الكود والأوامر التي تهم فعلاً

مساعدات الذكاء الاصطناعي المخصصة: الأساسيات في مقال واحد — كود حقيقي، مخططات وخطوات ملموسة، مقتطفات من دورة مكونة من 44 درسًا.

مساعدات الذكاء الاصطناعي المخصصة عمليًا: الكود والأوامر التي تهم فعلاً

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

tl;dr
  • مقدمة والبدء
  • تصميم مساعد فعال
  • إنشاء GPTs مخصصة
  • مشاريع Claude وGemini Gems
  • الإجراءات والأدوات الخارجية
~$ cat ./parcours.md # مساعدون IA مخصصون — 10 فصول
01
مقدمة والبدء
→ تقديم الدورة ونظرة عامة 2026→ Comparer GPTs / Projects / Gems / Copilot Studio+ 1 دروس أخرى
02
تصميم مساعد فعال
→ تحديد المشكلة والشخصية المستهدفة→ النطاق: ما يفعله المساعد وما لا يفعله+ 2 دروس أخرى
03
إنشاء GPTs مخصصة
→ GPT Builder : واجهة محادثية مقابل التكوين→ التعليمات، starters والشعار المهني+ 2 دروس أخرى
04
Claude Projects و Gemini Gems
→ Claude Projects : تعليمات مخصصة ومعرفة→ الاستفادة من نافذة السياق الكبيرة لـ Claude+ 2 دروس أخرى
05
الإجراءات والأدوات الخارجية
→ Actions GPT : schéma OpenAPI 3.1→ Authentification : API key, OAuth+ 2 دروس أخرى
06
Copilot Studio من Microsoft
→ Copilot Studio : الواجهة والمفاهيم→ المواضيع والتدفقات الحوارية+ 2 دروس أخرى
07
Assistants API OpenAI
→ Assistants API : الهندسة المعمارية والمفاهيم→ Threads, messages et runs+ 2 دروس أخرى
08
الأمان والخصوصية
→ Prompts دفاعية ومضادة للـ jailbreak→ حماية تعليماتك السرية+ 1 دروس أخرى
🏁
المشروع النهائي (+ 2 فصول في الطريق)
→ تعود بمشروع ملموس وقابل للعرض

Threads، messages وruns

NOTEالهدف — التعامل عمليًا مع Threads وMessages وRuns في Python: إنشاء محادثة، إضافة رسالة، تشغيل Run، استرجاع الرد. فهم الاستطلاع (polling) والبث (streaming).

الأهداف التعليمية

TIPعند نهاية هذه الوحدة
  • إنشاء وإدارة Thread للمحادثة
  • إضافة رسائل المستخدم داخل Thread
  • تشغيل Run وإدارة دورة حياته
  • الاختيار بين polling وstreaming
  • استرجاع وعرض رد المساعد

Threads: ما هي بالضبط؟

Thread هو حاوية دائمة تخزن سجل المحادثة بين مستخدم ومساعد. OpenAI هي من تحتفظ به على خوادمها. أنت لا تدير سوى الـID.

أفضل ممارسة: Thread واحد لكل جلسة مستخدم. على سبيل المثال، في تطبيقك، تنشئ Thread عندما يبدأ المستخدم المحادثة. تخزن thread_id في قاعدة بياناتك.

الحالةالمعنى
queuedفي قائمة الانتظار، سيبدأ
in_progressالمساعد يولّد الرد
requires_actionاستدعاء دالة: يجب أن يرد كودك
completedانتهى بنجاح
failedفشل، راجع last_error
cancelledأُلغي يدويًا
expiredانتهت المهلة (10 دقائق)

Polling: انتظار انتهاء الـRun

النمط الكلاسيكي يتمثل في التحقق الدوري من الحالة حتى الاكتمال:

مثال كامل: محادثة بسيطة

مساعد عام

أنشئ المساعد مرة واحدة فقط واحفظ معرفه في الإعدادات.

Thread لكل جلسة

أنشئ Thread عند اتصال المستخدم، واحفظ المعرف في قاعدة البيانات.

استرجاع الـThread

مع كل رسالة جديدة، أعد استخدام المعرف المخزن للحفاظ على السجل.

الحدود والحصص

الجانبالحد
Run timeout10 دقائق
Messages per Threadلا يوجد حد صارم، لكن يُراقب
Threads per accountلا يوجد حد صارم
Concurrent Runsحسب المستوى (10-1000 متزامن)
Storage Threads30 يومًا افتراضيًا، ثم الحذف التلقائي

File search وcode interpreter

NOTEالهدف — تفعيل وتهيئة الأداتين الأصليتين الأقوى في Assistants API: File Search للـRAG الأصلي، وCode Interpreter لتنفيذ بايثون في بيئة معزولة.

الأهداف التعليمية

TIPعند نهاية هذه الوحدة
  • إنشاء Vector Store ورفع ملفات إليه
  • ربط Vector Store بمساعد للـRAG
  • تفعيل Code Interpreter واختبار حسابات بايثون
  • استرجاع الملفات التي يولدها Code Interpreter
  • دمج الأداتين في مساعد واحد

File Search: الـRAG الأصلي من OpenAI

File Search هو أدا�� الـRAG الأصلية في Assistants API. تعطيه ملفات فيقوم بفهرستها تلقائيًا (تقسيم، تضمين، vector store) ويسمح للمساعد بالبحث عن مقاطع ذات صلة.

الفرق مع RAG مخصص: مع File Search لا تحتاج إلى اختيار chunker ولا نموذج تضمين ولا إدارة vector DB. OpenAI يقوم بكل ذلك.

الـVector Stores

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

TIPالنتيجة: تُثرى الردود بوثائقك مع اقتباسات تلقائية في تعليقات الرسالة.

استرجاع الاقتباسات

تفعيل Code Interpreter

رفع ملف لـCode Interpreter

Function calling وأدوات مخصصة

NOTEالهدف — السماح للمساعد باستدعاء دوال بايثون الخاصة بك (function calling) لتنفيذ منطق أعمال، قراءة قواعد بيانات داخلية أو تنسيق إجراءات معقدة تتجاوز الأدوات الأصلية.

الأهداف التعليمية

TIPعند نهاية هذه الوحدة
  • تعريف دالة مخصصة بصيغة JSON Schema
  • ربطها بالمساعد كأدا��
  • التعامل مع حالة requires_action وإرسال رد
  • تعريف عدة دوال وترك المساعد يختار
  • بناء وكيل صغير يجمع عدة أدوات

لماذا function calling؟

File Search وCode Interpreter قويان لكنهما محدودان: يصلان فقط إلى الملفات وبايثون المحلي. لكل شيء آخر (قاعدة بياناتك الداخلية، واجهاتك المخصصة، إجراءات أعمال محددة)، تحتاج إلى function calling.

المبدأ: تصف دوال بايثون للنموذج. عندما يريد استدعاءها، يرجع اسم الدالة والمعاملات. تنفذ الدالة من جهتك وترسل النتيجة.

تعريف دالة بصيغة JSON Schema

تصف كل دالة باسم ووصف ومخطط للمعاملات:

التعامل مع حالة requires_action

عندما يقرر المساعد استدعاء دالتك، ينتقل الـRun إلى الحالة requires_action. يجب عليك:

التوازي في tool_calls

إذا طلب المساعد عدة دوال في نفس الوقت (مثل "أعطني الطقس في باريس وفي ليون")، يمكنك تنفيذها بالتوازي لتحسين الأداء:

وكيل صغير: دمج الأدوات الأصلية والدوال

الذروة: مساعد يجمع file_search وcode_interpreter ودوالك المخصصة. يصبح وكيلاً حقيقيًا.

va-plus-loin

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

./acceder-au-cours-complet cours gratuit : Ingénierie de prompts

الأسئلة الشائعة

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

📬 هل تريد تلقي هذا النوع من الأدلة كل أسبوع؟ اشترك مجانًا — كود حقيقي، بدون ثرثرة.