ملاحظة: لا توجد واجهة عربية لهذه الميزة بعد، فواجهة المنصّة كلها تظهر بالإنجليزية. لذلك تُنقَل النصوص المقتبَسة من الواجهة أدناه بالإنجليزية كما تظهر فعليًا، بدل أن تُترجَم أو تُختلَق بالعربية.
التعليمات تخبر الوكيل كيف يتصرف. وقاعدة المعرفة تخبره بما هو صحيح — جدولك، ورسومك، وسياساتك. حين يسأل أحد الأهالي Maple Street Tutoring “كم رسوم حصة الرياضيات للصف التاسع؟”، يجب أن تأتي الإجابة من صفحة كتبتها أنت، لا من خيال النموذج.
لكل وكيل قاعدة معرفة خاصة به، وهي تخدم كل قناة يجيب عليها ذلك الوكيل: الهاتف، وWhatsApp، ودردشة موقعك، والبريد الإلكتروني. املأها مرة واحدة.
أين توجد
افتح الوكيل من /agents واختر تبويب Knowledge. الصفحة نفسها موجودة في /agents/knowledge — ومن دون اختيار وكيل تطلب منك “Select an agent to manage its knowledge base.”
في الأعلى Add document وAdd website، وتحتهما منطقة لإفلات الملفات. وتحت ذلك ثلاث بطاقات:
| البطاقة | ما فيها |
|---|---|
| Sources | كل موقع أو ملف أو مجموعة ملاحظات ملصقة أضفتها، مع حالتها، وعدد المستندات التي أنتجتها، وكم منها عليه علامة، ومتى زُحف إليها |
| All documents | كل مستند يستطيع الوكيل الإجابة منه. انقر مصدرًا لتضييق القائمة إلى Documents in source؛ وانقره مرة أخرى لترى كل شيء |
| Knowledge gaps | صفحات وملفات تعذّرت قراءتها، تنتظر أن تلصق محتواها |
أضف موقعك الإلكتروني
يفتح Add website نافذة فيها حقل واحد، Website URL، وزر Discover. ما تكتبه يحدّد ما يحدث:
- نطاق وحده —
maplestreettutoring.example— يقرأ خريطة الموقع (sitemap) ويسرد كل صفحة يجدها، مجمّعة حسب القسم: classes، fees، blog… الأقسام التي تبدو مفيدة للإجابة عن الأسئلة تأتي محدَّدة لك؛ والباقي لا. - صفحة واحدة —
maplestreettutoring.example/fees— يسرد تلك الصفحة وحدها، محدَّدة.
ألغِ تحديد ما لا يحتاجه الوكيل — مقالات المدونة القديمة، والأخبار، وصفحات الوسوم — أو استخدم Select all / Deselect all. والصفحات التي فاتت خريطة الموقع توضع في Add more URLs (one per line). الزر في الأسفل يعدّ اختيارك، Crawl 12 pages، ويبدأ الزحف. اختر 500 صفحة على الأكثر في كل زحف؛ ولموقع أكبر، ازحف إليه على أجزاء.
إن رأيت “No pages were discovered for that URL. Try a different address.”، فليس للموقع خريطة تُقرأ. أدخل الصفحات التي تريدها واحدة تلو الأخرى، بعناوين URL كاملة.
يجري الزحف في الخلفية: يعرض المصدر مؤشر تحميل، ثم Ready. أو اطلب من Octo — “ازحف إلى maplestreettutoring.example لوكيل الدروس” — فتسرد صفحاتك مرتّبة حسب فائدتها المرجّحة، قسمًا قسمًا، لتختار منها.
ارفع ملفاتك
اسحب الملفات إلى منطقة الإفلات — “Drag & drop files here, or” — أو انقر Browse files. يمكنك إضافة عدة ملفات دفعة واحدة؛ يظهر لكل منها علامة صح حين يكتمل رفعه، وتستمر قراءته في الخلفية. الصيغ المقبولة:
PDF, DOCX, PPTX, XLSX, ODT, ODP, ODS, RTF, HTML, CSV, TSV, TXT, MD, JSON, YAML, TOML, SRT, VTT
يرفع Maple Street جدول الفصل الدراسي بصيغة PDF. يحمل مصدر الملف اسم الملف؛ افتح أحد مستنداته ويعيده لك Download original.
الصق ما لا يوجد إلا في رأسك
بعض الأشياء غير مكتوبة في أي مكان: أيام الإغلاق في العطل، وما يحدث حين يتغيّب طفل عن حصة، وأين يركن الأهالي سياراتهم. يأخذ Add document حقلَي Title وContent (Markdown) ويضيف المستند فورًا. وتُجمع كل الملاحظات الملصقة تحت مصدر واحد، Pasted notes.
إن كان النص نفسه موجودًا في قاعدة المعرفة، فلا يُضاف مرتين: “That content is already in your knowledge base as “Refund policy”. No new document added.”
اكتبها بحيث يمكن العثور عليها
يشرح مربع المحتوى كيف يقرأ الوكيل ما تعطيه:
Write or paste markdown. Use # headings to split the doc into searchable sections — each heading becomes a separate chunk the agent can cite.
يبحث الوكيل عن القسم الذي يطابق السؤال، فأعطِ كل موضوع عنوانه الخاص وأبقِ موضوعًا واحدًا تحت كل عنوان:
# الحصص الفائتة
حصة تعويضية واحدة لكل فصل دراسي. أخبرنا قبل الخامسة مساءً من اليوم السابق.
# الإغلاق في العطل
مغلق خلال أسبوعي عطلة منتصف العام الدراسي.
وليّ الأمر الذي يسأل عن حصة فائتة يجد الحصص الفائتة، لا صفحة طويلة تذكرها في مكان ما في منتصفها. ضع المعلومة أولًا، بكلمات بسيطة.
ويعرض اجعل الذكاء الاصطناعي يجيب البريد من موقعك الإلكتروني ومن مستنداتك جانب البريد الإلكتروني: كل مسودة تسمّي المستندات التي استندت إليها.
أبقِها دقيقة
انقر أي مستند لتفتحه. تُظهر المعاينة مصدره — عنوان صفحة، أو “from: timetable.pdf”، أو Manual note — وحجمه بالرموز (tokens) وأي علامات عليه. يغيّر Edit العنوان والنص؛ ويحتفظ Save بالتغيير.
انتبه للعلامات على المستند:
| العلامة | ماذا تعني | ماذا تفعل |
|---|---|---|
| Low content | لم يخرج منه نص تقريبًا — غالبًا صفحة ترسم نفسها بـ JavaScript، أو ملف PDF ممسوح ضوئيًا | افتح المستند، ثم Edit، والصق النص الحقيقي؛ أو أضفه عبر Add document |
| Garbled | يُقرأ كأنه كود أو بيانات لا جُمل | اختصره بـ Edit إلى النص المفيد، أو احذفه والصق نسخة نظيفة |
| Truncated at 3M chars | النص الذي تجاوز الحد لم يُحفظ | قسّم الملف إلى مستندات أصغر وارفعها |
المصدر الذي فيه مستندات عليها علامات يقول ذلك — “2 flagged” — فتجدها دون أن تفتح كل صفحة.
حين يتغيّر موقعك، حدّثه. في قائمة More options لمصدر الموقع يوجد Re-crawl — “This will re-index all pages from this source. It may take a few minutes.” — ولكل مستند زُحف إليه Re-crawl خاص به لصفحة واحدة. إعادة الزحف تستبدل تلك المستندات بما هو على الموقع الآن، فغيّر الموقع أولًا؛ والمعلومة التي تخص الوكيل وحده توضع في مستند خاص بها عبر Add document.
يزيل Delete source مصدرًا وكل مستنداته؛ ويزيل Delete على مستند ذلك المستند وحده. ولا يمكن التراجع عن أيّ منهما.
املأ فجوات المعرفة
يسرد Knowledge gaps كل صفحة أو ملف لم يستطع الزحف أو الرفع قراءته، موسومًا بـ Web page أو File، وتحته جملة تقول السبب — “The page could not be reached.” أو “The file has no text layer — it looks like a scanned image.” والحل واحد للجميع: افتح الصفحة بنفسك، وانسخ النص، وانقر Paste content. يأتي العنوان معبّأً بعنوان الصفحة أو اسم الملف؛ أضف النص وانقر Add. تُغلق الفجوة ويصبح المحتوى مستندًا.
وإن كانت الصفحة غير مهمة، فإن × — “Dismiss — remove this reminder” — يزيلها. وحين لا يبقى شيء، يظهر في القسم “No open gaps. Every page and file added to this knowledge base could be read.”
قاعدة معرفة كبيرة
حين تكبر قاعدة المعرفة أكثر مما يستطيع الوكيل قراءته دفعة واحدة، تعرض قائمة المستندات:
Large knowledge base (~180,000 tokens). The full KB won’t fit in the agent’s context, so it answers by searching for relevant passages per question rather than seeing everything at once. This affects voice agents more than text because search introduces more obvious delays in voice interaction.
أي أن قاعدة المعرفة الأصغر تُقرأ كاملة في كل محادثة، والأكبر يُبحث فيها عند كل سؤال. والبحث هو الغرض من العناوين. لوكيل الهاتف، اقصر قاعدة المعرفة على ما يسأل عنه المتصلون فعلًا — فالصفحات التي تلغي تحديدها هي التي لم يعد مضطرًا للبحث فيها.
إجابات يقدّمها فريقك في المكالمات الصادرة
في حملة صوتية صادرة، يستطيع الوكيل أن يطرح سؤالًا على فريقك أثناء المكالمة ويحتفظ بالإجابة. فعّل ذلك في Advanced settings للحملة، تحت OPERATOR INPUT GATHERING: حدّد Enable operator input gathering، ثم اختر أين تذهب الإجابات تحت “When the operator answers, save the answer to:” — Campaign FAQ only (default)، أو قاعدة معرفة الوكيل.
في صفحة الحملة، تنتظر الأسئلة تحت Needs Input. اكتب الإجابة وأرسلها؛ ويحدّد Save to agent KB (all campaigns) هل تذهب أيضًا إلى قاعدة معرفة الوكيل. تُجمع الإجابات في عمود FAQ، ولكل منها Push to KB لإضافتها لاحقًا. وحين تصبح هناك يصير الزر Pushed to KB ✓؛ انقره مرة أخرى لـ Remove from KB.
في تبويب Knowledge تعرض هذه المستندات “From” واسم الحملة، والنقر على أحدها يفتح الحملة. وانقر سؤالًا مدفوعًا في FAQ لتنتقل في الاتجاه الآخر — تُفتح قاعدة المعرفة وذلك المُدخل مُبرز.
اطلب من Octo
تستطيع Octo فعل كل هذا في الدردشة: سرد مصادر الوكيل، ومراجعة المستندات التي عليها علامات والفجوات المفتوحة، وإضافة ملاحظات، وتعديل مستند، وإعادة الزحف إلى موقع بعد أن تؤكد — “ما الذي يحتاج إلى إصلاح في قاعدة معرفة وكيل الدروس؟”، “تغيّرت صفحة الرسوم عندنا هذا الصباح — أعد الزحف إليها.”
التالي
اختبره قبل أن يفعل عملاؤك — اطرح الأسئلة التي يطرحها الأهالي وطابق كل إجابة مع مستنداتك. وما يجب أن يفعله الوكيل، لا ما يعرفه، مكانه تعليماته.