المساعدة

مسرد المصطلحات

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

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

A

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

الرصيد الشهري (Allowance). رصيد الخطة الذي تحصل عليه مساحة العمل كل شهر، ويظهر على بطاقة الخطة كرصيد شهري، وكذلك مساحة المعرفة التي تمنحها الخطة. يُرحَّل الرصيد غير المستخدم حتى ثلاثة أضعاف الرصيد الشهري؛ أما التخزين فهو حد أعلى يبقى تحته مساحة العمل. الرصيد والشحن والترحيل.

مفتاح API (API key). السر الذي يرسله خادمك الخلفي كرمز Bearer مع كل طلب من API المطورين. يبدأ بـ ek_، ويُعرض مرة واحدة عند إنشائه، ويتبع مساحة عمل واحدة. احصل على مفتاح API.

مؤرشف (Archived). الحالة التي يأخذها الوكيل بعد إيقاف الوكيل مؤقتًا. لا يمكن تعديل الوكيل المؤرشف أو اختباره من البوابة، ولا يُحسب ضمن حد الوكلاء في الخطة. وزر استعادة يعيده إلى الحالة النشطة. حالة الوكيل.

صفحة المكتبة (Assets). الصفحة التي تسجل كل عملية تحويل نص إلى كلام، وكل نص مفرّغ أُنشئ من البوابة في مساحة العمل، الأحدث أولًا، مع تشغيل وتنزيل وإعادة إنشاء لكل عنصر. المكتبة والسجل.

اتصال المصادقة (Auth connection). بيانات اعتماد محفوظة مع طريقة مصادقة مرفقة بها، أساسية أو Bearer أو OAuth2، تنتج بها الأداة header Authorization الخاص بها. احفظه مرة واحدة، واربطه بكل أداة تستدعي API نفسه. اتصالات المصادقة.

الشحن التلقائي (Auto top up). قاعدة تشتري دفعة من الرصيد الإضافي لمساحة العمل كلما نزل الرصيد تحت حد تحدده، وتُحاسَب على البطاقة المرتبطة بالاشتراك، ضمن حد شهري تحدده. الرصيد والشحن والترحيل.

B

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

الربط (Binding). الرابط بين قناة واحدة والوكيل الواحد الذي يجيب عليها. الحساب المتصل مربوط بوكيل واحد فقط؛ وزر تعيين لوكيل آخر ينقل الربط، والرسالة التالية تفتح محادثة مع الوكيل الجديد. نظرة عامة على القنوات.

C

القناة (Channel). مكان يتواجد فيه عملاؤك أصلًا، متصل بأحد وكلائك: رقم WhatsApp، أو مساحة عمل Slack، أو رقم هاتف، أو حساب مكتب مساعدة. كل رسالة أو مكالمة تصل عليه تصبح محادثة مع ذلك الوكيل. نظرة عامة على القنوات.

المقطع (Chunk). جزء من النص قُسّم إليه مصدر المعرفة وقت فهرسته. عمود المقاطع يُظهر عددها في مصدر جاهز؛ والعدد المنخفض جدًا يعني أنه أمكن قراءة نص قليل جدًا منه. كيف تعمل المعرفة.

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

وسم المحادثة (Conversation tag). تسمية تنظمها مساحة العمل وتضعها على المحادثات. الوسوم تنتمي إلى مساحة العمل لا إلى وكيل، فالوسم الواحد يمكن أن يكون على محادثات من كل وكلائك. وسم المحادثة.

الرصيد (Credit). الوحدة التي يُدفع بها الاستخدام، من رصيد واحد. التوليد أو التفريغ أو التنقية تكلف عددًا ثابتًا من الرصيد، يُخصم قبل تشغيل العمل ويُعاد إن فشل. واستخدام الذكاء الاصطناعي هو سعر المزوّد زائدًا 10%، محوّلًا إلى رصيد. المفاهيم الأساسية.

حد الرصيد (Credit limit). حد اختياري على مفتاح API واحد: الرصيد الذي يجوز له إنفاقه في كل دورة فوترة. مكالمة تحويل نص إلى كلام تتجاوزه تُرفض برسالة 429 Monthly spending limit exhausted. احصل على مفتاح API.

سجل الرصيد (Credits History). القائمة في صفحة سجل المدفوعات التي تُظهر كل رصيد استُهلك أو أُعيد: كم كلّفت كل مهمة كلام، وهل أُعيد رصيدها، والرصيد بعدها. تتبع استخدام الرصيد.

D

اتصال قاعدة البيانات (Database connection). اتصال للقراءة فقط بقاعدة بياناتك، يُسجَّل مرة واحدة ليجيب الوكيل المتصلين من بيانات حية. ليس صفًا في مكتبة الأدوات؛ يصل إليه الوكيل عبر الأسئلة التي تعتمدها. ربط قاعدة بيانات.

سؤال قاعدة البيانات (Database question). استعلام واحد للقراءة فقط، صاغه النظام من بنيتك وتحقق منه مقابل قاعدتك، ويجوز للوكيل تشغيله بمعاملات يملؤها. لا يصل شيء إلى المحادثة قبل أن تعتمده. مراجعة أسئلة قاعدة البيانات واعتمادها.

API المطورين (Developer API). واجهة HTTPS التي تستدعيها أنظمتك لتحويل النص إلى كلام وتحويل الكلام إلى نص، تُصادَق بمفتاح API، وتُحتسب بالرصيد من مساحة العمل. نظرة عامة على API المطورين.

اللهجة (Dialect). اللكنة التي يتكلم بها الصوت. كل صوت يتكلم لهجة واحدة، فتختار الصوت وتأتيك لهجته معه. الفصحى هي العربية الفصحى المفهومة في المنطقة كلها، والبقية كلام بلد واحد. اللهجات.

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

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

E

الرصيد الإضافي (Extra credits). رصيد اشتريته بالشحن، يدويًا أو بالشحن التلقائي. كل دفعة لا تنتهي صلاحيتها، وتبقى بعد تغيير الخطة أو الإلغاء، وتعمل مع عدم وجود خطة مدفوعة، ولا تُنفق إلا حين لا يكفي رصيد الخطة لتغطية خصم. الرصيد والشحن والترحيل.

F

المجلد (Folder). مجموعة مصادر داخل مكتبة المعرفة. اختيار مجلد لوكيل يعني مرجعًا حيًا، فأي شيء تضعه في المجلد لاحقًا يصل إلى الوكيل دون تغيير آخر. تنظيم المعرفة في مجلدات.

الفصحى (Fusha). العربية الفصحى المفهومة في المنطقة كلها. وهي اللهجة التي يطبّق عليها خيار tashkeel في API. اللهجات.

G

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

رسالة الترحيب (Greeting message). أول جملة يقولها الوكيل حين تبدأ المحادثة، وتُكتب في تبويب الشخصية. ويجوز تركها فارغة. اكتب الشخصية.

H

التحويل إلى موظف (Handoff). اللحظة التي يتوقف فيها الوكيل وينتقل الحديث إلى شخص. في Zendesk و Zoho Desk و Intercom و Genesys Cloud chat يضع الوكيل علامة على التذكرة أو المحادثة لفريقك ثم يصمت. وعلى كل قناة أخرى يجب أن تحمل الشخصية العميل إلى شخص بالكلام. التحويل البشري.

I

التكامل (Integration). مزوّد تربطه مرة واحدة، فتصبح إجراءاته الجاهزة أدوات يستطيع وكلاؤك استدعاءها، مثل أدوات التقويم في حساب Google متصل، أو إرسال رسالة نصية على رقم Twilio متصل. أدوات التكامل تحمل بيانات اعتمادها بنفسها، فلا شيء يُضبط لكل استدعاء. نظرة عامة على الأدوات.

J

المهمة (Job). طلب واحد غير متزامن لتحويل نص إلى كلام أو تحويل كلام إلى نص في API. تمر المهمة بأربع حالات: pending وprocessing وcompleted وfailed، وتقرأ نتيجتها من نقطة نهاية المهمة أو عبر Webhook. الاستدعاء المتزامن وغير المتزامن.

K

مصدر المعرفة (Knowledge source). مادة يستطيع الوكيل الاقتباس منها: ملف ترفعه، أو نص تلصقه، أو صفحة ويب أو موقع توجّه المكتبة إليه. المصادر تنتمي إلى مساحة العمل، ويختار كل وكيل ما يجوز له استخدامه، ولا تُستخدم إلا المصادر في حالة جاهز. كيف تعمل المعرفة.

M

النموذج (Model). النموذج الواحد الذي يفكر للوكيل، ويُختار في تبويب الصوت تحت النموذج. وفي النماذج التي تدعم ذلك تحدد أيضًا مقدار التفكير قبل الإجابة. اختيار النموذج ودرجة التفكير.

N

الإشعار (Notification). رسالة ترسلها لك البوابة في الجرس بالشريط العلوي: انتهاء مصدر معرفة أو فشله، ونجاح دفعة أو فشلها، وانتهاء جلسة صوتية لنفاد الرصيد. قراءة الإشعارات.

O

أداة OpenAPI (OpenAPI tool). مستند Swagger أو OpenAPI واحد مستورد. تصبح الواجهة كلها صفًا واحدًا في مكتبة الأدوات، ويجد الوكيل العملية الصحيحة داخلها أثناء المحادثة. أدوات OpenAPI.

العملية (Operation). سجل واحد داخل أداة OpenAPI، واحد لكل عملية في المستند المستورد، مع مصادقته الخاصة وقيمه الثابتة ومفتاح تفعيله. عمليات أداة OpenAPI.

P

الشخصية (Persona). التبويب الذي يحدد من هو الوكيل في مساحة عملك، وكيف يتكلم، وأول جملة يقولها. يغيّر سلوك الوكيل أكثر من أي تبويب آخر. اكتب الشخصية.

حقل الشخصية (Personality). هو prompt الذي يقرؤه النموذج كلمة كلمة، وكل قاعدة صياغة يتبعها الوكيل تأتي منه: هويته، ونطاقه، ونبرته، وما يرفضه، ومتى يحوّل إلى شخص. اكتب الشخصية.

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

رصيد الخطة (Plan credits). الرصيد الذي تمنحه الخطة كل شهر. يُنفق أولًا، وما يبقى منه يُرحَّل عند تجديد الخطة نفسها، حتى ثلاث مرات الرصيد الشهري. الرصيد والشحن والترحيل.

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

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

R

درجة التفكير (Reasoning effort). مقدار تفكير النموذج قبل الإجابة، ويُضبط في تبويب الصوت للنماذج التي تدعمه: افتراضي وضئيل ومنخفض ومتوسط ومرتفع. الجهد الأعلى قد يحسّن الجودة، ويضيف زمن استجابة. اختيار النموذج ودرجة التفكير.

رمز الاسترداد (Recovery code). الرمز الواحد الذي تحفظه حين تفعّل المصادقة الثنائية، لتسجّل الدخول حين لا يكون تطبيق المصادقة في متناولك. المصادقة الثنائية.

حد الصلة (Relevance threshold). إعداد الاسترجاع الذي يحدد مدى قرب تطابق المقطع مع الدور قبل أن يجوز للوكيل استخدامه. يحتفظ الوكيل بالمقاطع التي تتجاوزه، حتى أعلى المستندات منها. كيف تعمل المعرفة.

سجل الطلبات (Request log). القائمة تحت المطورون في تبويب سجل الطلبات لكل طلب POST اجتاز المصادقة في API المطورين، مع حالته والمفتاح الذي أرسله. قراءة سجل الطلبات.

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

اختبار الاسترجاع (Retrieval bench). فحص اختبار الأداة على أداة OpenAPI مستوردة، يجيب عن سؤال واحد: هل سيصل هذا الوكيل إلى هذه العملية إذا قال المتصل كذا؟ هو اختبار استرجاع، لا اختبار تنفيذ. اختبار الاسترجاع.

الترحيل (Rollover). رصيد غير مستخدم يُحمل إلى الشهر التالي عند تجديد الخطة نفسها، حتى ثلاث مرات الرصيد الشهري. الرصيد الإضافي لا يُحسب ضمن هذا الحد. الرصيد والشحن والترحيل.

S

السر (Secret). قيمة مسماة واحدة تخص مساحة العمل، تُختم عند إدخالها، ولا تُعرض مرة أخرى، ويُشار إليها بالاسم من header الأداة. استخدمه لمفتاح API؛ أما اسم المستخدم وكلمة المرور أو رمز Bearer أو OAuth2، فاستخدم اتصال المصادقة. أسرار مساحة العمل.

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

سر التوقيع (Signing secret). القيمة التي تبدأ بـ whsec_، ويتلقاها كل Webhook جديد مرة واحدة ليتحقق خادمك من كل تسليم. تحتفظ البوابة وواجهة API بأول 12 حرفًا منها بعد ذلك فقط. تهيئة Webhook.

الملخص (Summary). الوصف القصير لمحادثة، يُكتب مرة واحدة في نهايتها حين يُنهي الوكيل المحادثة. قد تملك المحادثة نصًا كاملًا دون ملخص. النصوص والملخصات.

المتزامن وغير المتزامن (Synchronous and asynchronous). نمطا استدعاء API المطورين. الاستدعاء المتزامن يبقي الاتصال مفتوحًا ويعيد النتيجة؛ والاستدعاء غير المتزامن يعيد معرّف المهمة فورًا ويعمل في الخلفية. الاستدعاء المتزامن وغير المتزامن.

أداة النظام (System tool). واحدة من ثلاث قدرات مدمجة يملكها كل وكيل، ومغلقة حتى تفعّلها: البحث على الويب، وكشف اللهجة، وإنهاء المحادثة. تعيش في تبويب الأدوات تحت الأدوات المدمجة، ولا تُضاف ولا تُحذف أبدًا. أدوات النظام.

T

أعلى المستندات (Top documents). إعداد الاسترجاع الذي يحدد عدد المقاطع المطابقة التي يحتفظ بها الوكيل في الدور الواحد، بعد أن تتجاوز حد الصلة. كيف تعمل المعرفة.

الشحن (Top-up). شراء رصيد إضافي بزر أضف رصيداً إضافياً في صفحة الاشتراك، على خطة مدفوعة أو في الفترة التجريبية. كل شحنة دفعة مستقلة، ولا تنتهي صلاحيتها. الرصيد والشحن والترحيل.

النص المفرّغ (Transcript). ما تسجله المحادثة وهي تجري: رسالة لكل جانب من كل دور، مع الأرقام المقاسة في ذلك الدور. وفي صفحة تحويل الكلام إلى نص، هو النص الناتج من ملف صوتي. النصوص والملخصات.

الفترة التجريبية (Trial). الاشتراك الذي تبدأ به كل مساحة عمل جديدة: 60,000 credits، بلا حد زمني، وحتى دولار واحد من تكلفة نموذج الذكاء الاصطناعي. الاشتراك في خطة مدفوعة ينهيها، وينتهي الرصيد التجريبي غير المستخدم عندها. اختيار الخطة أو تغييرها.

الدور (Turn). تبادل واحد في المحادثة: يقول العميل شيئًا، ويجيب الوكيل. كل دور يحسب استخدام الذكاء الاصطناعي، وفي المكالمة يحسب الوقت المتصل منذ الدور السابق. تكلفة الدور.

المصادقة الثنائية (Two-factor authentication). تحقق ثانٍ عند كل تسجيل دخول: بعد كلمة المرور، أو بعد أن يعيدك Google أو Microsoft إلى البوابة، تُدخل الرمز المكون من 6 أرقام الذي يعرضه تطبيق المصادقة لإيكونوڤا. المصادقة الثنائية.

V

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

W

Webhook (Webhook). نقطة نهاية HTTPS تملكها، تستدعيها إيكونوڤا حين تنتهي مهمة غير متزامنة، أو حين يتجاوز مفتاح API حده الائتماني. تنشئه في البوابة، وتختار أحداثه، وتحتفظ بسر توقيعه. تهيئة Webhook.

أداة Webhook (Webhook tool). نقطة نهاية HTTP واحدة لك، توصف مرة واحدة باسم ووصف يقرؤه الوكيل ورابط ومعاملات. يستطيع الوكيل استدعاءها أثناء المحادثة، وبيانات اعتمادك مضافة إلى الطلب مسبقًا. أدوات Webhook.

ساعات العمل (Working hours). المنطقة الزمنية ونافذة الرد للوكيل، وتُضبط في تبويب الإعدادات. تسجّل متى تنوي أن يكون الوكيل متاحًا؛ ولإيقافه عن الرد، افصل قنواته أو اربطها بوكيل آخر. ساعات العمل.

مساحة العمل (Workspace). الحاوية التي يعيش فيها كل ما تبنيه: الوكلاء والمعرفة والأدوات والمحادثات وعمليات الإنشاء والنصوص المفرّغة ومفاتيح API والاشتراك. تُنشأ واحدة لك عند التسجيل، وأنت المالك. مساحات العمل.

أدوات مساحة العمل (Workspace tools). القسم في تبويب الأدوات للوكيل، الذي يعرض أدوات Webhook و OpenAPI والتكامل في مكتبة مساحة العمل، والتي يستطيع أي وكيل في مساحة العمل اختيارها. نظرة عامة على الأدوات.

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

هل الصوت أو مصدر المعرفة أو الأداة ملكي أم ملك مساحة العمل؟

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

ما الفرق بين السر واتصال المصادقة؟

السر قيمة واحدة تسمّي لها header. أما اتصال المصادقة فيعرف كيف يصادق بنفسه، وينتج دائمًا header Authorization بنفسه. اتصالات المصادقة.

ما الفرق بين رصيد الخطة والرصيد الإضافي؟

رصيد الخطة يصل كل شهر مع الخطة، ويُنفق أولًا، ويُرحَّل حتى ثلاث مرات الرصيد الشهري طالما الاشتراك فعّال. أما الرصيد الإضافي فيأتي من الشحن، ولا تنتهي صلاحيته، ولا يُنفق إلا حين لا يغطي رصيد الخطة الخصم. الرصيد والشحن والترحيل.

هل ساحة التجربة قناة؟

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