Suchergebnisse neu ordnen lassen
KIT nimmt eine bereits vorhandene Liste von Suchergebnissen und ordnet sie anhand der ursprünglichen Anfrage neu, sodass die inhaltlich relevantesten Treffer zuerst erscheinen. Gedacht als zweiter Schritt nach einer ersten, gröberen Suche, um deren Rangfolge zu verfeinern, ohne die erste Suche selbst noch einmal durchführen zu müssen.
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.
Warum eine zweite Sortierung sinnvoll ist
Eine erste Suche, etwa über eine Datenbank oder einen Suchindex, liefert oft mehr Kandidaten, als tatsächlich relevant sind. Das erneute Sortieren bewertet jeden Kandidaten noch einmal genauer im Verhältnis zur ursprünglichen Anfrage und verschiebt die wirklich passenden Treffer nach oben. Gerade bei großen Trefferlisten macht das den Unterschied, ob die beste Antwort auf den ersten oder erst auf dem zwanzigsten Platz erscheint.
Wie die Funktion eingebunden wird
Sie senden die Anfrage zusammen mit der Liste der Kandidaten, etwa den Top-50-Treffern einer ersten Suche; KIT gibt dieselbe Liste in einer neuen, nach Relevanz sortierten Reihenfolge zurück. Die Funktion ersetzt keine erste Suche, sondern verfeinert deren Ergebnis, und lässt sich deshalb mit praktisch jeder bestehenden Such- oder Datenbankabfrage kombinieren, ohne diese zu ersetzen. Die Kombination beider Schritte liefert in der Praxis meist bessere Ergebnisse als jede Methode allein.
Wann sich das lohnt
Besonders wertvoll ist das erneute Sortieren, wenn die erste Suche viele ähnlich aussehende Treffer liefert, etwa bei einer reinen Stichwortsuche über einen großen Produktkatalog, und nur die obersten Plätze in einer Anwendung tatsächlich angezeigt werden. Bei einer Anzeige der ersten drei bis fünf Treffer entscheidet die Sortierung maßgeblich darüber, ob Nutzerinnen und Nutzer den passenden Treffer überhaupt zu sehen bekommen.
Preis pro Anfrage
$0.002 pro Anfrage plus $0.0015 pro Abfrage, insgesamt $0.0035, unabhängig davon, wie viele Kandidaten in der Liste neu sortiert werden. Ob zehn oder fünfzig Kandidaten übergeben werden, ändert am Preis nichts, solange die Gesamtmenge an Text innerhalb des allgemeinen Limits von 20.000 Token pro Anfrage bleibt, was in der Praxis für deutlich mehr als fünfzig Kandidaten ausreicht. Auch sehr lange einzelne Kandidatentexte lassen sich damit noch problemlos verarbeiten.
Anwendungsfälle
Produktsuche im Online-Shop
Ein Online-Shop sortiert die ersten 50 Treffer einer Produktsuche noch einmal nach Relevanz zur genauen Kundenanfrage, bevor sie angezeigt werden.
Dokumentensuche einer Kanzlei
Eine Kanzlei lässt die Treffer einer ersten Volltextsuche im Vertragsarchiv neu ordnen, damit die passendste Klausel ganz oben steht.
FAQ-System eines Support-Teams
Ein Softwareunternehmen sortiert die Kandidaten aus seiner Wissensdatenbank neu, bevor die Antwort einer Kundenanfrage zugeordnet wird.
Häufige Fragen
Was kostet das erneute Sortieren einer Trefferliste?
$0.002 pro Anfrage plus $0.0015 pro Abfrage, insgesamt $0.0035, unabhängig von der Länge der Liste.
Ersetzt diese Funktion die eigentliche Suche?
Nein, sie setzt eine bereits vorhandene Trefferliste voraus und ordnet nur deren Reihenfolge neu.
Wie viele Kandidaten kann ich auf einmal neu sortieren lassen?
Die Liste ist durch das allgemeine Limit von 20.000 Token pro Anfrage begrenzt; in der Praxis reichen damit deutlich mehr als 50 Kandidaten.
Für welche Art von erster Suche eignet sich das?
Für jede Trefferliste, egal ob sie aus einer Stichwortsuche, einer Datenbankabfrage oder der semantischen Suche von KIT stammt.
Was passiert mit den gesendeten Daten?
Anfrage und Kandidatenliste werden nur zur Berechnung der neuen Reihenfolge 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
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/rerank \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/search/rerank", {
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/rerank",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/search/rerank", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/search/rerank", 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.rerank",
"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
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. |