Import External Content

Importuj treści ze źródeł zewnętrznych do Bazy Wiedzy. Te endpointy przetwarzają treść asynchronicznie.

Przetwarzanie asynchroniczne

Wszystkie endpointy importu przetwarzają treść asynchronicznie. Po przesłaniu żądania importu treść jest scrapowana i dodawana do Bazy Wiedzy w tle. Każdy zaimportowany artykuł jest następnie przetwarzany automatycznie i sam zaczyna działać na żywo — nie ma kroku ponownego trenowania, który trzeba by wyzwalać.

Aby monitorować postęp:

1. Użyj List Articles, aby zweryfikować, czy zaimportowane artykuły się pojawiły
2. Poczekaj, aż pending_embed_count osiągnie 0 w Get Knowledge Base Settings, lub sprawdzaj pole embed_state każdego artykułu, aż przyjmie wartość "embedded"

Duże importy zaczynają działać stopniowo, artykuł po artykule, a nie wszystkie naraz.

Scrape Website

Scrapuj pojedynczą stronę internetową lub całą witrynę i zaimportuj treść.

Zakres: write_all

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

Request Body

Parameter	Description
url string, required	URL do scrapowania
mode string	"individual" (domyślnie), "site_wide" lub "individual_with_summary"
phrases array of strings	Kluczowe frazy do wyodrębnienia
html_selector string	Selektor CSS celujący w konkretną treść

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

Response 202 Accepted

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

Import YouTube Transcript

Zaimportuj transkrypcję z filmu na YouTube.

Zakres: write_all

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

Request Body

Parameter	Description
url string, required	URL filmu na YouTube
toast_process_uuid string, required	UUID v4 do śledzenia procesu importu

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

Response 202 Accepted — Transkrypcja jest przetwarzana asynchronicznie.

Import Sitemap

Zaimportuj treść ze wszystkich linków w mapie witryny XML.

Zakres: write_all

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

Request Body

Parameter	Description
site_map string, required	URL do mapy witryny XML
link_filter_regex string	Regex filtrujący, które linki importować (domyślnie: ".*")
html_selector string	Selektor CSS celujący w konkretną treść
summarize boolean	Czy podsumowywać zaimportowaną treść (domyślnie: 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()

Response 202 Accepted

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

Scrape List of Links

Zaimportuj treść z konkretnej listy URL-i.

Zakres: write_all

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

Request Body

Parameter	Description
links array of strings, required	Lista URL-i do scrapowania (niepusta)
tags array of strings	Tagi do zastosowania dla zaimportowanych artykułów
html_selector string	Selektor CSS celujący w konkretną treść
summarize boolean	Czy podsumowywać zaimportowaną treść (domyślnie: 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()

Response 202 Accepted

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

Delete Links

Usuń wcześniej zaimportowane artykuły typu URL z Bazy Wiedzy.

Zakres: write_all

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

Request Body

Parameter	Description
links array of strings, required	Lista URL-i do usunięcia (min. 1)

Notatka

Wszystkie podane URL-e muszą istnieć w Bazie Wiedzy jako artykuły typu URL. Jeśli którykolwiek URL nie pasuje do istniejącego artykułu, żądanie zwraca 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"],
    },
)

Response 200 OK

---