ייבוא תוכן חיצוני

ייבאו תוכן ממקורות חיצוניים למאגר הידע. נקודות הקצה מעבדות את התוכן באופן אסינכרוני.

עיבוד אסינכרוני

כל נקודות קצה הייבוא מעבדות תוכן אסינכרונית. לאחר הגשת הבקשה, התוכן נאסף ומתווסף למאגר ברקע. כל מאמר מעובד אוטומטית והופך לזמין בנפרד, ללא שלב אימון מחדש שיש להפעיל.

למעקב אחר ההתקדמות:

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 מערך מחרוזות, חובה	רשימת כתובות להסרה (לפחות אחת)

Note

כל הכתובות חייבות להיות קיימות במאגר כמאמרי 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

---