Import External Content

Importieren Sie Inhalte aus externen Quellen in die Wissensdatenbank. Diese Endpunkte verarbeiten Inhalte asynchron.

Asynchrone Verarbeitung

Alle Import-Endpunkte verarbeiten Inhalte asynchron. Nach dem Absenden einer Import-Anfrage wird der Inhalt im Hintergrund gescrapt und zur Wissensdatenbank hinzugefügt. Jeder importierte Artikel wird anschließend automatisch verarbeitet und geht von selbst live — es gibt keinen Retraining-Schritt, den Sie auslösen müssten.

So verfolgen Sie den Fortschritt:

1. Verwenden Sie List Articles, um zu überprüfen, ob die importierten Artikel erscheinen
2. Warten Sie, bis pending_embed_count in Get Knowledge Base Settings den Wert 0 erreicht, oder prüfen Sie das embed_state jedes Artikels, bis es "embedded" lautet

Große Importe gehen nach und nach live, Artikel für Artikel, statt alle auf einmal.

Scrape Website

Eine einzelne Webseite oder eine gesamte Website scrapen und den Inhalt importieren.

Berechtigungsumfang: write_all

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

Request-Body

Parameter	Description
url string, required	Zu scrapende URL
mode string	"individual" (Standard), "site_wide" oder "individual_with_summary"
phrases array of strings	Zu extrahierende Schlüsselphrasen
html_selector string	CSS-Selektor, um bestimmte Inhalte anzusprechen

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

Antwort 202 Accepted

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

Import YouTube Transcript

Das Transkript eines YouTube-Videos importieren.

Berechtigungsumfang: write_all

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

Request-Body

Parameter	Description
url string, required	YouTube-Video-URL
toast_process_uuid string, required	UUID v4 zur Nachverfolgung des Importvorgangs

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

Antwort 202 Accepted — Das Transkript wird asynchron verarbeitet.

Import Sitemap

Inhalte von allen Links in einer XML-Sitemap importieren.

Berechtigungsumfang: write_all

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

Request-Body

Parameter	Description
site_map string, required	URL einer XML-Sitemap
link_filter_regex string	Regex zum Filtern der zu importierenden Links (Standard: ".*")
html_selector string	CSS-Selektor, um bestimmte Inhalte anzusprechen
summarize boolean	Ob importierte Inhalte zusammengefasst werden sollen (Standard: 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()

Antwort 202 Accepted

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

Scrape List of Links

Inhalte aus einer bestimmten Liste von URLs importieren.

Berechtigungsumfang: write_all

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

Request-Body

Parameter	Description
links array of strings, required	Liste der zu scrapenden URLs (nicht leer)
tags array of strings	Tags, die importierten Artikeln zugewiesen werden
html_selector string	CSS-Selektor, um bestimmte Inhalte anzusprechen
summarize boolean	Ob importierte Inhalte zusammengefasst werden sollen (Standard: 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()

Antwort 202 Accepted

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

Delete Links

Zuvor importierte Artikel vom Typ URL aus der Wissensdatenbank entfernen.

Berechtigungsumfang: write_all

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

Request-Body

Parameter	Description
links array of strings, required	Liste der zu entfernenden URLs (min. 1)

Hinweis

Alle angegebenen URLs müssen in der Wissensdatenbank als Artikel vom Typ URL vorhanden sein. Wenn eine URL keinem bestehenden Artikel entspricht, gibt die Anfrage 404 zurück.

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"],
    },
)

Antwort 200 OK

---