NEOs Quantum Nova · Handbuch
So nutzen Sie NOVA im Arbeitsalltag und machen Ihre eigenen Dokumente für Antworten verfügbar.
Hier finden Sie die Anleitungen für den Arbeitsalltag mit NOVA. Für die Anbindung eigener Anwendungen gibt es einen eigenen API-Bereich mit Codebeispielen.
Im Chat bearbeiten Sie einzelne Aufgaben. Wissen, das Sie regelmäßig brauchen, hinterlegen Sie in einer Sammlung. Ein Assistent verbindet dieses Wissen mit einem Modell und einer Arbeitsanweisung.
Welche Modelle und Sammlungen Sie verwenden können, richtet sich nach den Freigaben Ihres Kontos.
Melden Sie sich bei Ihrer NOVA-Instanz an und wählen Sie ein freigegebenes Modell oder einen vorbereiteten Assistenten. Beschreiben Sie Ihre Aufgabe und das gewünschte Ergebnis.
Probieren Sie es mit einem Dokument aus, das Sie gut kennen. Laden Sie die Datei hoch und fragen Sie nach einer konkreten Passage. So können Sie die Antwort mit dem Original vergleichen.
»Fasse die Voraussetzungen für die Einrichtung als Checkliste zusammen. Nenne zu jedem Punkt die Fundstelle im Handbuch.«
Für die Arbeit im Browser brauchen Sie keinen API-Schlüssel.
Mit Rückfragen können Sie eine Antwort eingrenzen oder überarbeiten lassen. Nennen Sie, was fehlt oder anders werden soll, statt die ganze Aufgabe erneut zu beschreiben.
Dateianhänge ergänzen den Gesprächskontext. Ob NOVA ein Bild auswerten, eine Tabelle verarbeiten oder Code ausführen kann, hängt vom gewählten Modell und den freigegebenen Werkzeugen ab.
Wählen Sie die passende Wissenssammlung oder einen Assistenten, der bereits damit verbunden ist. Fragen Sie möglichst konkret nach einem Thema, einem Dokument oder einem bestimmten Stand.
Öffnen Sie die genannten Quellen. Die Antwort sollte sich daraus nachvollziehen lassen. Wenn Angaben fehlen, bitten Sie NOVA, die Lücke zu benennen.
Bei umfangreichen Unterlagen hilft es, mehrere Teilfragen zu stellen.
Im illustrierten Beispiel nennt die Antwort dieselben Bohrdurchmesser wie das Datenblatt: bis 24 mm in Beton und bis 30 mm in Holz. Die Angaben dienen nur der Veranschaulichung.
Beim Einlesen werden Dokumente für die Suche aufbereitet. Erst wenn Sie eine Frage stellen, sucht NOVA passende Textstellen und gibt sie an das Sprachmodell weiter. Dieses formuliert die Antwort.
Das Verfahren heißt Retrieval Augmented Generation, kurz RAG.
NOVA extrahiert den Text und teilt ihn in Abschnitte. Ein Embedding-Modell erzeugt daraus Vektoren, die zusammen mit den Texten und Metadaten im Wissensspeicher abgelegt werden.
Die Suche ermittelt passende Abschnitte aus den freigegebenen Dokumenten. Das Sprachmodell erhält diese als Kontext für seine Antwort. Die Quellen führen zurück zu den zugrunde liegenden Textstellen.
Eine Sammlung bündelt Dokumente, die zusammengehören: etwa ein Produkthandbuch, Arbeitsanweisungen oder Unterlagen eines Fachbereichs.
Geben Sie jeder Sammlung einen verständlichen Namen. Legen Sie fest, wer sie verwenden und wer sie pflegen darf.
Ein erfolgreicher Upload bedeutet noch nicht, dass der Inhalt schon durchsuchbar ist. Bei Scans und komplexen Tabellen lohnt sich ein Blick auf die Texterkennung.
Embeddings machen Texte für die inhaltliche Suche vergleichbar. Dadurch kann NOVA auch Abschnitte finden, deren Wortlaut von Ihrer Frage abweicht.
Für die Suchqualität zählen die Dokumente ebenso wie das Modell und die Aufteilung in Abschnitte. Prüfen Sie die Suche deshalb mit Fragen aus Ihrem tatsächlichen Arbeitsalltag.
Bei umfangreichen Sammlungen sucht NOVA gezielt nach relevanten Abschnitten. Bei kurzen Dokumenten kann die Verarbeitung des vollständigen Textes sinnvoll sein, sofern die gewählte Konfiguration das unterstützt.
Ein großes Kontextfenster allein garantiert keine richtige Antwort. Entscheidend ist, ob die benötigten Informationen gefunden und zutreffend wiedergegeben werden.
Ein Modell-Preset legt fest, welches Basismodell arbeitet, welche Aufgabe es übernimmt und welches Wissen es nutzen darf.
Beschreiben Sie die Aufgabe so, wie Sie sie einem neuen Kollegen erklären würden. Halten Sie auch fest, was der Assistent tun soll, wenn eine Information fehlt.
Die Illustration zeigt Qwen als Beispiel. Weitere Modellfamilien sind Gemma, Mistral, Nemotron, DeepSeek, GLM und Kimi. Welche Modelle Sie auswählen können, hängt von Ihrer NOVA-Konfiguration und den Freigaben ab.
Prüfen Sie dabei auch den Zugriff auf das Basismodell und die Wissenssammlungen. Die Freigabe des Presets allein genügt dafür nicht in jedem Fall.
Ein API-Schlüssel verbindet Ihre Anwendung mit NOVA. Die Anwendung erhält die Rechte des zugehörigen Kontos.
Verwenden Sie für Integrationen ein eigenes Servicekonto mit den benötigten Freigaben. Hinterlegen Sie den Schlüssel auf dem Server, nicht im Browsercode.
Öffnen Sie Ihr Profil und wechseln Sie in den Einstellungen zum Bereich für API-Schlüssel. Ist die Funktion für Ihr Konto freigegeben, können Sie dort einen Schlüssel erstellen.
Übertragen Sie ihn in die serverseitige Konfiguration Ihrer Anwendung. Testen Sie danach den Zugriff auf das vorgesehene Modell und die benötigte Wissenssammlung.
Authorization: Bearer IHR_API_SCHLUESSELWiderrufen Sie einen Schlüssel, wenn er nicht mehr gebraucht wird oder offengelegt wurde.
Über die API können Anwendungen Modelle abfragen, Dateien einlesen und Chat-Anfragen senden.
Ersetzen Sie in den Beispielen die Domain, den Schlüssel und die Kennungen durch die Werte Ihrer Instanz.
| Methode und Pfad | Aufgabe |
|---|---|
GET /api/models |
Verfügbare Modelle abfragen |
POST /api/chat/completions |
Chat-Anfrage senden |
POST /api/v1/files/ |
Datei hochladen |
GET /api/v1/files/{file_id}/process/status |
Verarbeitung prüfen |
POST /api/v1/knowledge/{knowledge_id}/file/add |
Datei einer Sammlung zuordnen |
GET /api/v1/models/export |
Presets exportieren |
POST /api/v1/models/import |
Presets importieren |
Testen Sie Importe vorab mit Beispieldaten. Ein Preset-Export ersetzt kein vollständiges Backup.
Laden Sie die Datei zuerst hoch. Warten Sie die Verarbeitung ab und ordnen Sie die Datei erst danach der Wissenssammlung zu.
Begrenzen Sie Wartezeit und Wiederholungen. Bei einem Verarbeitungsfehler muss der Import abbrechen.
curl -X POST 'https://IHRE-NOVA-DOMAIN/api/v1/files/' -H 'Authorization: Bearer IHR_API_SCHLUESSEL' -F 'file=@handbuch.pdf'Die Antwort enthält die Datei-ID für die folgenden Aufrufe.
curl 'https://IHRE-NOVA-DOMAIN/api/v1/files/DATEI_ID/process/status' -H 'Authorization: Bearer IHR_API_SCHLUESSEL'Warten Sie auf den Status completed.
curl -X POST 'https://IHRE-NOVA-DOMAIN/api/v1/knowledge/WISSENS_ID/file/add' -H 'Authorization: Bearer IHR_API_SCHLUESSEL' -H 'Content-Type: application/json' -d '{"file_id":"DATEI_ID"}'import os
import time
from pathlib import Path
import requests
NOVA_URL = os.environ["NOVA_URL"].rstrip("/")
API_KEY = os.environ["NOVA_API_KEY"]
KNOWLEDGE_ID = os.environ["NOVA_KNOWLEDGE_ID"]
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
def ingest_document(file_path, timeout=600):
path = Path(file_path)
with path.open("rb") as handle:
response = requests.post(
f"{NOVA_URL}/api/v1/files/",
headers=HEADERS,
files={"file": (path.name, handle)},
timeout=120,
)
response.raise_for_status()
file_id = response.json()["id"]
deadline = time.monotonic() + timeout
while time.monotonic() deadline:
response = requests.get(
f"{NOVA_URL}/api/v1/files/{file_id}/process/status",
headers=HEADERS, timeout=30,
)
response.raise_for_status()
status = response.json().get("status")
if status == "completed":
break
if status in ("failed", "error"):
raise RuntimeError("Die Dateiverarbeitung ist fehlgeschlagen.")
time.sleep(2)
else:
raise TimeoutError("Die Dateiverarbeitung dauert zu lange.")
response = requests.post(
f"{NOVA_URL}/api/v1/knowledge/{KNOWLEDGE_ID}/file/add",
headers=HEADERS, json={"file_id": file_id}, timeout=30,
)
response.raise_for_status()
return response.json()
# Beispiel: ingest_document("handbuch.pdf")Das Beispiel benötigt Python und das Paket requests. Die Konfiguration wird aus Umgebungsvariablen gelesen.
Eine Chat-Anfrage enthält das Modell und die Nachrichten. Sie können zusätzlich eine Wissenssammlung angeben.
Bei aktiviertem Streaming verarbeitet Ihre Anwendung die Antwort schrittweise. Der Aufruf läuft über Ihr Backend, damit der Schlüssel geschützt bleibt.
curl -X POST 'https://IHRE-NOVA-DOMAIN/api/chat/completions' -H 'Authorization: Bearer IHR_API_SCHLUESSEL' -H 'Content-Type: application/json' -d '{
"model": "IHR_MODELL_PRESET",
"messages": [
{"role": "user", "content": "Welche Einrichtungsschritte nennt das Handbuch?"}
],
"files": [{"type": "collection", "id": "WISSENS_ID"}],
"stream": true
}'Verwenden Sie die Kennung des freigegebenen Modell-Presets und der vorgesehenen Wissenssammlung.
Sie benötigen Unterlagen zur Modellauswahl oder zur technischen Einrichtung? Sprechen Sie uns an. Nennen Sie Ihre Aufgabe und die eingesetzte Konfiguration, damit wir die passenden Informationen zusammenstellen können.