Importare contenuti esterni

Importa contenuti da fonti esterne nella base di conoscenza. Questi endpoint elaborano i contenuti in modo asincrono.

Elaborazione asincrona

Tutti gli endpoint di importazione elaborano i contenuti in modo asincrono. Dopo l’invio di una richiesta di importazione, i contenuti vengono estratti e aggiunti alla base di conoscenza in background. Ogni articolo importato viene quindi elaborato automaticamente e reso disponibile in modo autonomo: non occorre avviare un riaddestramento.

Per monitorare l’avanzamento:

1. Usa Elencare gli articoli per verificare che compaiano gli articoli importati
2. Attendi che pending_embed_count raggiunga 0 in Recuperare le impostazioni della base di conoscenza, oppure verifica embed_state di ciascun articolo finché non diventa "embedded"

Le importazioni grandi diventano disponibili gradualmente, articolo per articolo, anziché tutte insieme.

Estrarre un sito web

Estrai una singola pagina o un intero sito web e importa i contenuti.

Ambito: write_all

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

Corpo della richiesta

Parametro	Descrizione
url stringa, obbligatorio	URL da cui estrarre i contenuti
mode stringa	"individual" (predefinito), "site_wide" o "individual_with_summary"
phrases array di stringhe	Frasi chiave da estrarre
html_selector stringa	Selettore CSS per individuare contenuti specifici

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

Risposta 202 Accepted

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

Importare una trascrizione YouTube

Importa la trascrizione di un video YouTube.

Ambito: write_all

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

Corpo della richiesta

Parametro	Descrizione
url stringa, obbligatorio	URL del video YouTube
toast_process_uuid stringa, obbligatorio	UUID v4 per monitorare il processo di importazione

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

Risposta 202 Accepted: la trascrizione viene elaborata in modo asincrono.

Importare una sitemap

Importa i contenuti di tutti i link in una sitemap XML.

Ambito: write_all

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

Corpo della richiesta

Parametro	Descrizione
site_map stringa, obbligatorio	URL di una sitemap XML
link_filter_regex stringa	Espressione regolare per filtrare i link da importare (predefinito: ".*")
html_selector stringa	Selettore CSS per individuare contenuti specifici
summarize booleano	Indica se riassumere i contenuti importati (predefinito: 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()

Risposta 202 Accepted

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

Estrarre un elenco di link

Importa i contenuti da un elenco specifico di URL.

Ambito: write_all

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

Corpo della richiesta

Parametro	Descrizione
links array di stringhe, obbligatorio	Elenco non vuoto di URL da cui estrarre i contenuti
tags array di stringhe	Tag da applicare agli articoli importati
html_selector stringa	Selettore CSS per individuare contenuti specifici
summarize booleano	Indica se riassumere i contenuti importati (predefinito: 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()

Risposta 202 Accepted

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

Eliminare i link

Rimuove dalla base di conoscenza gli articoli di tipo URL importati in precedenza.

Ambito: write_all

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

Corpo della richiesta

Parametro	Descrizione
links array di stringhe, obbligatorio	Elenco di URL da rimuovere (almeno 1)

Nota

Tutti gli URL forniti devono esistere nella base di conoscenza come articoli di tipo URL. Se un URL non corrisponde a un articolo esistente, la richiesta restituisce 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"],
    },
)

Risposta 200 OK

---