นำเข้าเนื้อหาภายนอก

นำเข้าเนื้อหาจากแหล่งภายนอกเข้าสู่ฐานความรู้ เอนด์พอยต์เหล่านี้ประมวลผลเนื้อหาแบบอะซิงโครนัส

การประมวลผลแบบอะซิงโครนัส

เอนด์พอยต์นำเข้าทั้งหมดประมวลผลเนื้อหาแบบอะซิงโครนัส หลังส่งคำขอนำเข้า ระบบจะดึงเนื้อหาและเพิ่มลงฐานความรู้ในเบื้องหลัง จากนั้นประมวลผลแต่ละบทความโดยอัตโนมัติและทำให้พร้อมใช้งานเอง ไม่ต้องสั่งฝึกใหม่

ติดตามความคืบหน้าได้ดังนี้:

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 สตริง, จำเป็น	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 ข้อความถอดเสียงจะประมวลผลแบบอะซิงโครนัส

นำเข้า Sitemap

นำเข้าเนื้อหาจากทุกลิงก์ใน XML sitemap

ขอบเขตสิทธิ์: write_all

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

เนื้อหาคำขอ

พารามิเตอร์	คำอธิบาย
site_map สตริง, จำเป็น	URL ของ XML sitemap
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

---