Vektorspeicher API

ENTWURF — Nur für interne Entwicklerteams

Diese API-Referenz ist für interne Entwicklerteams bestimmt.

Übersicht

Was es ist: Die Vektorspeicher-API verwaltet Sammlungen von Vektoreinbettungen für semantische Suche und KI-gestützte Abfragen. Sammlungen speichern Dokumenteinbettungen, die eine Ähnlichkeitssuche über Identitätsdaten ermöglichen.

Endpunkte

Methode	Pfad	Beschreibung	Authentifizierung erforderlich
POST	/internal/v1/ai/vector_store/collection	Eine Sammlung erstellen	JWT + API-Token
GET	/internal/v1/ai/vector_store/collection	Alle Sammlungen auflisten	JWT + API-Token
GET	/internal/v1/ai/vector_store/collection/:id	Sammlungsdetails abrufen	JWT + API-Token
POST	/internal/v1/ai/vector_store/collection/:id/query	Eine Sammlung abfragen	JWT + API-Token
DELETE	/internal/v1/ai/vector_store/collection/:id	Eine Sammlung löschen	JWT + API-Token

---

POST /internal/v1/ai/vector_store/collection

Eine neue Vektorspeicher-Sammlung erstellen.

Anfrage:

POST /internal/v1/ai/vector_store/collection
Authorization: Bearer <token>
Content-Type: application/json

{
  "name": "identity-embeddings",
  "description": "Vector embeddings for identity entity search",
  "dimensions": 1536
}

Antwort (201):

{
  "id": "collection-uuid-001",
  "name": "identity-embeddings",
  "status": "created",
  "documentCount": 0
}

---

POST /internal/v1/ai/vector_store/collection/:id/query

Eine semantische Abfrage gegen eine Vektorspeicher-Sammlung ausführen.

Anfrage:

POST /internal/v1/ai/vector_store/collection/collection-uuid-001/query
Authorization: Bearer <token>
Content-Type: application/json

{
  "query": "privileged accounts with access to production databases",
  "topK": 10,
  "threshold": 0.7
}

Antwort (200):

{
  "results": [
    {
      "id": "doc-001",
      "score": 0.95,
      "metadata": {
        "entityType": "account",
        "source": "PostgreSQL"
      },
      "content": "DBA admin account with full access to production database cluster"
    }
  ]
}