Dış içerik içe aktarma

Harici kaynaklardan Bilgi Tabanına içerik aktarın. Bu uç noktalar içeriği eşzamansız işler.

Async Processing

Tüm içe aktarma uç noktaları içeriği eşzamansız işler. İçe aktarma isteğini gönderdikten sonra içerik arka planda taranır ve Bilgi Tabanına eklenir. Ardından içe aktarılan her makale otomatik işlenir ve bağımsız olarak yayına girer. Tetiklemeniz gereken bir yeniden eğitim adımı yoktur.

İlerlemeyi izlemek için:

1. İçe aktarılan makalelerin göründüğünü doğrulamak için Makaleleri listeleme işlemini kullanın
2. Bilgi Tabanı ayarlarını alma işleminde pending_embed_count değerinin 0 olmasını bekleyin veya her makalenin embed_state alanını "embedded" olana kadar kontrol edin

Büyük içe aktarımlar tek seferde değil, makale makale kademeli olarak yayına girer.

Web sitesi tarama

Tek bir web sayfasını veya tüm web sitesini tarayın ve içeriği aktarın.

Kapsam: write_all

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

İstek gövdesi

Parametre	Açıklama
url dize, zorunlu	Taranacak URL
mode dize	"individual" (varsayılan), "site_wide" veya "individual_with_summary"
phrases dize dizisi	Çıkarılacak anahtar ifadeler
html_selector dize	Belirli içeriği hedefleyen CSS seçicisi

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

Yanıt 202 Accepted

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

YouTube transkriptini içe aktarma

Bir YouTube videosunun transkriptini içe aktarın.

Kapsam: write_all

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

İstek gövdesi

Parametre	Açıklama
url dize, zorunlu	YouTube videosunun URL’si
toast_process_uuid dize, zorunlu	İçe aktarma işlemini izleyen 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()),
    },
)

Yanıt 202 Accepted: transkript eşzamansız işlenir.

Site haritasını içe aktarma

XML site haritasındaki tüm bağlantılardan içerik aktarın.

Kapsam: write_all

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

İstek gövdesi

Parametre	Açıklama
site_map dize, zorunlu	XML site haritasının URL’si
link_filter_regex dize	İçe aktarılacak bağlantıları filtreleyen düzenli ifade (varsayılan: ".*")
html_selector dize	Belirli içeriği hedefleyen CSS seçicisi
summarize mantıksal değer	Aktarılan içeriğin özetlenip özetlenmeyeceği (varsayılan: 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()

Yanıt 202 Accepted

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

Bağlantı listesi tarama

Belirli bir URL listesinden içerik aktarın.

Kapsam: write_all

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

İstek gövdesi

Parametre	Açıklama
links dize dizisi, zorunlu	Taranacak URL listesi (boş olamaz)
tags dize dizisi	İçe aktarılan makalelere uygulanacak etiketler
html_selector dize	Belirli içeriği hedefleyen CSS seçicisi
summarize mantıksal değer	Aktarılan içeriğin özetlenip özetlenmeyeceği (varsayılan: 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()

Yanıt 202 Accepted

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

Bağlantıları silme

Daha önce içe aktarılan URL türündeki makaleleri Bilgi Tabanından kaldırın.

Kapsam: write_all

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

İstek gövdesi

Parametre	Açıklama
links dize dizisi, zorunlu	Kaldırılacak URL listesi (en az 1)

Not

Sağlanan tüm URL’ler Bilgi Tabanında URL türündeki makaleler olarak mevcut olmalıdır. Herhangi bir URL mevcut bir makaleyle eşleşmezse istek 404 döndürür.

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

Yanıt 200 OK

---