Import External Content

Importera innehåll från externa källor till Knowledge Base. Dessa endpoints bearbetar innehåll asynkront.

Asynkron bearbetning

Alla import-endpoints bearbetar innehåll asynkront. Efter att du skickat en importförfrågan skrapas innehållet och läggs till i Knowledge Base i bakgrunden. Knowledge Base markeras automatiskt för omträning när importen är klar.

För att följa förloppet:

1. Kontrollera retrain_state via Get Knowledge Base Settings — det ändras till "to_be_retrained", sedan "in_progress", sedan "up_to_date"
2. Använd List Articles för att verifiera att importerade artiklar dyker upp

Scrape Website

Skrapa en enskild webbsida eller en hel webbplats och importera innehållet.

Scope: write_all

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

Request Body

Parameter	Description
url string, required	URL att skrapa
mode string	"individual" (standard), "site_wide" eller "individual_with_summary"
phrases array of strings	Nyckelfraser att extrahera
html_selector string	CSS-selektor för att rikta in specifikt innehåll

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

Importera transkriptionen från en YouTube-video.

Scope: write_all

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

Request Body

Parameter	Description
url string, required	YouTube-videons URL
toast_process_uuid string, required	UUID v4 för att spåra importprocessen

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 — Transkriptionen bearbetas asynkront.

Import Sitemap

Importera innehåll från alla länkar i en XML-sitemap.

Scope: write_all

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

Request Body

Parameter	Description
site_map string, required	URL till en XML-sitemap
link_filter_regex string	Regex för att filtrera vilka länkar som importeras (standard: ".*")
html_selector string	CSS-selektor för att rikta in specifikt innehåll
summarize boolean	Om importerat innehåll ska sammanfattas (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()

Response 202 Accepted

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

Scrape List of Links

Importera innehåll från en specifik lista med URL:er.

Scope: 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 med URL:er att skrapa (får inte vara tom)
tags array of strings	Taggar att tilldela importerade artiklar
html_selector string	CSS-selektor för att rikta in specifikt innehåll
summarize boolean	Om importerat innehåll ska sammanfattas (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()

Response 202 Accepted

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

Delete Links

Ta bort tidigare importerade URL-artiklar från Knowledge Base.

Scope: write_all

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

Request Body

Parameter	Description
links array of strings, required	Lista med URL:er att ta bort (minst 1)

Note

Alla angivna URL:er måste finnas i Knowledge Base som URL-artiklar. Om någon URL inte matchar en befintlig artikel returnerar requesten 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

---