Filter und Suche verfeinern

/documents/search führt eine Volltextsuche über Titel und Inhalt Ihrer Dokumente durch und liefert die besten Treffer, jeweils mit einem Relevanzwert und dem Quelldokument, aus dem sie stammen. Dieser Leitfaden zeigt, wie Sie diese Ergebnisse mit Filtern eingrenzen und die Antwort lesen.

Die Anfrage

Nur query ist erforderlich. Alles Weitere grenzt die Ergebnisse ein oder beschränkt sie.

curl https://nordvec.com/api/v1/documents/search \
  -H "Authorization: Bearer $NORDVEC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "renewal terms",
    "limit": 20,
    "datasource": "contracts",
    "sourceProvider": "google_drive",
    "createdAfter": "2026-01-01T00:00:00Z",
    "createdBefore": "2026-07-01T00:00:00Z"
  }'

Die Antwort

{
  "results": [
    {
      "id": "…",
      "title": "Acme Corp Master Services Agreement",
      "snippet": "…renews automatically for successive twelve month terms…",
      "score": 0.82,
      "datasource": "contracts",
      "source_provider": "google_drive",
      "source_type": "…",
      "mime_type": "application/pdf",
      "status": "indexed",
      "created_at": "2026-02-14T09:00:00Z",
      "updated_at": "2026-02-14T09:00:00Z"
    }
  ],
  "totalCount": 7
}

Jedes Ergebnis enthält einen snippet mit dem übereinstimmenden Text, einen score von 0 bis 1 (höhere Werte bedeuten höhere Relevanz) sowie die Metadaten des Quelldokuments, sodass Sie es zurückverfolgen können. totalCount gibt an, wie viele Dokumente insgesamt übereinstimmen, was größer sein kann als die Anzahl der results, die Sie mit limit angefordert haben.

Auswertung der Ergebnisse

• Die Ergebnisse werden nach Relevanz sortiert, die relevantesten zuerst. Verwenden Sie score, um eine Grenze festzulegen, wenn Sie nur starke Treffer erhalten möchten.
• totalCount vs. results.length: results enthält bis zu limit Elemente; totalCount ist die Gesamtzahl der Treffer. Wenn totalCount deutlich größer ist als Ihre limit, sollten Sie die query eingrenzen oder einen Filter hinzufügen, statt zu erwarten, dass alle Treffer in einem Aufruf zurückgegeben werden.
• Nur indizierte Dokumente sind durchsuchbar. Ein Dokument mit status von processing oder failed ist noch nicht abrufbar; siehe Dokumente & Suche für den Lebenszyklus.

Nächste Schritte