Verwendung des KI-Assistenten

NOTE

Der KI-Assistent ist eine Vorschaufunktion. Wenden Sie sich an Ihren Hydden-Kundenvertreter, um ihn in Ihrem Mandanten zu aktivieren.

Ueberblick

Der Hydden KI-Assistent ist ein intelligenter Helfer, der in die gesamte Hydden-Plattform integriert ist. Er beantwortet Fragen, bietet Anleitungen, analysiert Identitaetsdaten und hilft bei der Fehlersuche -- alles in natuerlicher Sprache.

KI-Assistenten konfigurieren

Bevor Sie den KI-Assistenten verwenden, konfigurieren Sie Ihren KI-Anbieter, erstellen Sie Agenten und richten Sie optional eine Wissensdatenbank ein.

Einen KI-Anbieter einrichten

Anbieter verbinden Hydden mit KI-Diensten. Sie muessen mindestens einen Anbieter konfigurieren, bevor Sie den KI-Assistenten verwenden koennen.

1. Navigieren Sie zu Konfiguration > Assistent.
2. Waehlen Sie die Registerkarte Anbieter.
3. Klicken Sie auf + Anbieter hinzufuegen.
4. Konfigurieren Sie die Anbieter-Einstellungen:

Feld	Beschreibung
Name	Geben Sie einen aussagekraeftigen Namen fuer den Anbieter ein (z. B. "OpenAI Produktion").
Anbieter	Waehlen Sie den KI-Anbieter aus dem Dropdown-Menue.
Modell	Waehlen Sie das zu verwendende Modell aus den verfuegbaren Modellen. Modelle, die Nicht-Chat-Endpunkte unterstuetzen, zeigen eine Endpunkt-Bezeichnung neben dem Modellnamen an.
Basis-URL	(Nur OpenAI) Benutzerdefinierte API-Basis-URL fuer OpenAI-kompatible Endpunkte. Lassen Sie das Feld leer, um die Standard-OpenAI-API zu verwenden (https://api.openai.com/v1). Verwenden Sie dieses Feld, um eine Verbindung zu Azure OpenAI Service, lokalen Proxys oder anderen OpenAI-kompatiblen Anbietern herzustellen.
Eingabekosten pro 1M Token ($)	(Optional) Geben Sie die Eingabe-Token-Kosten fuer die Nutzungsverfolgung ein. Der Wert erscheint in den Sitzungskostenberechnungen.
Ausgabekosten pro 1M Token ($)	(Optional) Geben Sie die Ausgabe-Token-Kosten fuer die Nutzungsverfolgung ein. Der Wert erscheint in den Sitzungskostenberechnungen.
Anmeldedaten	Waehlen oder erstellen Sie Anmeldedaten, die Ihren API-Schluessel enthalten.

5. Klicken Sie auf Erstellen.

Unterstuetzte Anbieter und Modelle

Anbieter	Modelle	Hinweise
OpenAI	GPT-5, GPT-5 Mini, GPT-4.1, GPT-4.1 Mini, GPT-4	Erfordert OpenAI-API-Schluessel
Anthropic	Claude Opus 4.1, Claude Opus 4, Claude Sonnet 4.5, Claude Sonnet 4, Claude 4.5 Haiku	Erfordert Anthropic-API-Schluessel
Google AI	Gemini 2.5 Pro, Gemini 2.5 Flash, Gemini 2.0 Pro, Gemini 2.0 Flash	Erfordert Google AI-API-Schluessel
Grok (xAI)	Grok 4.0, Grok 4 Fast Reasoning, Grok 4 Fast Non-Reasoning, Grok Code	Erfordert xAI-API-Schluessel
Ollama	Llama 3.1, Llama 3, Gemma 3	Lokale Bereitstellung, kein API-Schluessel erforderlich

API-Schluessel-Anmeldedaten erstellen

1. Navigieren Sie zu Konfiguration > Einstellungen > Anmeldedaten.
2. Klicken Sie auf + Anmeldedaten hinzufuegen.
3. Waehlen Sie Kontopasswort als Anmeldedatentyp.
4. Geben Sie einen Namen ein (z. B. "OpenAI API-Schluessel").
5. Lassen Sie Benutzername leer oder geben Sie einen Platzhalter ein.
6. Fuegen Sie als Passwort Ihren API-Schluessel vom Anbieter ein.
7. Klicken Sie auf Erstellen.

Einen Agenten einrichten

Agenten sind konfigurierte KI-Assistenten mit spezifischen Anweisungen und Werkzeugen. Erstellen Sie Agenten fuer verschiedene Anwendungsfaelle.

1. Navigieren Sie zu Konfiguration > Assistent.
2. Waehlen Sie die Registerkarte Agenten.
3. Klicken Sie auf + Agent hinzufuegen.
4. Konfigurieren Sie die Agenten-Einstellungen:

Feld	Beschreibung
Name	Aussagekraeftiger Name (z. B. "Identity-Analyst-Agent").
Beschreibung	Beschreiben Sie, was dieser Agent tut.
Anbieter	Waehlen Sie Ihren konfigurierten KI-Anbieter.
Agententyp	Waehlen Sie den Agentenmodus. Agentisch (Chat + Werkzeuge) ermoeglicht interaktive Gespraeche mit Werkzeugausfuehrung (Standard). Vervollstaendigung (Code-Autovervollstaendigung) optimiert den Agenten fuer Inline-Codevorschlaege.
Einbettungen	(Optional) Waehlen Sie eine Wissensdatenbank-Sammlung.
Skills	(Optional) Fuegen Sie einen oder mehrere Skills hinzu, die der Agent als Werkzeuge aufrufen kann. Skills sind wiederverwendbare Aufgabeneinheiten mit eigenen Werkzeugen und Einbettungen. Siehe Skills einrichten.
Parallele Werkzeugaufrufe	Aktivieren, um gleichzeitige Werkzeugausfuehrung zu ermoeglichen.
Systemprompt	Anweisungen, die das Verhalten des Agenten definieren.

5. Geben Sie im Systemprompt-Editor die Agentenanweisungen ein.
6. Klicken Sie auf Erstellen.

Beispiel-Systemprompts

Identity-Posture-Agent:

# Identity Security Assistant
You are an identity security expert that helps users analyze their organization's identity posture.

Your capabilities include:
- Querying identity data to find users, accounts, and access
- Identifying security risks like dormant accounts or excessive privileges
- Generating compliance reports
- Recommending remediation actions

Always explain your reasoning and provide actionable recommendations.

Code-Vervollstaendigungs-Agent:

# Sandboxed Python Code Assistant
You assist users by writing and debugging sandboxed Python scripts for Universal Collectors.

You have access to:
- Hydden module documentation (hydn, sql, rest, ldap, csv, json, xml)
- Example collection scripts
- Schema definitions

Provide complete, working code examples with comments explaining each section.

Skills einrichten

Skills sind wiederverwendbare KI-Aufgabeneinheiten. Jeder Skill enthält einen Namen, eine Beschreibung und Prompt-Anweisungen — sowie ein optionales ZIP-Archiv mit unterstützenden Dateien. Agenten rufen Skills bei Bedarf auf, was die eigene Konfiguration des Agenten einfach hält.

1. Navigieren Sie zu Konfiguration > Assistent.
2. Wählen Sie die Registerkarte Skills.
3. Klicken Sie auf + Skill hinzufügen.
4. Konfigurieren Sie den Skill:

Feld	Beschreibung
Name	Ein kurzer Bezeichner für den Skill (z. B. risk-analyzer). Nur Kleinbuchstaben, Ziffern und Bindestriche. Der Name darf nicht mit einem Bindestrich beginnen oder enden. Maximal 64 Zeichen. Agenten verwenden diesen Namen, um den Skill aufzurufen.
Beschreibung	Erklären Sie, was der Skill tut. Agenten nutzen diese Beschreibung, um zu entscheiden, wann der Skill aufgerufen wird. Eine Beschreibung ist erforderlich, damit der Skill für Agenten verfügbar ist.
Prompt	Vollständige Anweisungen, die das Verhalten des Skills während der Ausführung steuern.
Ressourcen	(Optional) Ein ZIP-Archiv mit unterstützenden Dateien — Skripte, Referenzdaten oder Asset-Dateien — auf die der Prompt verweisen kann. Laden Sie ein ZIP über ZIP hochladen hoch.
Zusätzliche Frontmatter	(Optional) Zusätzliche YAML-Felder für das exportierte SKILL.md-Frontmatter, über die oben verwalteten Felder name und description hinaus. Verwenden Sie dieses Feld, um Metadaten wie compatibility, license oder version für Nutzer des exportierten Skills einzubetten.

5. Klicken Sie auf Erstellen.

Einen Skill aus ZIP importieren

Sie können einen vollständigen Skill direkt aus der Skills-Liste aus einem ZIP-Archiv importieren.

1. Klicken Sie auf der Registerkarte Skills auf Skill importieren.
2. Wählen Sie eine .zip-Datei aus.
3. Wenn das ZIP eine SKILL.md-Datei enthält, füllen deren Frontmatter-Felder die Skill-Felder automatisch aus. Die Felder name und description füllen ihre jeweiligen Felder. Alle weiteren Frontmatter-Felder (z. B. compatibility, license) erscheinen unter Zusätzliche Frontmatter. Der Textkörper füllt das Feld Prompt.
4. Überprüfen Sie und klicken Sie auf Speichern.

Wie Skills mit Agenten zusammenarbeiten

Skills verwenden progressives Offenlegen, sodass Agenten nur laden, was sie benötigen:

1. Erkennung — Wenn ein Agent eine Sitzung startet, erscheinen die Namen und Beschreibungen aller zugewiesenen Skills im Kontext des Agenten. Der Agent nutzt diese, um zu entscheiden, welcher Skill zur Aufgabe passt.
2. Aktivierung — Wenn der Agent einen Skill auswählt, ruft er activate_skill auf, um die vollständigen Prompt-Anweisungen des Skills zu laden.
3. Ressourcenzugriff — Wenn der Skill ein Ressourcenarchiv hat, kann der Agent read_skill_file aufrufen, um einzelne Dateien aus dem ZIP bei Bedarf zu laden.

Dieses Modell hält den Sitzungskontext schlank. Skills ohne Beschreibung werden ausgeschlossen — der Agent kann sie nicht erkennen.

Um Skills zu einem Agenten hinzuzufügen, fügen Sie Skill-Namen im Feld Skills beim Erstellen oder Bearbeiten eines Agenten hinzu.

Einen Skill duplizieren

So erstellen Sie eine Variante eines vorhandenen Skills:

1. Wählen Sie den Skill aus der Liste.
2. Klicken Sie auf das Symbol Duplizieren.
3. Bearbeiten Sie die Kopie und klicken Sie auf Speichern.

Eine Wissensdatenbank einrichten

Wissensdatenbank-Sammlungen stellen KI-Agenten zusaetzlichen Kontext durch Semantische Suche bereit.

1. Navigieren Sie zu Konfiguration > Assistent.
2. Waehlen Sie die Registerkarte Wissensdatenbank.
3. Klicken Sie auf + Sammlung hinzufuegen.
4. Konfigurieren Sie die Sammlung:

Feld	Beschreibung
Name	Aussagekraeftiger Name (z. B. "Interne App-Dokumentation").
Beschreibung	Beschreiben Sie, was diese Sammlung enthaelt.
Anbieter	Waehlen Sie den Einbettungsanbieter fuer die Vektorsuche.
Standard Top K	(Optional) Anzahl der Ergebnisse pro Abfrage. Standard: 3.
Standard Alpha	(Optional) Verhaeltnis zwischen Semantischer Suche und Schluesselwortsuche. Werte reichen von 0,0 (nur Schluesselwortsuche) bis 1,0 (nur Semantische Suche). Standard: 0,7.
Standard Min Score	(Optional) Mindest-Relevanzschwellenwert. Ergebnisse unterhalb dieses Werts werden ausgeschlossen. Standard: kein Schwellenwert.

5. Klicken Sie auf Erstellen.

Hybridsuche

Wissensdatenbank-Abfragen verwenden die Hybridsuche, die Semantische (Vektor-)Suche mit Volltext-Schluesselwortsuche (BM25) kombiniert. Der Alpha-Parameter steuert das Verhaeltnis:

Alpha-Wert	Verhalten
1,0	Reine Semantische Suche -- am besten fuer konzeptuelle Abfragen
0,7 (Standard)	Gewichtet in Richtung Semantische Suche mit Schluesselwort-Boost -- am besten fuer allgemeine Verwendung
0,2	Gewichtet in Richtung Schluesselwortsuche -- am besten fuer exakte Begriffssuche

Semantische Suche findet konzeptionell aehnliche Inhalte, auch wenn die Formulierung abweicht. Schluesselwortsuche findet exakte Begriffsuebereinstimmungen. Der Hybridansatz verbessert die Trefferquote fuer beide Abfragetypen.

Dokumente zu einer Sammlung hinzufuegen

Nachdem Sie eine Sammlung erstellt haben, fuegen Sie Dokumente hinzu:

1. Waehlen Sie die Sammlung aus der Liste.
2. Klicken Sie auf + Dokument hinzufuegen.
3. Laden Sie den Dokumentinhalt hoch oder fuegen Sie ihn ein.
4. Geben Sie den Dokumenttyp an (Text, JSON, Markdown, PDF, CSV).
5. Klicken Sie auf Erstellen.

Der KI-Assistent verwendet diese Dokumente, um kontextbezogene Antworten zu Ihren spezifischen Systemen zu geben.

Legacy-Prompts konfigurieren

Legacy-Prompts bieten Kompatibilitaet mit externen Integrationen wie Slack.

1. Navigieren Sie zu Konfiguration > Assistent.
2. Waehlen Sie die Registerkarte Legacy-Prompts.
3. Konfigurieren Sie Token und Prompts fuer Legacy-Integrationen.

---

Auf den KI-Assistenten zugreifen

Der KI-Assistent ist auf der gesamten Hydden-Plattform verfuegbar.

Globaler KI-Assistent

Zugriff von ueberall ueber das Chat-Symbol in der unteren rechten Ecke jeder unterstuetzten Seite.

Verwenden Sie ihn fuer:

• Allgemeine Fragen zur Plattform
• Abfragen von Identitaetsdaten
• Dokumentationssuche
• Erlernen der Funktionsweise von Features

Kontextbezogene Hilfe

Der KI-Assistent bietet kontextbezogene Hilfe innerhalb bestimmter Module:

Ort	Verfuegbare Unterstuetzung
Identity-Posture-Dashboard	Identitaetsdaten abfragen, Berichte erstellen, Risiken analysieren
Globale Suche	Komplexe Abfragen erstellen, Ergebnisse verstehen
Datenquellen	Sammlungsprobleme beheben, Konfigurationen verstehen
Universal Collector	Skripterstellung, Zuordnungshilfe, Schema-Analyse

Detaillierte Anweisungen zur Verwendung des KI-Assistenten bei der Anpassung des Universal Collectors finden Sie unter KI-Assistent fuer Universal Collector.

---

Den KI-Assistenten verwenden

Ein Gespraech starten

1. Klicken Sie auf das Chat-Symbol in der unteren rechten Ecke.
2. Geben Sie Ihre Frage in das Eingabefeld ein.
3. Druecken Sie Enter oder klicken Sie auf Senden.
4. Ueberpruefen Sie die Antwort und stellen Sie Folgefragen.

Effektive Prompts schreiben

Seien Sie spezifisch:

• Schlecht: "Erzaehl mir etwas ueber Benutzer"
• Gut: "Zeige mir Benutzer, die Admin-Zugang haben, sich aber seit 90 Tagen nicht angemeldet haben"

Stellen Sie Kontext bereit:

• Schlecht: "Wie behebe ich das?"
• Gut: "Ich erhalte einen Verbindungsfehler beim Testen meines SQL-Collectors fuer die HR-Datenbank. Die Fehlermeldung lautet 'connection refused on port 1433'"

Verwenden Sie natuerliche Sprache:

• "Welche Auftragnehmer haben nach Vertragsende noch Zugang?"
• "Zeige mir alle privilegierten Konten in Finanzsystemen"

Mehrteilige Gespraeche

Der KI-Assistent behaelt den Kontext ueber mehrere Austausche bei:

You: "Show me users with admin access"
AI: [Returns list of 47 admin users]

You: "Which of those haven't logged in recently?"
AI: [Filters to 12 users based on previous context]

You: "Create an access review for their managers"
AI: [Generates review assignments]

---

Identitaetsdaten abfragen

Stellen Sie Fragen zu Ihren Identitaetsdaten in einfacher Sprache.

Beispielabfragen

Privilegierten Zugang finden:

"Who has admin access to production systems?"
"Show me all users in the Domain Admins group"
"List service accounts with elevated privileges"

Risiken identifizieren:

"Show me accounts that haven't been used in 6 months but still have active access"
"Find users with access to both finance and IT systems"
"Which contractor accounts are past their end date?"

Compliance-Fragen:

"Generate a SOX compliance report for Q4"
"Show me evidence of quarterly access reviews"
"List all privileged accounts and their last login dates"

Berichte erstellen

Fordern Sie Berichte in natuerlicher Sprache an:

You: "Create a report of all privileged accounts for the SOX audit"

AI: I've generated your SOX privileged access report:

    Report Summary:
    - Total Privileged Accounts: 89
    - Active (logged in < 30 days): 67
    - Inactive (30-90 days): 15
    - Dormant (> 90 days): 7

    Would you like me to:
    - Export to Excel?
    - Schedule this report monthly?
    - Add additional details?

---

Sitzungsdaten anzeigen

Ueberpruefen Sie KI-Assistenten-Interaktionen fuer Audit- und Fehlerbehebungszwecke.

1. Navigieren Sie zu Konfiguration > Assistent.
2. Waehlen Sie die Registerkarte Sitzungen.
3. Sehen Sie die Liste der KI-Sitzungen mit:
   • Sitzungszeitstempel
   • Verwendeter Agent
   • Benutzer, der die Sitzung gestartet hat
   • Sitzungskosten (berechnet aus den Token-Preisen des Anbieters)
4. Klicken Sie auf eine Sitzungszeile und waehlen Sie das Aktionen-Symbol.
5. Sehen Sie Sitzungsdetails einschliesslich:
   • Vollstaendiger Gespraechsverlauf
   • Aufgerufene Werkzeuge
   • Verwendeter Anbieter und Modell
   • Gesamte Sitzungskosten

---

Best Practices

Gute Ergebnisse erzielen

1. Breit beginnen, dann verfeinern -- Beginnen Sie mit allgemeinen Fragen und grenzen Sie ein.
2. Relevanten Kontext bereitstellen -- Geben Sie Systemnamen, Fehlermeldungen und Anforderungen an.
3. Um Erklaerungen bitten -- Fordern Sie Begruendungen fuer Empfehlungen an.
4. Verstaendnis bestaetigen -- Stellen Sie sicher, dass der KI-Assistent Ihre Frage verstanden hat, bevor Sie handeln.

Sicherheitshinweise

• Geben Sie keine Passwoerter oder vertrauliche Anmeldedaten im Chat weiter.
• Ueberpruefen Sie KI-Vorschlaege, bevor Sie Aenderungen umsetzen.
• Verwenden Sie den KI-Assistenten innerhalb der Plattform; vermeiden Sie das Kopieren sensibler Daten nach aussen.
• Alle KI-Interaktionen werden zu Audit-Zwecken protokolliert.

Einschraenkungen verstehen

Der KI-Assistent KANN:

• Fragen zu Ihren Identitaetsdaten beantworten
• Konfigurationen und Zuordnungen vorschlagen
• Skripte und Code generieren
• Konzepte und Funktionen erklaeren
• Bei der Fehlerbehebung helfen
• Berichte und Zusammenfassungen erstellen

Der KI-Assistent KANN NICHT:

• Auf Daten zugreifen, fuer die er keine Berechtigung hat
• Aenderungen ohne Ihre Genehmigung vornehmen (bei sensiblen Operationen)
• Auf Systeme ausserhalb von Hydden zugreifen
• Sicherheitsexpertise fuer komplexe Entscheidungen ersetzen

---

Fehlerbehebung

KI-Assistent nicht verfuegbar

Wenn das Chat-Symbol nicht angezeigt wird:

• Stellen Sie sicher, dass die KI-Assistenten-Funktion fuer Ihren Mandanten aktiviert ist.
• Ueberpruefen Sie, ob ein KI-Anbieter konfiguriert ist.
• Bestaetigen Sie, dass Ihre Benutzerrolle die Berechtigung zur Nutzung des KI-Assistenten hat.

KI-Antworten sind nicht hilfreich

Wenn Antworten keinen Kontext oder keine Relevanz haben:

• Stellen Sie sicher, dass Sie einen Agenten mit einem geeigneten Systemprompt konfiguriert haben.
• Fuegen Sie eine Wissensdatenbank-Sammlung mit relevanter Dokumentation hinzu.
• Geben Sie spezifischeren Kontext in Ihren Prompts an.
• Formulieren Sie Ihre Frage mit mehr Details um.

Anbieter-Verbindungsfehler

Wenn Sie Verbindungsfehler erhalten:

• Stellen Sie sicher, dass Ihre API-Schluessel-Anmeldedaten korrekt und nicht abgelaufen sind.
• Ueberpruefen Sie, ob der Anbieterdienst verfuegbar ist.
• Ueberpruefen Sie die Ratenbegrenzungen und Nutzungskontingente des Anbieters.
• Versuchen Sie ein anderes Modell oder einen anderen Anbieter.

Sitzungsfehler

Wenn Sitzungen nicht gespeichert oder fortgesetzt werden koennen:

• Ueberpruefen Sie Ihre Netzwerkverbindung.
• Aktualisieren Sie die Seite und versuchen Sie es erneut.
• Ueberpruefen Sie die Sitzungsprotokolle auf Fehlerdetails.
• Kontaktieren Sie den Support, wenn das Problem weiterhin besteht.

---

Verwandte Themen

• KI-Assistent Ueberblick
• KI-Assistent fuer Universal Collector
• Universal-Datenquelle konfigurieren