استيراد المحتوى الخارجي

استورد المحتوى من مصادر خارجية إلى قاعدة المعرفة. تعالج هذه النقاط المحتوى بصورة غير متزامنة.

Async Processing

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

لمراقبة التقدم:

1. استخدم سرد المقالات للتحقق من ظهور المقالات المستوردة
2. انتظر وصول pending_embed_count إلى 0 في جلب إعدادات قاعدة المعرفة، أو تحقق من embed_state لكل مقالة حتى يصبح "embedded"

تصبح عمليات الاستيراد الكبيرة متاحة تدريجيًا، مقالةً بمقالة، وليس دفعة واحدة.

استخراج محتوى موقع

استخرج صفحة ويب واحدة أو موقعًا كاملًا واستورد المحتوى.

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

POST https://app.quickchat.ai/v1/api/knowledge_base/import_external/website

جسم الطلب

المعلمة	الوصف
url سلسلة نصية، مطلوبة	الرابط المراد استخراج محتواه
mode سلسلة نصية	"individual" (الافتراضي) أو "site_wide" أو "individual_with_summary"
phrases مصفوفة سلاسل نصية	العبارات الرئيسية المراد استخراجها
html_selector سلسلة نصية	محدد CSS لاستهداف محتوى معين

Shell

curl -X POST https://app.quickchat.ai/v1/api/knowledge_base/import_external/website \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "url": "https://example.com/docs",
  "mode": "individual"
}'

Python

import requests

response = requests.post(
    url="https://app.quickchat.ai/v1/api/knowledge_base/import_external/website",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={"url": "https://example.com/docs", "mode": "individual"},
)
data = response.json()

الاستجابة 202 Accepted

{
  "status": "success",
  "url": "https://example.com/docs",
  "article": {}
}

استيراد نص YouTube

استورد النص المفرغ من فيديو YouTube.

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

POST https://app.quickchat.ai/v1/api/knowledge_base/import_external/youtube

جسم الطلب

المعلمة	الوصف
url سلسلة نصية، مطلوبة	رابط فيديو YouTube
toast_process_uuid سلسلة نصية، مطلوبة	UUID v4 لتتبع عملية الاستيراد

Shell

curl -X POST https://app.quickchat.ai/v1/api/knowledge_base/import_external/youtube \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "toast_process_uuid": "550e8400-e29b-41d4-a716-446655440000"
}'

Python

import uuid
import requests

response = requests.post(
    url="https://app.quickchat.ai/v1/api/knowledge_base/import_external/youtube",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={
        "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
        "toast_process_uuid": str(uuid.uuid4()),
    },
)

الاستجابة 202 Accepted: يُعالج النص بصورة غير متزامنة.

استيراد خريطة موقع

استورد المحتوى من كل الروابط في خريطة موقع XML.

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

POST https://app.quickchat.ai/v1/api/knowledge_base/import_external/site-map

جسم الطلب

المعلمة	الوصف
site_map سلسلة نصية، مطلوبة	رابط خريطة موقع XML
link_filter_regex سلسلة نصية	تعبير نمطي لتصفية الروابط المراد استيرادها (الافتراضي: ".*")
html_selector سلسلة نصية	محدد CSS لاستهداف محتوى معين
summarize قيمة منطقية	هل يُلخص المحتوى المستورد (الافتراضي: false)

Shell

curl -X POST https://app.quickchat.ai/v1/api/knowledge_base/import_external/site-map \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "site_map": "https://example.com/sitemap.xml"
}'

Python

import requests

response = requests.post(
    url="https://app.quickchat.ai/v1/api/knowledge_base/import_external/site-map",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={"site_map": "https://example.com/sitemap.xml"},
)
data = response.json()

الاستجابة 202 Accepted

{
  "status": "success",
  "links": ["https://example.com/page1", "https://example.com/page2"]
}

استخراج محتوى قائمة روابط

استورد المحتوى من قائمة محددة من الروابط.

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

POST https://app.quickchat.ai/v1/api/knowledge_base/import_external/scrape-list

جسم الطلب

المعلمة	الوصف
links مصفوفة سلاسل نصية، مطلوبة	قائمة الروابط المراد استخراجها (غير فارغة)
tags مصفوفة سلاسل نصية	الوسوم المطبقة على المقالات المستوردة
html_selector سلسلة نصية	محدد CSS لاستهداف محتوى معين
summarize قيمة منطقية	هل يُلخص المحتوى المستورد (الافتراضي: false)

Shell

curl -X POST https://app.quickchat.ai/v1/api/knowledge_base/import_external/scrape-list \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "links": ["https://example.com/page1", "https://example.com/page2"],
  "tags": ["imported"]
}'

Python

import requests

response = requests.post(
    url="https://app.quickchat.ai/v1/api/knowledge_base/import_external/scrape-list",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={
        "links": ["https://example.com/page1", "https://example.com/page2"],
        "tags": ["imported"],
    },
)
data = response.json()

الاستجابة 202 Accepted

{
  "status": "success",
  "links": ["https://example.com/page1", "https://example.com/page2"]
}

حذف الروابط

أزل المقالات من نوع URL التي استُوردت سابقًا من قاعدة المعرفة.

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

DELETE https://app.quickchat.ai/v1/api/knowledge_base/import_external

جسم الطلب

المعلمة	الوصف
links مصفوفة سلاسل نصية، مطلوبة	قائمة الروابط المراد إزالتها (واحد على الأقل)

ملاحظة

يجب أن توجد كل الروابط المقدمة في قاعدة المعرفة كمقالات من نوع URL. إذا لم يطابق أي رابط مقالة موجودة، يعيد الطلب 404.

Shell

curl -X DELETE https://app.quickchat.ai/v1/api/knowledge_base/import_external \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "links": ["https://example.com/page1"]
}'

Python

import requests

response = requests.delete(
    url="https://app.quickchat.ai/v1/api/knowledge_base/import_external",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={
        "links": ["https://example.com/page1"],
    },
)

الاستجابة 200 OK

---