# وكلاء الصوت بالذكاء الاصطناعي


# وكلاء الصوت بالذكاء الاصطناعي

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

## ما الوكيل

يجمع كل وكيل معًا:

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

تعيش الوكلاء داخل المشاريع، متبعةً بنية **المؤسسة ← المشاريع ← الوكلاء** من [النظرة العامة](../introduction#نموذج-الطبقات-الثلاث). بمجرد نشر وكيل يمكنك توجيه الحملات والأرقام الواردة إليه.

## نموذج علامات تبويب المنشئ

![منشئ الوكيل وتبويباته](/img/screenshots/portal/agent-tab.png)
*أداة إنشاء الوكيل. تتيح علامات التبويب في الأعلى (Agent، Model، Voice، Behavior، Calling، Tools، Calendar، Workflow، Function Logs، Guardrails، Channels) ضبط كل جزء من أجزاء الوكيل.*

ينظّم المنشئ على **/agent/setup** التهيئة في إحدى عشرة علامة تبويب. تتنقّل عبرها من اليسار إلى اليمين، حافظًا أثناء تقدّمك. لكل علامة تبويب أساسية صفحة توثيق خاصة بها:

- **الوكيل** — الاسم والوصف وحالة الاستخدام والقالب الابتدائي، إضافةً إلى **موجّه النظام** و**التحية** ورسائل **الإنهاء / الاحتياطية / المشغول / البريد الصوتي**، ومفتاحَي **منشور** و**نشط**. هنا يبدأ كل وكيل جديد؛ انظر [أنشئ أول وكيل لك](./create-agent).
- **[LLM](./llm)** — وضع خط أنابيب الصوت، ومزوّد LLM ونموذجه، ودرجة الحرارة، وحدود الرموز، والمعاملات المتقدّمة، ونموذج احتياطي، وربط **RAG / قاعدة المعرفة** (انظر [المعرفة وRAG](./knowledge-rag)).
- **[الصوت (الصوت والسمع)](./voice-audio)** — تحويل الكلام إلى نص وتحويل النص إلى كلام متعدد المزوّدين (المزوّد والنموذج والصوت والضبط الخاص بالمزوّد).
- **[Engine (سلوك المحادثة)](./engine-behavior)** — المقاطعة ومعالجة المقاطعات، وحشو اكتشاف نشاط الصوت، وتأخير الاستجابة، ومعالجة الصمت، وكلمات الحشو.
- **[الاتصال](./calling-telephony)** — الوارد/الصادر، والمدة القصوى، والإنهاء التلقائي، والأرقام المعيّنة، وخطافات الويب.
- **[الأدوات](./tools-mcp)** — اربط وظائف الوكيل، واربط خوادم MCP، وافتح **منشئ Workflow**.
- **التقويم** — اربط Google أو Outlook عبر OAuth حتى يتمكن الوكيل من العمل مع التوافر.
- **[منشئ سير العمل](./workflow-builder)** — منشئ مرئي لمسار المكالمة (مغطّى أدناه)، يُطلَق من علامة تبويب الأدوات.
- **سجلات الوظائف** — مقاييس لكل وظيفة: أعداد الاستدعاءات والكمون والأخطاء للوظائف التي يستخدمها هذا الوكيل.
- **[الضوابط والامتثال](./guardrails)** — عناصر تحكم في الامتثال وجمع البيانات (مغطّاة أدناه).
- **[القنوات](../channels)** — الوصول إلى الأشخاص على تطبيقات المراسلة: WhatsApp وTelegram وFacebook Messenger وأداة ويب قابلة للتضمين.

### منشئ Workflow

تفتح علامة تبويب **Workflow** منشئ مسار مكالمة مرئيًا (يُطلَق بزر **Open Workflow Builder** على علامة تبويب الأدوات). يتيح لك تصميم مسارات مكالمة حتمية قائمة على العقد — أسئلة وشروط واستدعاءات أدوات وخطافات ويب وتحويلات — للوكلاء الذين يحتاجون مسارًا مكتوبًا بدلًا من محادثة مفتوحة.

### سجلات الوظائف

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

### Guardrails

تُبقي علامة تبويب **Guardrails** الوكيل آمنًا وممتثلًا. تتحكم في:

- **ضوابط المحتوى** — قائمة بـ**المواضيع المحظورة** التي يتجنّبها الوكيل ويوجّه بعيدًا عنها.
- **معالجة معلومات التعريف الشخصية** — كيف تُعامَل المعلومات القابلة لتعريف الشخص في النصوص (**إخفاء**، أو **تنقيح**، أو **سماح**)، إضافةً إلى منتقي **تنقيح معلومات التعريف الشخصية في النص** لكل نوع (الرقم القومي، وبطاقة الائتمان، والبريد الإلكتروني، والهاتف، والعنوان، وتاريخ الميلاد، والحساب البنكي).
- **وضع الامتثال** — **قياسي**، أو **صارم**، أو **HIPAA**، أو **PCI-DSS**؛ تُمكّن الأوضاع الأكثر صرامة تدابير أمان وتسجيلًا إضافيين.
- **جمع البيانات** — **الحقول المجموعة** التي يحاول الوكيل التقاطها و**الحقول المطلوبة** التي يجب أن يحصل عليها (محثًّا المتصل إن كانت مفقودة).
- **تحليل ما بعد المكالمة** — **التلخيص التلقائي** و**تحليل المشاعر** و**اكتشاف القصد** الاختياري.

:::note[القنوات هي تطبيقات مراسلة، لا بريد إلكتروني]

علامة تبويب **القنوات** لتطبيقات المراسلة — WhatsApp وTelegram وFacebook Messenger وأداة ويب. متابعة البريد الإلكتروني ليست قناة: إنها وظيفة **send_email** على علامة تبويب [الأدوات](./tools-mcp).

:::

:::tip

لا يتعيّن عليك ملء كل علامة تبويب للانطلاق. اسم ونموذج وصوت وتحية تكفي لاختبار أول. أضف المعرفة والأدوات بمجرد أن تبدو الأساسيات صحيحة.

:::

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

يقترن المنشئ بسطحَي اختبار حتى تتمكن من تجربة وكيل قبل أن يلمس المكالمات الحقيقية:

- **اختبار الصوت** على **/agent/interface** — تحدّث إلى الوكيل واسمعه يستجيب.
- **اختبار الدردشة** على **/agent/chat** — تبادل أدوار نصية لفحص المنطق والموجّهات بسرعة.

المسار الكامل من وكيل فارغ إلى منشور موجود في [أنشئ أول وكيل لك](./create-agent).

## الخطوات التالية

- [أنشئ أول وكيل لك](./create-agent)
- [هيّئ نموذج اللغة](./llm)
- [أعِدّ الصوت والسمع](./voice-audio)
- [شكّل سلوك المحادثة](./engine-behavior)