Wissensdatenbank
Laden Sie Wissensdatenbank-Dateien für KI-Sprachassistenten über die Talkturo-API hoch, listen Sie sie auf und löschen Sie sie — verwalten Sie Dokumente, die retrievalbasierte Antworten während Anrufen ermöglichen.
curl --request GET \
--url "https://app.talkturo.com/api/assistants/9d3f6cf5-3c12-4e60-bd8a-1b1d57a8c4d2/knowledge-base" \
--cookie "sb-access-token=sb_example_session_token"
const response = await fetch(
"https://app.talkturo.com/api/assistants/9d3f6cf5-3c12-4e60-bd8a-1b1d57a8c4d2/knowledge-base",
{
method: "GET",
credentials: "include",
}
);
const data = await response.json();
console.log(data);
{
"success": true,
"files": [
{
"id": "6b9d58b9-4b43-4f94-8cb8-2d3d9f18d714",
"filename": "acme-pricing-guide.pdf",
"size": 248193,
"type": "application/pdf",
"status": "processed",
"created_at": "2026-02-11T14:22:09.000Z"
},
{
"id": "4f6c291e-a60d-4ff3-9cb2-52e2b65f6b31",
"filename": "returns-policy.docx",
"size": 91344,
"type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"status": "processing",
"created_at": "2026-02-11T14:24:51.000Z"
}
]
}
curl --request POST \
--url "https://app.talkturo.com/api/assistants/9d3f6cf5-3c12-4e60-bd8a-1b1d57a8c4d2/knowledge-base" \
--cookie "sb-access-token=sb_example_session_token" \
--form "file=@./docs/acme-support-playbook.pdf"
const formData = new FormData();
formData.append("file", fileInput.files[0]);
const response = await fetch(
"https://app.talkturo.com/api/assistants/9d3f6cf5-3c12-4e60-bd8a-1b1d57a8c4d2/knowledge-base",
{
method: "POST",
body: formData,
credentials: "include",
}
);
const data = await response.json();
console.log(data);
{
"success": true,
"file": {
"id": "6b9d58b9-4b43-4f94-8cb8-2d3d9f18d714",
"filename": "acme-support-playbook.pdf",
"size": 248193,
"type": "application/pdf",
"status": "processing",
"created_at": "2026-02-11T14:22:09.000Z"
}
}
Wissensdatenbank-Endpunkte
Verwalten Sie assistentenspezifische Wissensdatenbank-Dateien mit sitzungsauthentifizierten Endpunkten unter /api/assistants/{assistantId}/knowledge-base. Hochgeladene Dateien werden pro Assistent gespeichert und für Retrieval während Anrufen verarbeitet.
Diese Endpunkte erfordern eine authentifizierte Browser-Sitzung. Sie verwenden keine API-Schlüssel-Authentifizierung.
Upload-Anfragen verwenden multipart/form-data und müssen ein Dateifeld enthalten. Die Dateiverarbeitung erfolgt nach dem Upload; eine neu hochgeladene Datei kann daher mit einem noch nicht bereiten status erscheinen, bevor sie für Retrieval verfügbar wird.
Endpunktübersicht
| Methode | Pfad | Zweck | Auth |
|---|---|---|---|
GET | /api/assistants/{assistantId}/knowledge-base | Wissensdatenbank-Dateien eines Assistenten auflisten | Sitzungs-Cookie |
POST | /api/assistants/{assistantId}/knowledge-base | Wissensdatenbank-Datei hochladen | Sitzungs-Cookie |
DELETE | /api/assistants/{assistantId}/knowledge-base/{fileId} | Wissensdatenbank-Datei löschen | Sitzungs-Cookie |
GET | /api/assistants/{assistantId}/billing/estimate | Kostenschätzung für die Wissensdatenbank-Verarbeitung abrufen | Sitzungs-Cookie |
GET | /api/kb | Eigenständiger Wissensdatenbank-Abfrage-Endpunkt, sofern in Ihrer Deployment aktiviert | Prüfen Sie Ihre Deployment |
Wissensdatenbank-Dateien auflisten
Gibt alle einem Assistenten zugeordneten Wissensdatenbank-Dateien zurück.
Pfadparameter
Assistentenkennung. Die zurückgegebene Dateiliste ist auf diesen Assistenten beschränkt.
Antwortfelder
Gibt true zurück, wenn die Anfrage erfolgreich ist.
Liste der dem Assistenten zugeordneten Wissensdatenbank-Dateien.
Eindeutige Dateikennung. Verwenden Sie diesen Wert beim Löschen einer Datei.
Ursprünglicher Dateiname beim Upload.
Dateigröße in Bytes.
Erkannter MIME-Typ der Datei.
Verarbeitungsstatus der Datei. Nutzen Sie dieses Feld, um zu erkennen, ob die Datei noch verarbeitet wird oder für Retrieval bereit ist.
Zeitstempel, wann die Datei hochgeladen wurde.
Wissensdatenbank-Datei hochladen
Laden Sie eine Datei mit multipart/form-data in die Wissensdatenbank eines Assistenten hoch.
Ein erfolgreicher Upload bestätigt, dass die Datei angenommen und zur Verarbeitung eingereiht wurde. Prüfen Sie den Datei-status über den Listen-Endpunkt, wenn Ihr Workflow warten muss, bis die Verarbeitung abgeschlossen ist.
Pfadparameter
Assistentenkennung, der die hochgeladene Datei gehören soll.
Body-Parameter
Die hochzuladende Datei, gesendet als multipart/form-data-Feld.
Antwortfelder
Gibt true zurück, wenn der Upload angenommen wird.
Metadaten der hochgeladenen Datei.
Eindeutige Dateikennung.
Ursprünglicher Dateiname beim Upload.
Dateigröße in Bytes.
Erkannter MIME-Typ der Datei.
Anfänglicher Verarbeitungsstatus nach dem Upload.
Zeitstempel, wann die Datei erstellt wurde.
Wissensdatenbank-Datei löschen
Entfernen Sie eine Datei aus der Wissensdatenbank eines Assistenten.
curl --request DELETE \
--url "https://app.talkturo.com/api/assistants/9d3f6cf5-3c12-4e60-bd8a-1b1d57a8c4d2/knowledge-base/6b9d58b9-4b43-4f94-8cb8-2d3d9f18d714" \
--cookie "sb-access-token=sb_example_session_token"
{
"success": true,
"message": "File deleted"
}
Pfadparameter
Assistentenkennung, der die Datei gehört.
Kennung der zu löschenden Wissensdatenbank-Datei.
Antwortfelder
Gibt true zurück, wenn die Datei entfernt wurde.
Menschenlesbares Löschergebnis.
Abrechnungsschätzung abrufen
Rufen Sie die Abrechnungsschätzung für die Wissensdatenbank-Verarbeitung eines Assistenten ab.
curl --request GET \
--url "https://app.talkturo.com/api/assistants/9d3f6cf5-3c12-4e60-bd8a-1b1d57a8c4d2/billing/estimate" \
--cookie "sb-access-token=sb_example_session_token"
Die Antwort enthält ein Erfolgsflag und ein estimate-Objekt.
Pfadparameter
Assistentenkennung, anhand derer die Schätzung berechnet wird.
Antwortfelder
Gibt true zurück, wenn die Schätzung verfügbar ist.
Details der Abrechnungsschätzung für die Wissensdatenbank-Verarbeitung. Die Objektstruktur hängt von der aktuellen Abrechnungsimplementierung ab.
Eigenständiger Wissensdatenbank-Endpunkt
Einige Deployments stellen möglicherweise einen separaten Endpunkt GET /api/kb für eigenständige Wissensdatenbank-Abfragen bereit.
Der Repository-Kontext für diese Seite bestätigt die assistentenspezifischen Endpunkte zur Verwaltung der Wissensdatenbank. Er liefert kein verifiziertes Anfrage- oder Antwortschema für GET /api/kb. Prüfen Sie Ihre deployte API oder interne Routendefinitionen, bevor Sie diesen Endpunkt in der Produktion verwenden.
Falls GET /api/kb in Ihrer Umgebung existiert, behandeln Sie ihn getrennt von der Dateiverwaltung für Assistenten. Er ersetzt nicht die oben dokumentierten Upload-, Listen- oder Lösch-Endpunkte.
Typischer Workflow
Verwenden Sie die Wissensdatenbank-Endpunkte in dieser Reihenfolge, wenn Sie die Dokumentenverwaltung automatisieren:
Datei hochladen
Senden Sie eine POST-Anfrage mit multipart/form-data an den Wissensdatenbank-Endpunkt des Assistenten.
Erfolg sieht aus wie eine Antwort mit success: true und einem file-Objekt.
Verarbeitungsstatus abfragen
Rufen Sie GET /api/assistants/{assistantId}/knowledge-base auf und prüfen Sie den status jeder Datei.
Ihr Workflow kann fortfahren, sobald die hochgeladene Datei in der Liste erscheint und der Status anzeigt, dass die Verarbeitung abgeschlossen ist.
Verarbeitungskosten bei Bedarf schätzen
Rufen Sie GET /api/assistants/{assistantId}/billing/estimate vor oder nach dem Upload auf, wenn Sie Abrechnungstransparenz für die Wissensdatenbank-Nutzung des Assistenten benötigen.
Erfolg sieht aus wie eine Antwort mit success: true und einem estimate-Objekt.
Veraltete Dateien entfernen
Löschen Sie Dateien, die der Assistent nicht mehr verwenden soll, mit DELETE /api/assistants/{assistantId}/knowledge-base/{fileId}.
Eine erfolgreiche Löschung gibt success: true und eine Bestätigungsnachricht zurück.