Імпорт зовнішнього контенту

Імпортуйте контент із зовнішніх джерел до Бази знань. Ці ендпоїнти обробляють контент асинхронно.

Асинхронна обробка

Усі ендпоїнти імпорту обробляють контент асинхронно. Після надсилання запиту контент отримується й додається до Бази знань у фоновому режимі. Кожна імпортована стаття автоматично обробляється та починає використовуватися окремо, запускати перенавчання не потрібно.

Щоб стежити за перебігом:

1. Використовуйте Список статей, щоб перевірити появу імпортованих статей
2. Дочекайтеся, поки pending_embed_count стане 0 в Отриманні налаштувань Бази знань, або перевіряйте embed_state кожної статті, доки він не стане "embedded"

Великі імпорти стають доступними поступово, стаття за статтею, а не всі одразу.

Отримання контенту сайту

Отримайте й імпортуйте контент окремої сторінки або всього сайту.

Область доступу: write_all

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

Тіло запиту

Параметр	Опис
url string, обов’язковий	URL для отримання контенту
mode string	"individual" (за замовчуванням), "site_wide" або "individual_with_summary"
phrases array of strings	Ключові фрази для витягування
html_selector string	CSS-селектор для вибору певного контенту

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

Відповідь 202 Accepted

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

Імпорт транскрипції YouTube

Імпортуйте транскрипцію відео YouTube.

Область доступу: write_all

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

Тіло запиту

Параметр	Опис
url string, обов’язковий	URL відео YouTube
toast_process_uuid string, обов’язковий	UUID v4 для відстеження процесу імпорту

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

Відповідь 202 Accepted. Транскрипція обробляється асинхронно.

Імпорт карти сайту

Імпортуйте контент за всіма посиланнями з XML-карти сайту.

Область доступу: write_all

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

Тіло запиту

Параметр	Опис
site_map string, обов’язковий	URL XML-карти сайту
link_filter_regex string	Регулярний вираз для відбору посилань до імпорту (за замовчуванням ".*")
html_selector string	CSS-селектор для вибору певного контенту
summarize boolean	Чи підсумовувати імпортований контент (за замовчуванням 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()

Відповідь 202 Accepted

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

Отримання контенту за списком посилань

Імпортуйте контент із заданого списку URL.

Область доступу: write_all

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

Тіло запиту

Параметр	Опис
links array of strings, обов’язковий	Непорожній список URL для отримання контенту
tags array of strings	Теги для імпортованих статей
html_selector string	CSS-селектор для вибору певного контенту
summarize boolean	Чи підсумовувати імпортований контент (за замовчуванням 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()

Відповідь 202 Accepted

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

Видалення посилань

Видаліть із Бази знань раніше імпортовані статті типу URL.

Область доступу: write_all

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

Тіло запиту

Параметр	Опис
links array of strings, обов’язковий	Список URL для видалення (щонайменше 1)

Заувага

Усі надані URL мають існувати в Базі знань як статті типу URL. Якщо хоч один URL не відповідає наявній статті, запит повертає 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"],
    },
)

Відповідь 200 OK

---