Impor Konten Eksternal

Impor konten dari sumber eksternal ke Basis Pengetahuan. Endpoint ini memproses konten secara asinkron.

Pemrosesan Asinkron

Seluruh endpoint impor memproses konten secara asinkron. Setelah permintaan impor dikirim, konten diambil dan ditambahkan ke Basis Pengetahuan di latar belakang. Setiap artikel impor kemudian diproses otomatis dan aktif sendiri, tanpa perlu memicu pelatihan ulang.

Untuk memantau progres:

1. Gunakan Daftar Artikel untuk memastikan artikel impor muncul
2. Tunggu hingga pending_embed_count mencapai 0 dalam Mengambil Pengaturan Basis Pengetahuan, atau periksa embed_state setiap artikel hingga bernilai "embedded"

Impor besar aktif secara bertahap, artikel demi artikel, bukan sekaligus.

Mengambil Konten Situs Web

Ambil konten dari satu halaman atau seluruh situs web dan impor kontennya.

Cakupan: write_all

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

Isi Permintaan

Parameter	Deskripsi
url string, wajib	URL yang akan diambil kontennya
mode string	"individual" (default), "site_wide", atau "individual_with_summary"
phrases array of strings	Frasa kunci yang akan diekstrak
html_selector string	Selektor CSS untuk menargetkan konten tertentu

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

Respons 202 Accepted

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

Mengimpor Transkrip YouTube

Impor transkrip dari video YouTube.

Cakupan: write_all

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

Isi Permintaan

Parameter	Deskripsi
url string, wajib	URL video YouTube
toast_process_uuid string, wajib	UUID v4 untuk melacak proses impor

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

Respons 202 Accepted: transkrip diproses secara asinkron.

Mengimpor Sitemap

Impor konten dari seluruh tautan dalam sitemap XML.

Cakupan: write_all

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

Isi Permintaan

Parameter	Deskripsi
site_map string, wajib	URL sitemap XML
link_filter_regex string	Regex untuk memfilter tautan yang diimpor (default: ".*")
html_selector string	Selektor CSS untuk menargetkan konten tertentu
summarize boolean	Apakah konten impor perlu dirangkum (default: 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()

Respons 202 Accepted

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

Mengambil Konten Daftar Tautan

Impor konten dari daftar URL tertentu.

Cakupan: write_all

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

Isi Permintaan

Parameter	Deskripsi
links array of strings, wajib	Daftar URL yang akan diambil kontennya (tidak boleh kosong)
tags array of strings	Tag yang diterapkan pada artikel impor
html_selector string	Selektor CSS untuk menargetkan konten tertentu
summarize boolean	Apakah konten impor perlu dirangkum (default: 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()

Respons 202 Accepted

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

Menghapus Tautan

Hapus artikel berjenis URL yang sebelumnya diimpor dari Basis Pengetahuan.

Cakupan: write_all

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

Isi Permintaan

Parameter	Deskripsi
links array of strings, wajib	Daftar URL yang akan dihapus (minimal 1)

Catatan

Seluruh URL yang diberikan harus ada dalam Basis Pengetahuan sebagai artikel berjenis URL. Jika suatu URL tidak cocok dengan artikel yang ada, permintaan mengembalikan 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"],
    },
)

Respons 200 OK

---