ForHosting KIT · Semantische Suche

Semantische Suche für eigene Daten

KIT durchsucht einen zuvor erstellten Index nicht nach exakten Wörtern, sondern nach inhaltlicher Bedeutung: Eine Suche nach „Kündigungsfrist“ findet auch einen Abschnitt, in dem nur von „Vertragsende“ die Rede ist. Gedacht für alle, die eigene Texte, PDFs oder Webseiten bereits indexiert haben.

● Stabilpro Anfrage + pro Abfrage$0.002

Ausführen — $0.002 + $0.0015/Abfrage API ansehen

Nutzen Sie es über WebAPIE-MailApp baldTelegram bald

Online ausführen

Führen Sie dies mit Ihrem Konto auf unseren Servern aus. Kostenlose Tools laufen in Ihrem Browser; dieses wird zum oben genannten Preis von Ihrem KIT-Guthaben abgebucht.

Der Unterschied zur Stichwortsuche

Eine klassische Suche findet nur, was wörtlich im Text steht: Wer nach „Kündigungsfrist“ sucht, findet keinen Abschnitt, der nur „Vertragsende“ nennt, obwohl beides denselben Sachverhalt meint. Die semantische Suche vergleicht stattdessen die Bedeutung der Anfrage mit der Bedeutung jedes Abschnitts im Index und findet so auch Formulierungen, die kein einziges gemeinsames Wort mit der Anfrage teilen, aber inhaltlich dasselbe meinen.

Voraussetzung: ein bestehender Index

Diese Funktion durchsucht einen Index, der zuvor über eine der Indexierungsfunktionen von KIT aus Texten, PDFs oder Webseiten aufgebaut wurde. Ohne einen solchen Index gibt es nichts zu durchsuchen; die semantische Suche selbst legt keine neuen Inhalte an, sondern arbeitet ausschließlich mit dem, was zuvor bereits indexiert wurde. Der erste Schritt ist deshalb immer eine der Indexierungsfunktionen. Erst danach liefert die semantische Suche brauchbare, inhaltlich passende Ergebnisse.

Wie eine Anfrage abläuft

Sie senden eine Frage oder einen Suchbegriff in natürlicher Sprache; KIT liefert die inhaltlich passendsten Abschnitte aus dem Index zurück, sortiert nach Ähnlichkeit. Das Ergebnis enthält den Text des jeweiligen Abschnitts und einen Wert für die Trefferähnlichkeit, sodass Sie erkennen können, wie sicher ein Treffer tatsächlich zur Anfrage passt, bevor Sie ihn weiterverwenden, etwa in einer eigenen Anwendung oder einem Support-Tool.

Preis pro Anfrage

$0.002 pro Anfrage plus $0.0015 pro Abfrage, insgesamt also $0.0035 pro Suche – unabhängig davon, wie groß der durchsuchte Index ist. Ob der Index zehn oder zehntausend Abschnitte umfasst, ändert am Preis einer einzelnen Anfrage nichts, da die Kosten an der Anfrage selbst hängen und nicht an der Größe der durchsuchten Sammlung, was die Kalkulation für wachsende Wissensdatenbanken einfach hält.

Anwendungsfälle

Support-Team sucht in der Wissensdatenbank

Ein Softwareunternehmen lässt sein Support-Team über die semantische Suche in der internen Wissensdatenbank nach passenden Antworten suchen, auch wenn Kundenfragen anders formuliert sind als die Artikel.

Kanzlei sucht im Vertragsarchiv

Eine Kanzlei in Hamburg durchsucht ihr indexiertes Vertragsarchiv nach einer bestimmten Klausel, ohne den genauen Wortlaut zu kennen.

Handwerksbetrieb sucht in Arbeitsanweisungen

Ein Handwerksbetrieb aus Stuttgart lässt Mitarbeitende über eine Suchleiste in den internen Arbeitsanweisungen nach Lösungen für ein bestimmtes Problem suchen.

Häufige Fragen

Was kostet eine Suchanfrage?

$0.002 pro Anfrage plus $0.0015 pro Abfrage, insgesamt $0.0035 pro Suche.

Brauche ich vorher einen Index?

Ja, die semantische Suche durchsucht einen bestehenden Index; dieser lässt sich über die Funktionen zur Indexierung von Texten, PDFs oder Webseiten aufbauen.

Findet die Suche auch Ergebnisse ohne exakte Wortübereinstimmung?

Ja, das ist der Zweck der Funktion: Sie findet Abschnitte, die inhaltlich passen, auch wenn kein Wort der Anfrage im Text vorkommt.

Wie viele Ergebnisse liefert eine Anfrage?

Die Anzahl der zurückgegebenen Abschnitte lässt sich einstellen; als Ausgangswert liefert die Funktion die am besten passenden Treffer.

Was passiert mit meiner Suchanfrage?

Sie wird zur Berechnung der Ähnlichkeit verwendet und nicht dauerhaft gespeichert.

Brauche ich ein Konto?

Nein. Es gibt derzeit keine Konten – Sie zahlen pro Nutzung.

Für Entwickler — API-Zugang

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

Endpunkt

POSThttps://api.kit.forhosting.com/search/semantic

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

Aufruf aus Ihrem Stack

curl -X POST https://api.kit.forhosting.com/search/semantic \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

const res = await fetch("https://api.kit.forhosting.com/search/semantic", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "input": "…"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/search/semantic",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/search/semantic", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"input":"…"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/search/semantic", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "input": "…"
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "search.semantic",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Preis

pro Anfrage$0.002

pro Abfrage$0.0015

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

Limits

`max_chunks`	10000
`max_tokens`	20000

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →