Externe inhoud importeren

Importeer inhoud uit externe bronnen in de Kennisbank. Deze endpoints verwerken inhoud asynchroon.

Asynchrone verwerking

Alle importendpoints verwerken inhoud asynchroon. Nadat je een importaanvraag hebt ingediend, wordt de inhoud op de achtergrond opgehaald en aan de Kennisbank toegevoegd. Elk geïmporteerd artikel wordt vervolgens automatisch verwerkt en afzonderlijk beschikbaar. Je hoeft geen hertraining te starten.

Om de voortgang te volgen:

1. Gebruik Artikelen opvragen om te controleren of geïmporteerde artikelen verschijnen
2. Wacht totdat pending_embed_count gelijk is aan 0 in Kennisbank-instellingen ophalen, of controleer embed_state per artikel totdat de waarde "embedded" is

Grote imports worden geleidelijk beschikbaar, artikel voor artikel, in plaats van allemaal tegelijk.

Website scrapen

Haal een afzonderlijke webpagina of een volledige website op en importeer de inhoud.

Bereik: write_all

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

Requestbody

Parameter	Beschrijving
url string, verplicht	URL om op te halen
mode string	"individual" (standaard), "site_wide" of "individual_with_summary"
phrases array van strings	Kernzinnen om te extraheren
html_selector string	CSS-selector om specifieke inhoud te selecteren

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

Antwoord 202 Accepted

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

YouTube-transcript importeren

Importeer het transcript van een YouTube-video.

Bereik: write_all

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

Requestbody

Parameter	Beschrijving
url string, verplicht	URL van de YouTube-video
toast_process_uuid string, verplicht	UUID v4 om het importproces te volgen

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

Antwoord 202 Accepted: het transcript wordt asynchroon verwerkt.

Sitemap importeren

Importeer inhoud van alle links in een XML-sitemap.

Bereik: write_all

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

Requestbody

Parameter	Beschrijving
site_map string, verplicht	URL naar een XML-sitemap
link_filter_regex string	Reguliere expressie om te filteren welke links worden geïmporteerd (standaard: ".*")
html_selector string	CSS-selector om specifieke inhoud te selecteren
summarize boolean	Of geïmporteerde inhoud moet worden samengevat (standaard: 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()

Antwoord 202 Accepted

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

Lijst met links scrapen

Importeer inhoud van een specifieke lijst URL’s.

Bereik: write_all

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

Requestbody

Parameter	Beschrijving
links array van strings, verplicht	Lijst met op te halen URL’s (niet leeg)
tags array van strings	Tags om aan geïmporteerde artikelen toe te voegen
html_selector string	CSS-selector om specifieke inhoud te selecteren
summarize boolean	Of geïmporteerde inhoud moet worden samengevat (standaard: 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()

Antwoord 202 Accepted

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

Links verwijderen

Verwijder eerder geïmporteerde artikelen van het type URL uit de Kennisbank.

Bereik: write_all

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

Requestbody

Parameter	Beschrijving
links array van strings, verplicht	Lijst met te verwijderen URL’s (minimaal 1)

Opmerking

Alle opgegeven URL’s moeten als artikelen van het type URL in de Kennisbank bestaan. Als een URL niet met een bestaand artikel overeenkomt, retourneert de aanvraag 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"],
    },
)

Antwoord 200 OK

---