المساعدة

الأسئلة الشائعة: الوكلاء

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

ما الوكيل، وهل يكلّف شيئًا وهو خامل؟

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

كيف أُنشئ وكيلًا؟

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

أي اسم يسمعه المتصل؟

الاسم المكتوب داخل نص الشخصية في تبويب الشخصية. وحقل الاسم هو الاسم الاحتياطي الذي يستخدمه الوكيل حين لا يذكر الـ prompt أحدًا، والوصف للزملاء فقط ولا يسمعه المتصل أبدًا. اكتب الاسم داخل النص، كما في: «أنت سارة، موظفة الدعم في Acme». انظر اكتب الشخصية.

هل أستطيع أن أعطي كل قناة prompt خاصًا بها؟

لا. للوكيل شخصية واحدة، وكل قناة مربوطة به تأخذها. لكن محادثة Zendesk أو Zoho Desk أو Intercom أو Genesys Cloud تضيف ملاحظة قصيرة عن النبرة وإشارة التحويل، أما بقية النص فهو نصك كما كتبته. شغّل وكيلًا ثانيًا عندما تحتاج قناة إلى صياغة مختلفة. انظر كيف يُجمَّع prompt الوكيل.

كيف أضبط اللغة التي يرد بها الوكيل؟

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

لماذا يتجاهل الوكيل مستندًا أرفقته؟

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

هل أضع المادة المرجعية في prompt أم في المعرفة؟

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

أي نوع من الأدوات أحتاج إليه؟

  • نقطة نهاية واحدة من عندك، بعدد قليل من المعاملات: أداة Webhook.
  • API كامل فيه عمليات كثيرة: أداة OpenAPI، تستورد مستندها مرة واحدة.
  • إجابات من بياناتك: اربط قاعدة بيانات واعتمِد الأسئلة التي يحق لها الإجابة عنها.
  • إجراء داخل منتج ربطته من قبل، مثل حدث في التقويم: أداة تكامل من ذلك الاتصال.
  • البحث عن معلومة على الإنترنت، أو التكيّف مع لهجة المتصل، أو إنهاء المحادثة: أداة مدمجة، موجودة في كل وكيل ومعطّلة حتى تفعّلها.

تقارن نظرة عامة على الأدوات بين الأنواع.

لماذا لا تعمل أداتي أبدًا؟

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

كيف يعرف نقطة النهاية أن الاستدعاء جاء من إيكونوڤا؟

من الاعتماد الذي ترفقه وحده. الطلبات إلى أداة Webhook أو إلى API مستورد لا تحمل توقيعًا من إيكونوڤا، ولا أي شيء يعرّف المحادثة، فعامل نقطة النهاية كأنها متاحة للعموم: اطلب اتصال مصادقة أو معامل header سري، وارفض كل استدعاء لا يحمله. انظر أدوات Webhook.

أين أحفظ مفتاح API أو كلمة المرور التي تحتاجها أداة؟

تحت الإعدادات في تنقل الوكلاء، لا في الشخصية ولا في وصف أداة أبدًا. السر في مساحة العمل قيمة واحدة تصبح header تسميه أنت، لمفتاح API مثلًا. أما اتصال المصادقة فهو بيانات اعتماد كاملة بطريقتها، من طرق basic أو Bearer أو OAuth2، ويُنتج دائمًا header باسم Authorization بنفسه. والجزء السري من أيّ منهما لا يُعرض مرة أخرى بعد الحفظ، لذا سمِّه باسم النظام والبيئة التي ينتمي إليها.

هل يستطيع الوكيل الكتابة إلى قاعدة بياناتي؟

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

هل يكلّف اختبار الوكيل في ساحة التجربة أرصدة؟

نعم، بالأسعار نفسها التي تُحتسب على محادثة العميل، لكل دور، ولا يوجد وضع اختبار. وتكلّف مكالمة أكثر من محادثة بالطول نفسه، لأن المكالمة تدفع أيضًا 2,500 credits عن كل دقيقة تبقى متصلة. وكل جلسة في ساحة التجربة تُسجَّل في تبويب المحادثات لدى الوكيل، وتُحسب في تحليلاته كأي محادثة أخرى. انظر اختبر وكيلك.

ما الذي يُحتسب عليّ في المحادثة؟

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

هل يؤثر تغيير إعداد في محادثة جارية؟

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

أين أقرأ ما قاله الوكيل وما كلّفه؟

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

هل يوقف الإيقاف المؤقت قنوات الوكيل؟

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

هل تمنع ساعات العمل الوكيل من الرد خارج النافذة؟

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

كم تُحفظ البيانات، وهل أستطيع حذف محادثة؟

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