Nhập nội dung bên ngoài

Nhập nội dung từ nguồn bên ngoài vào Cơ sở kiến thức. Các endpoint này xử lý nội dung bất đồng bộ.

Xử lý bất đồng bộ

Mọi endpoint nhập đều xử lý nội dung bất đồng bộ. Sau khi gửi yêu cầu nhập, nội dung được thu thập và thêm vào Cơ sở kiến thức trong nền. Mỗi bài nhập sau đó được xử lý tự động và tự có hiệu lực, không cần kích hoạt bước huấn luyện lại.

Để theo dõi tiến độ:

1. Dùng Liệt kê bài viết để xác minh bài đã nhập xuất hiện
2. Chờ pending_embed_count về 0 trong Lấy cài đặt Cơ sở kiến thức, hoặc kiểm tra embed_state của từng bài đến khi là "embedded"

Các đợt nhập lớn có hiệu lực dần theo từng bài, không phải đồng loạt.

Thu thập trang web

Thu thập một trang hoặc toàn bộ website và nhập nội dung.

Phạm vi: write_all

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

Nội dung yêu cầu

Tham số	Mô tả
url chuỗi, bắt buộc	URL cần thu thập
mode chuỗi	"individual" (mặc định), "site_wide" hoặc "individual_with_summary"
phrases mảng chuỗi	Các cụm từ chính cần trích xuất
html_selector chuỗi	Bộ chọn CSS nhắm tới nội dung cụ thể

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()

Phản hồi 202 Accepted

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

Nhập bản chép lời YouTube

Nhập bản chép lời của video YouTube.

Phạm vi: write_all

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

Nội dung yêu cầu

Tham số	Mô tả
url chuỗi, bắt buộc	URL video YouTube
toast_process_uuid chuỗi, bắt buộc	UUID v4 để theo dõi quá trình nhập

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()),
    },
)

Phản hồi 202 Accepted: bản chép lời được xử lý bất đồng bộ.

Nhập sitemap

Nhập nội dung từ tất cả liên kết trong sitemap XML.

Phạm vi: write_all

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

Nội dung yêu cầu

Tham số	Mô tả
site_map chuỗi, bắt buộc	URL tới sitemap XML
link_filter_regex chuỗi	Biểu thức chính quy lọc liên kết cần nhập (mặc định: ".*")
html_selector chuỗi	Bộ chọn CSS nhắm tới nội dung cụ thể
summarize boolean	Có tóm tắt nội dung đã nhập hay không (mặc định: 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()

Phản hồi 202 Accepted

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

Thu thập danh sách liên kết

Nhập nội dung từ một danh sách URL cụ thể.

Phạm vi: write_all

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

Nội dung yêu cầu

Tham số	Mô tả
links mảng chuỗi, bắt buộc	Danh sách URL cần thu thập (không rỗng)
tags mảng chuỗi	Thẻ áp dụng cho bài viết nhập
html_selector chuỗi	Bộ chọn CSS nhắm tới nội dung cụ thể
summarize boolean	Có tóm tắt nội dung đã nhập hay không (mặc định: 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()

Phản hồi 202 Accepted

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

Xóa liên kết

Xóa các bài loại URL đã nhập trước đó khỏi Cơ sở kiến thức.

Phạm vi: write_all

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

Nội dung yêu cầu

Tham số	Mô tả
links mảng chuỗi, bắt buộc	Danh sách URL cần xóa (ít nhất 1)

Ghi chú

Mọi URL cung cấp phải tồn tại trong Cơ sở kiến thức dưới dạng bài loại URL. Nếu có URL không khớp bài hiện có, yêu cầu trả về 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"],
    },
)

Phản hồi 200 OK

---