> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wittify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# بناء وكيل نصي

> دليل خطوة بخطوة لإنشاء وكيل شات فقط. ويدجت الويب، WhatsApp، Messenger، Instagram، X، Telegram. المعالج فيه 6 خطوات بهذا الترتيب: الإعدادات النصية، المظهر، قاعدة المعرفة، التذاكر والعملاء المحتملين، التَكاملات والأدوات، النشر.

<div dir="rtl" lang="ar" style={{ direction: "rtl" }}>
  <Note>
    الوكلاء النصيون يَتعامَلون مع **محادثات الشات فقط**. بدون مكالمات هاتفية. للدخول، اضغط **إنشاء وكيل** في الشريط العلوي للوحة التَحكُّم، ثم **وكيل نصي** في المُنتقي. يَفتح المعالج على **الخطوة 1: الإعدادات النصية**.
  </Note>

  ## ما قبل الإقلاع

  قبل البدء، اِجعَل هذه جاهزة:

  * **اسم** لوكيلك (تَستطيع تَغييره لاحقاً).
  * **وصف موجز** لما يَفعله الوكيل (فيَكون لموجِّه النَظام سياق).
  * **شعار أو أيقونة** (اختياري، لكن الويدجت تَبدو أفضل بواحد).
  * **مَصدر معرفة**، ملفات / أسئلة شائعة / روابط ستُغذيه بها في الخطوة 3.

  المعالج يَعمل في `/{lang}/create/text/{step}`. الخطوة الأولى `text-settings`.

  ## خطوة بخطوة

  <Steps>
    <Step title="الخطوة 1: الإعدادات النصية">
      سَمِّ وكيلك، اختَر النَموذج، اكتب موجِّه النَظام، اضبط الإبداع / الحد الأقصى للرموز / Top-P / مستوى التَفكير / متَتاليات الإيقاف.

      **مطلوب للمتابعة**: اسم الوكيل (حد أقصى 100 حرف)، التَعليمات الأساسية (موجِّه النظام، حد أقصى 2,500 حرف).

      الصفحة فيها 4 بطاقات: **اسم الوكيل**، **اختيار النَموذج**، **موجِّه النظام** (مع حبَّات قوالب وتَعزيز ذكاء اصطناعي)، **الإعدادات المتَقدِّمة**.

      [المرجع الكامل للخطوة ←](/ar/Systems/AI-Agents/Wizard/Text-Settings)
    </Step>

    <Step title="الخطوة 2: المظهر">
      صَمِّم ويدجت الشات: الألوان، الشعار، الأيقونة، أيقونة المُطلِق، الموضع، الخط، شريط الترحيب، تَقييمات ما بعد الشات، الحالة المُصغَّرة. حتى 10 لُغات لكل ويدجت مع افتراضات مُترجَمة أصلية لـ15 لُغَة.

      الصفحة فيها 8 أقسام: **لُغَة واجهة المحادثة**، **العلامة التَجارية**، **أيقونة مُطلِق الويدجت**، **موضع الويدجت**، **الخط والعرض**، **شريط رسالة الترحيب**، **مراجعات ما بعد الشات**، **الحالة المُصغَّرة**.

      [المرجع الكامل للخطوة ←](/ar/Systems/AI-Agents/Wizard/Appearance)
    </Step>

    <Step title="الخطوة 3: قاعدة المعرفة">
      ارفع الملفات (PDF و DOCX و TXT و CSV و XLSX و PNG و JPG)، أَضِف أسئلة شائعة بالكتابة أو استيراد CSV، أَضِف روابط للزحف، اِختَر تَفعيل البحث على الويب العام.

      الحدود: 10 ميجابايت لكل ملف، 100 ميجابايت إجمالي لكل وكيل. الأسئلة الشائعة بحد أقصى 300 حرف للأسئلة و2,000 للإجابات، حد أقصى 500 لكل استيراد CSV.

      هذه الخطوة **اختيارية**، تَستطيع المتابعة بقاعدة معرفة فارغة.

      [المرجع الكامل للخطوة ←](/ar/Systems/AI-Agents/Wizard/Knowledge-Base)
    </Step>

    <Step title="الخطوة 4: التذاكر والعملاء المحتملين">
      قَرِّر إذا كان الوكيل يَجمع بيانات العملاء (الاسم، البريد، الهاتف، الشركة، حقول مخصَّصة) وكيف يَفتح العملاء المحتملين مقابل التذاكر. الإشعارات تَستطيع الإطلاق إلى البريد أو Slack أو CRM (Zoho / Zendesk / HubSpot / Salesforce / Webhook مخصص / MCP).

      هذه الخطوة **اختيارية**، تَستطيع المتابعة بدون تَفعيل جمع البيانات.

      [المرجع الكامل للخطوة ←](/ar/Systems/AI-Agents/Wizard/Tickets-and-Leads)
    </Step>

    <Step title="الخطوة 5: التَكاملات والأدوات">
      وَصِّل أكثر من 21 تطبيقاً عبر **سوق التَكاملات** (OAuth أو مفتاح API)، أَضِف **موصِّلات MCP** (Model Context Protocol)، اضبط **أدوات الوكيل** المُدمَجة (التَحويل لموظف، حجز المواعيد، تتبُّع الطلبات، تحصيل المدفوعات)، ابنِ **أدوات API مخصَّصة** (حد أقصى 10)، اضبط **Webhooks والأحداث** لـ5 أنواع أحداث.

      هذه الخطوة **اختيارية**.

      [المرجع الكامل للخطوة ←](/ar/Systems/AI-Agents/Wizard/Integrations-and-Tools)
    </Step>

    <Step title="الخطوة 6: النشر">
      ثلاثة تبويبات: **الموقع** (كود التَضمين، النطاقات المسموح بها، رابط الويدجت القابل للمشاركة)، **التواصل** (WhatsApp و Instagram و Facebook و X و Telegram)، وبطاقة **حالة الوكيل** لـ**تَفعيل** الوكيل.

      تبويب الاتصالات الهاتفية مَخفي للوكلاء النصيين فقط (لا تَستطيع استقبال مكالمات، فلا شيء لتَوصيله).

      [المرجع الكامل للخطوة ←](/ar/Systems/AI-Agents/Wizard/Deployment)
    </Step>
  </Steps>

  ## ما يُخفيه معالج النصي (مقارنة بالهجين)

  الهجين هو المجموعة الأشمل. النصي يَقطع:

  * **الإعدادات الصوتية** (لا توجد خطوة صوت منفصلة)
  * نافذة **مُنتقي الصوت**
  * **زر المكالمة** في لوحة المعاينة الحية
  * حقول **نَص شاشة الصوت** في المظهر
  * تبويب **الاتصالات الهاتفية** في النشر
  * تبويب **الصوت** في التذاكر والعملاء المحتملين

  إذا احتاج عملك يوماً استقبال مكالمات، ستَحتاج لحذف هذا الوكيل وإعادة البناء كهجين (النوع مُقفَل عند الإنشاء).

  ## اختبر قبل الشحن

  سطحان للاختبار:

  1. **في المعالج**، لوحة المعاينة على اليَمين تَفاعلية. اكتب في إدخال الشات لإرسال رسائل اختبار حقيقية لوكيلك ورؤية كيف يَستجيب بموجِّهك وقاعدة معرفتك.
  2. **بعد أول حفظ**، زر **اختبار الوكيل** في الشريط العلوي لكل صفحة من إدارة الوكيل. يَفتح معاينة ويدجت تَنزلِق تُطابِق بالضبط ما سيَراه عملاؤك. [اقرأ المزيد ←](/ar/Systems/AI-Agents/Manage-Agent/Test-Your-Agent)

  ## التَفعيل

  عندما تُحفَظ كل الخطوات التي تَهتم بها (فقط الخطوة 1 مطلوبة بصرامة للتَفعيل)، اِنتقِل إلى **الخطوة 6: النشر** وانظر بطاقة **حالة الوكيل**. الزر يَقرأ **تفعيل الوكيل** بالأخضر مع أيقونة صح. اضغط لإحضار الوكيل للحياة. لا حاجة لتأكيد، التَفعيل إجراء إيجابي. الإشعار: *تم تفعيل الوكيل.*

  تَستطيع وَصل القنوات قبل أو بعد التَفعيل، الوكيل يَأخذ زواراً فقط من القنوات المُتَّصِلة بغض النَظر.

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

  <AccordionGroup>
    <Accordion title="زر التَفعيل باهت.">
      الحقول المطلوبة في الخطوة 1 (اسم الوكيل + التَعليمات الأساسية) غير مَمَلوءة بعد. احفظ الخطوة 1 بقيم صالحة، يُصبِح الزر نَشطاً.
    </Accordion>

    <Accordion title="وكيلي النصي أَعطى إجابة خاطئة عن شيء في قاعدة معرفتي.">
      راجع الخطوة 3، خط أنابيب حالة الملف. يَجب أن تَكون الملفات **مُدرَّبة** قبل أن يَستخدمها الوكيل. الملفات المُعلَّقة أو قيد المعالجة لا تَصِل إلى الإجابات.
    </Accordion>

    <Accordion title="هل أستطيع التَبديل من النصي للهجين لاحقاً؟">
      لا. النوع مُقفَل عند الإنشاء. احذف هذا الوكيل وأَنشِئ هجيناً جديداً إن احتجت الصوت.
    </Accordion>

    <Accordion title="ويدجتي تَظهر على `localhost` لكن ليس على موقعي الحي.">
      الخطوة 6، بطاقة **النطاقات المسموح بها**. أَضِف نطاق إنتاجك (مثل `https://www.yoursite.com`) واحفظ. الويدجت تَرفض التَحميل على أي نطاق غير مَدرج.
    </Accordion>

    <Accordion title="لا شيء يَحدث عند الضغط على حفظ مسوَّدة في الخطوة 4.">
      التذاكر والعملاء المحتملين هي الخطوة الوحيدة التي يُحفَظ فيها كل تَغيير فوراً عند إجرائه (لكل إضافة / تَعديل / حذف). زر **حفظ مسوَّدة** ليس عنده عمل ليَفعله، لذلك لا يُظهِر تَغذية راجعة. تَغييراتك محفوظة بالفعل.
    </Accordion>
  </AccordionGroup>

  ## التالي

  <CardGroup cols={2}>
    <Card title="افتح الخطوة 1" icon="play" href="/ar/Systems/AI-Agents/Wizard/Text-Settings">
      ابدأ من الإعدادات النصية.
    </Card>

    <Card title="رؤية إدارة الوكيل" icon="chart-line" href="/ar/Systems/AI-Agents/Manage-Agent/Manage-Agent-Overview">
      حيث يَعيش الوكيل بعد التَفعيل.
    </Card>
  </CardGroup>
</div>