AI-Assistent API

ENTWURF — Nur für interne Entwicklerteams

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

Übersicht

Was es ist: Die AI-Assistent-API bietet Zugriff auf die KI-Funktionen von Discovery: Autovervollständigung für die Abfrageerstellung, Agenten-Sitzungen für interaktive KI-Konversationen und Modellverwaltung.

Warum es wichtig ist: Entwickler, die KI-gestützte Funktionen erstellen oder KI-Fähigkeiten in andere Hydden-Produkte integrieren, müssen verstehen, wie sie Sitzungen erstellen, Abfragen senden und KI-generierte Antworten abrufen können.

Endpunkte

Methode	Pfad	Beschreibung	Authentifizierung erforderlich
POST	/internal/v1/ai/autocomplete	KI-gestützte Abfrage-Autovervollständigung	JWT + API-Token
GET	/internal/v1/ai/models/:provider	KI-Modelle nach Anbieter auflisten	JWT + API-Token
POST	/internal/v1/ai/agent/session	Eine neue KI-Agenten-Sitzung erstellen	JWT + API-Token
GET	/internal/v1/ai/agent/sessions	Alle Agenten-Sitzungen auflisten	JWT + API-Token
GET	/internal/v1/ai/agent/sessions/:id	Eine bestimmte Agenten-Sitzung abrufen	JWT + API-Token

---

POST /internal/v1/ai/autocomplete

KI-gestützte Autovervollständigungsvorschläge für Suchabfragen und Collector-Konfigurationen abrufen.

Anfrage:

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

{
  "input": "find all admin accounts with threat score",
  "context": "global-search"
}

Antwort (200):

{
  "suggestions": [
    "find all admin accounts with threat score above 80",
    "find all admin accounts with threat score in critical range",
    "find all admin accounts with threat score trending upward"
  ]
}

---

POST /internal/v1/ai/agent/session

Eine neue KI-Agenten-Sitzung für interaktive Konversationen erstellen.

Anfrage:

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

{
  "context": "universal-collector",
  "initialPrompt": "Help me create a sandboxed Python script for collecting data from a custom REST API"
}

Antwort (201):

{
  "sessionId": "session-uuid-001",
  "status": "active",
  "createdAt": "2026-02-12T10:00:00Z"
}

---

GET /internal/v1/ai/models/:provider

Verfügbare KI-Modelle für einen bestimmten Anbieter auflisten.

Pfadparameter:

Parameter	Typ	Beschreibung
provider	string	Name des KI-Anbieters

Anfrage:

GET /internal/v1/ai/models/default
Authorization: Bearer <token>

Antwort (200):

{
  "provider": "default",
  "models": [
    {
      "id": "model-001",
      "name": "Discovery Assistant",
      "capabilities": ["autocomplete", "agent", "search"]
    }
  ]
}