قاعدة المعرفة

قاعدة المعرفة هي أساس خبرة وكيل AI؛ فهي تحتوي كل المعلومات التي يستخدمها AI للإجابة عن الأسئلة. تتيح هذه النقاط إدارة إعداد قاعدة المعرفة وتتبع حالة معالجة محتواها.

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

جلب الإعدادات

اجلب إعداد قاعدة معرفتك.

نطاق الصلاحيات: read_all

GET https://app.quickchat.ai/v1/api/knowledge_base/

Shell

curl https://app.quickchat.ai/v1/api/knowledge_base/ \
  -H 'Authorization: Bearer <API_TOKEN>'

Python

import requests

response = requests.get(
    url="https://app.quickchat.ai/v1/api/knowledge_base/",
    headers={"Authorization": "Bearer <API_TOKEN>"},
)
data = response.json()

الاستجابة 200 OK

{
  "one_word_description": "Support Agent",
  "short_description": "A helpful customer support assistant.",
  "ai_commands": ["Be polite", "Stay on topic"],
  "pending_embed_count": 0,
  "failed_embed_count": 0
}

الحقل	الوصف
one_word_description سلسلة نصية	اسم وكيل AI. لوحة التحكم: الهوية > شخصية AI > الاسم
short_description سلسلة نصية	تعليمات النظام / التعليمات الرئيسية. لوحة التحكم: الهوية > شخصية AI > التعليمات الرئيسية
ai_commands مصفوفة سلاسل نصية	إرشادات السلوك، إرشاد واحد لكل عنصر. لوحة التحكم: الهوية > شخصية AI > الإرشادات. حتى 250 عنصرًا و5,000 حرف لكل عنصر و10,000 حرف عبر كل العناصر.
pending_embed_count عدد صحيح	المقالات التي لا تزال قيد المعالجة. تعني 0 أن كل ما قدمته أصبح متاحًا
failed_embed_count عدد صحيح	المقالات التي فشلت معالجتها. أعد المحاولة عبر إعادة محاولة المقالات الفاشلة

Waiting for content to go live

استطلع هذه النقطة بعد الكتابة وانتظر وصول pending_embed_count إلى 0. تتوفر حالة كل مقالة أيضًا في حقل embed_state في المقالات.

ملاحظة

الحقول الثلاثة (one_word_description وshort_description وai_commands) مشتركة مع إعدادات روبوت الدردشة. التحديث عبر أي من النقطتين يعدل البيانات الأساسية نفسها.

تحديث الإعدادات

نطاق الصلاحيات: write_all

PATCH https://app.quickchat.ai/v1/api/knowledge_base/

جسم الطلب

المعلمة	الوصف
one_word_description سلسلة نصية	اسم وكيل AI
short_description سلسلة نصية	تعليمات النظام / وصف وكيل AI. تقبل API حتى 25,000 حرف في كل خطة؛ ويحد محرر التطبيق النص بسقف خطتك الذي يبدأ من 15,000. تعيد القيمة المتجاوزة 422.
ai_commands مصفوفة سلاسل نصية	إرشادات AI، إرشاد واحد لكل عنصر. حتى 250 عنصرًا و5,000 حرف لكل عنصر و10,000 حرف عبر كل العناصر. تعيد القيمة المتجاوزة 422.

How guidelines are stored

كل عنصر في المصفوفة إرشاد واحد يُحفظ كما ترسله تمامًا. تُحفظ علامات الترقيم بما فيها الفواصل المنقوطة. كان الإرشاد الذي يتضمن ; يعود كإرشادين منفصلين؛ إذا كنت تتجنبها للتحايل على ذلك، لم تعد بحاجة إلى هذا.

كانت هذه النقطة تقبل إرشادات بأي طول. تُطبق الحدود أعلاه الآن هنا أيضًا وتطابق إعدادات روبوت الدردشة تمامًا.

احذف ai_commands أو أرسل null لترك الإرشادات كما هي. أرسل [] لمسحها.

Shell

curl -X PATCH https://app.quickchat.ai/v1/api/knowledge_base/ \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "one_word_description": "Sales Bot"
}'

Python

import requests

response = requests.patch(
    url="https://app.quickchat.ai/v1/api/knowledge_base/",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={"one_word_description": "Sales Bot"},
)
data = response.json()

الاستجابة 200 OK: تعيد إعدادات قاعدة المعرفة المحدّثة (المخطط نفسه كما في جلب الإعدادات).

إعادة محاولة المقالات الفاشلة

أعد معالجة كل مقالة فشلت معالجتها. تُترك المقالات المتاحة أو التي لا تزال قيد المعالجة دون تغيير، ويمكن تكرار الاستدعاء بأمان.

تُعاد محاولة المقالات الفاشلة تلقائيًا أيضًا، لذا لا تحتاج هذه النقطة إلا إذا لم ترد انتظار ذلك.

نطاق الصلاحيات: write_all

POST https://app.quickchat.ai/v1/api/knowledge_base/retry_failed_embeds

Shell

curl -X POST https://app.quickchat.ai/v1/api/knowledge_base/retry_failed_embeds \
  -H 'Authorization: Bearer <API_TOKEN>'

Python

import requests

response = requests.post(
    url="https://app.quickchat.ai/v1/api/knowledge_base/retry_failed_embeds",
    headers={"Authorization": "Bearer <API_TOKEN>"},
)

الاستجابة 200 OK

{
  "retried": 2
}

الحقل	الوصف
retried عدد صحيح	عدد المقالات الفاشلة التي أُدرجت في طابور إعادة المعالجة

إعادة تدريب قاعدة المعرفة مهمل

POST https://app.quickchat.ai/v1/api/knowledge_base/retrain/

لم تعد إعادة التدريب موجودة؛ تُعالج تغييرات المقالات تلقائيًا. تُحتفظ بهذه النقطة فقط لاستمرار التكاملات الحالية: تقبل الطلب ولا تنفذ شيئًا وتعيد 200 OK.

يمكنك إزالة الاستدعاء من تكاملك. إذا كنت تستطلع حتى انتهاء إعادة التدريب، فانتظر بدلًا من ذلك وصول pending_embed_count إلى 0 في جلب الإعدادات.

---