Coming soon

Die Lookeen RAG-API und MCP-Integration sind noch nicht verfügbar. Die folgenden Informationen beschreiben geplante Funktionen.

Lookeen RAG-API

Die Retrieval-API liefert rangierte Lookeen-Passagen für die Erdung eines Agenten oder Sprachmodells. Sie erzeugt keine Antwort und ruft kein LLM auf. Diese Seite stellt den Vertrag von GET /v1/rag als HTML dar.

Endpunkt

URI	/v1/rag
Methode	POST
Content-Type	application/json
Retrieval	lexical
Authentifizierung	Authorization: Bearer <Lookeen API key>

Request-Body

Feld	Typ	Beschreibung
query	String	Auszuführende Lookeen-Suchanfrage. Erforderlich und nicht leer.
topK	Integer	Maximale Anzahl zurückgegebener Passagen. Standard: 10, Minimum: 1, Maximum: 100.
userId	Integer	Optionale Benutzer-ID, deren Dokumentberechtigungen angewendet werden.
groupIds	Array<Integer>	Optionale Gruppen-IDs, deren Dokumentberechtigungen angewendet werden.
filters	Array	Optionale strukturierte Dokumentfilter mit column, op und value.

Filter

Feld	Beschreibung
column	Name einer durchsuchbaren Lookeen-Spalte; erforderlich.
op	Filteroperator; erforderlich.
value	Filterwert; nur bei Operatoren wie EMPTY und NOT_EMPTY optional.

Unterstützte Operatoren: IN, NOT_IN, EQUALS, LARGER, NOT_EQUALS, LIKE, NOT_LIKE, SMALLER, STARTS_WITH, DOES_NOT_START_WITH, DOES_NOT_END_WITH, ENDS_WITH, NOT_EMPTY, EMPTY, RANGE, NOOP, CONTAINS und COMPLEX.

Beispielanfrage

curl -X POST https://lookeen.example/v1/rag \
  -H 'Authorization: Bearer <api-key>' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "Risiken Projekt Phoenix",
    "topK": 5,
    "userId": 42,
    "groupIds": [3, 8],
    "filters": [
      {"column": "extension", "op": "EQUALS", "value": "pdf"}
    ]
  }'

Response

Feld	Beschreibung
query	Normalisierte übermittelte Suchanfrage.
retrieval	Verwendetes Retrieval-Verfahren; aktuell lexical.
totalMatches	Gesamtzahl passender Dokumente vor Anwendung von topK.
results	Nach absteigender Relevanz sortierte Treffer. Pro Dokument wird eine Passage zurückgegeben.
elapsedMs	Serverseitige Retrieval-Dauer in Millisekunden.

Ein Element in results

Feld	Beschreibung
rank	Eins-basierter Rang.
score	Relevanz relativ zum ersten Treffer von 0 bis 1; fehlt, wenn kein Score verfügbar ist.
documentId	Stabile Lookeen-Dokument-ID für Zitate und spätere Zugriffe.
title	Dokumenttitel.
path	Dokumentpfad, soweit verfügbar.
url	Dokument-URL, soweit verfügbar.
mimeType	MIME-Typ, soweit verfügbar.
itemType	Lookeen-Elementtyp in Kleinbuchstaben, soweit verfügbar.
modified	Änderungszeitpunkt im ISO-8601-Format, soweit verfügbar.
passage	Zur Anfrage ausgewählte Klartextpassage für die Erdung.

Beispielantwort

{
  "query": "Risiken Projekt Phoenix",
  "retrieval": "lexical",
  "totalMatches": 18,
  "results": [
    {
      "rank": 1,
      "score": 1.0,
      "documentId": "project-status~12~42",
      "title": "Projektstatus Q3",
      "path": "S:\\Projekte\\Phoenix\\Projektstatus_Q3.pdf",
      "mimeType": "application/pdf",
      "itemType": "file",
      "modified": "2026-10-14T08:30:00Z",
      "passage": "Die API-Freigabe verschiebt sich. Zwei Datenschutzprüfungen sind noch offen."
    }
  ],
  "elapsedMs": 34
}

← Zurück zu Enterprise Suche für KI (RAG)