匯入外部內容

將外部來源的內容匯入知識庫。這些端點以非同步方式處理內容。

非同步處理

所有匯入端點皆以非同步方式處理內容。提交匯入請求後，系統會在背景擷取內容並加入知識庫。之後，每篇匯入文章都會自動處理並各自上線，不需觸發重新訓練。

若要監控進度：

1. 使用列出文章確認匯入的文章已出現
2. 等待取得知識庫設定中的 pending_embed_count 變成 0，或逐篇檢查 embed_state，直到值為 "embedded"

大量匯入會逐篇上線，而不是一次全部生效。

擷取網站

擷取單一網頁或整個網站並匯入內容。

權限範圍：write_all

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

請求本文

參數	說明
url 字串，必填	要擷取的 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 影片 URL
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：逐字稿會以非同步方式處理。

匯入 Sitemap

從 XML sitemap 中的所有連結匯入內容。

權限範圍：write_all

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

請求本文

參數	說明
site_map 字串，必填	XML sitemap 的 URL
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"]
}

擷取連結清單

從指定 URL 清單匯入內容。

權限範圍：write_all

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

請求本文

參數	說明
links 字串陣列，必填	要擷取的 URL 清單（不可為空）
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 清單（至少 1 個）

注意

所有提供的 URL 都必須已作為 URL 類型文章存在於知識庫。若有任何 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

---