> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/de/systemadministration/advanced-system-settings.md).

# Erweiterte Systemeinstellungen

Referenz für alle erweiterten Systemeinstellungen in VergeOS, einschließlich NTP, SMART-Schwellenwerte, Sitzungstimeouts, MAC-Präfix, Migrationssteuerung, Zwei-Faktor-Authentifizierung und vSAN-Konfiguration.

Diese Einstellungen finden Sie unter ***System > Einstellungen > Erweitert***.

{% hint style="danger" %}
**Vorsicht bei erweiterten Einstellungen**

Diese Einstellungen sollten nur von erfahrenen Administratoren oder unter direkter Anleitung des VergeIO-Supports geändert werden. Änderungen können das Systemverhalten und die Leistung erheblich beeinflussen. Immer:

1. Vor Änderungen die Auswirkungen vollständig verstehen
2. Änderungen zuerst in einer Nicht-Produktionsumgebung testen
3. Alle Änderungen für spätere Referenz dokumentieren
4. Einen Rollback-Plan bereithalten

Für detaillierte Informationen zu diesen Einstellungen und ihren Auswirkungen wenden Sie sich bitte an den VergeIO-Support.
{% endhint %}

{% hint style="info" %}
**Einige Einstellungen können leer sein, wenn sie nicht konfiguriert sind.**
{% endhint %}

| Einstellung                                                                                                                  | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                    | Standardwert                             |
| ---------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- |
| ***Automatisch nach Katalogaktualisierungen suchen***                                                                        | Intervall (in Stunden), in dem Rezeptkataloge automatisch auf Änderungen geprüft werden.                                                                                                                                                                                                                                                                                                                        | 24                                       |
| ***System-Snapshot-Profil***                                                                                                 | Snapshot-Profil, das für System-Snapshots verwendet werden soll. Das Profil „System Snapshots“ wird während der Installation automatisch erstellt. Sie können dieses enthaltene Profil ändern oder hier ein anderes Profil auswählen.                                                                                                                                                                           | System Snapshots                         |
| ***Kontakt-E-Mail für die Verarbeitung von Offline-/Air-Gap-Lizenzdateien***                                                 | E-Mail-Adresse, die für die Verarbeitung von Lizenzdateien in Offline- oder Air-Gap-Umgebungen verwendet wird.                                                                                                                                                                                                                                                                                                  | <license@verge.io>                       |
| ***Tag des Monats zum Erstellen des Abrechnungsberichts***                                                                   | Gibt den Tag jedes Monats an, an dem das System Abrechnungsberichte erstellt.                                                                                                                                                                                                                                                                                                                                   | 1                                        |
| ***Standard-VM-Laufwerkstier***                                                                                              | Legt das standardmäßige Speichertier für neue VM-Laufwerke fest. Höhere Tiers bieten in der Regel eine bessere Leistung.                                                                                                                                                                                                                                                                                        | 4                                        |
| ***Standard-Cluster für VMs***                                                                                               | Gibt den Standard-Cluster an, in dem neue VMs erstellt werden, sofern nicht anders angegeben.                                                                                                                                                                                                                                                                                                                   |                                          |
| ***Standard-Cluster für VMware-Service-Container***                                                                          | Legt den Standard-Cluster für neue VMware-Service-Container-Bereitstellungen fest.                                                                                                                                                                                                                                                                                                                              |                                          |
| ***Standard-Cluster für Netzwerke***                                                                                         | Legt den Standard-Cluster für neue Netzwerkerstellungen fest.                                                                                                                                                                                                                                                                                                                                                   |                                          |
| ***Standard-Cluster für Tenant-Knoten***                                                                                     | Gibt den Standard-Cluster für neue Zuweisungen von Tenant-Knoten an.                                                                                                                                                                                                                                                                                                                                            |                                          |
| ***Standard-MTU des externen Netzwerks***                                                                                    | Legt die standardmäßige Maximum Transmission Unit (MTU)-Größe für externe Netzwerke fest.                                                                                                                                                                                                                                                                                                                       | 1500                                     |
| ***Standard-Failover-Cluster für VMs***                                                                                      | Legt den sekundären Cluster für das VM-Failover fest, falls der primäre Cluster nicht verfügbar wird.                                                                                                                                                                                                                                                                                                           |                                          |
| ***Standard-Failover-Cluster für VMware-Container***                                                                         | Gibt den Backup-Cluster für das VMware-Container-Failover an.                                                                                                                                                                                                                                                                                                                                                   |                                          |
| ***Standard-Failover-Cluster für Netzwerke***                                                                                | Legt den sekundären Cluster für das Netzwerk-Failover fest.                                                                                                                                                                                                                                                                                                                                                     |                                          |
| ***Standard-Failover-Cluster für Tenant-Knoten***                                                                            | Legt den Backup-Cluster für das Tenant-Knoten-Failover fest.                                                                                                                                                                                                                                                                                                                                                    |                                          |
| ***Standard-MTU des internen Netzwerks***                                                                                    | Ändert die Standard-MTU aller erstellten internen Netzwerke                                                                                                                                                                                                                                                                                                                                                     | 9000                                     |
| ***Standard-Adresse des internen Netzwerks***                                                                                | Ändert das standardmäßige Netzadressierungsschema aller erstellten internen Netzwerke                                                                                                                                                                                                                                                                                                                           | 192.168.0.0/24                           |
| ***Standard-Mediendatei-Tier***                                                                                              | Legt das standardmäßige Speichertier fest, das zum Speichern hochgeladener Dateien verwendet wird                                                                                                                                                                                                                                                                                                               | 4                                        |
| ***Standard-Tenant-Netzwerkadresse***                                                                                        | Eine Änderung der standardmäßigen Netzadressierung wird normalerweise nicht empfohlen. Arbeiten Sie eng mit dem VergeOS-Support zusammen, um Änderungen an der Netzadressierung umzusetzen.                                                                                                                                                                                                                     | 100.96.255.0/24                          |
| ***IPv6 aktivieren***                                                                                                        | IPv6-Verkehr in und aus dem System wird standardmäßig blockiert. Diese Einstellung muss nicht geändert werden, um internen VM-zu-VM-IPv6-Verkehr zu erlauben.                                                                                                                                                                                                                                                   | false                                    |
| ***Fehlgeschlagene Anmeldeversuche, bevor ein Konto gesperrt wird (0 deaktiviert die Sperrung)***                            | Gibt die Anzahl aufeinanderfolgender fehlgeschlagener Anmeldeversuche an, die erlaubt sind, bevor ein Konto vorübergehend gesperrt wird. Wenn dieser Wert auf 0 gesetzt wird, wird die Sperrfunktion deaktiviert. Hinweis: VergeOS verfügt über einen integrierten Schutz gegen Brute-Force-Angriffe. Mit Vorsicht aktivieren, da aggressive Sperren potenziell zu Denial-of-Service-Situationen führen können. | 0                                        |
| ***Datenbank des Anwendungs-Frameworks alle X ms leeren***                                                                   | **Ändern Sie diese Einstellung nicht, es sei denn, Sie werden ausdrücklich vom VergeIO-Support dazu angewiesen**                                                                                                                                                                                                                                                                                                | 5000                                     |
| ***Historische Langzeitstatistiken laufen alle X Sekunde(n) ab***                                                            | Die Standardwerte für die Ablaufzeit historischer Statistiken sind für Berechnungen/ Berichte auf das 95. Perzentil optimiert. Der Standardwert für den Ablauf von Langzeitstatistiken erlaubt mehr als 30 Tage, damit monatliche Daten verfügbar sind.                                                                                                                                                         | 3888000                                  |
| ***Historische Kurzzeitstatistiken laufen alle X Sekunde(n) ab***                                                            | Die Standardwerte für die Ablaufzeit historischer Statistiken sind für Berechnungen auf das 95. Perzentil optimiert                                                                                                                                                                                                                                                                                             | 300                                      |
| ***Liste der NTP-Server, mit denen die Zeit synchronisiert werden soll (durch Leerzeichen getrennt)***                       | time.nist.gov 0.pool.ntp.org 1.pool.ntp.org 2.pool.ntp.org 3.pool.ntp.org                                                                                                                                                                                                                                                                                                                                       |                                          |
| ***Kopfzeile des Anmelde-Banners***                                                                                          | Legt den Kopfzeilentext fest, der im Banner der Anmeldeseite angezeigt wird. Kann verwendet werden, um organisatorische oder sicherheitsrelevante Hinweise anzuzeigen.                                                                                                                                                                                                                                          |                                          |
| ***Text des Anmelde-Banners***                                                                                               | Definiert den Haupttext, der im Banner der Anmeldeseite angezeigt wird. Wird typischerweise für rechtliche Hinweise, Nutzungsrichtlinien oder systemspezifische Hinweise verwendet.                                                                                                                                                                                                                             |                                          |
| ***MAC-Adresspräfix für Maschinen-NICs***                                                                                    | Standard ist das von Verge.io (auch Yottabyte) registrierte OUI-IEEE-Präfix. VergeOS verwendet dieses OUI plus eine System-ID, um eindeutige MAC-Adressen sicherzustellen.                                                                                                                                                                                                                                      | F0:DB:30                                 |
| ***MSS (Maximale Segmentgröße) der Standardroute des Kernnetzwerks (bei einer MTU von 1500 auf 1460 gesetzt)***              | **Ändern Sie diese Einstellung nicht, es sei denn, Sie werden ausdrücklich vom VergeIO-Support dazu angewiesen**                                                                                                                                                                                                                                                                                                | 1460                                     |
| ***Zeitüberschreitung für den Stromzyklus bei Maschinenmigration***                                                          | Gibt die maximale Zeit (in Sekunden) an, die das System während der Migration auf eine nicht reagierende VM wartet, bevor ein Stromzyklus eingeleitet wird. Dies hilft zu verhindern, dass Migrationsprozesse unbegrenzt hängen bleiben.                                                                                                                                                                        | 1800                                     |
| ***Drosselung der Migrationsgeschwindigkeit für Maschinen (Byte/s)***                                                        | Legt die maximale Datenübertragungsrate für VM-Migrationen fest. Dies hilft, die Migrationsgeschwindigkeit mit der Netzleistung für andere Vorgänge auszubalancieren. Der Standardwert erlaubt ungefähr 1 GB/s.                                                                                                                                                                                                 | 1048576000                               |
| ***Maximale gleichzeitige Maschinenmigrationen***                                                                            | Begrenzt die Anzahl der VM-Migrationen, die gleichzeitig clusterweit stattfinden können. Dies hilft, die Ressourcennutzung während Migrationsvorgängen zu steuern.                                                                                                                                                                                                                                              | 1                                        |
| ***Maximale gleichzeitige Netzwerkmigrationen***                                                                             | Legt die maximale Anzahl von Netzwerkmigrationen fest, die gleichzeitig ausgeführt werden können. Dies hilft, die Ressourcennutzung während Netzwerk-Failover- oder Rebalancing-Vorgängen zu steuern.                                                                                                                                                                                                           | 10                                       |
| ***Maximal geschätzte Snapshots pro Profil (0 zum Deaktivieren der Warnung)***                                               | Definiert den Schwellenwert für die Anzahl der Snapshots in einem Profil, bevor eine Warnung ausgelöst wird. Dies hilft, die Speichernutzung und die Vermehrung von Snapshots zu steuern. Bei 0 wird die Warnung deaktiviert.                                                                                                                                                                                   | 200                                      |
| ***Maximale Anzahl von VXLAN-FDB-Einträgen (jede Änderung außer 0 kann zu verworfenen Paketen führen)***                     | Begrenzt die Anzahl der Einträge in der VXLAN Forwarding Database. Eine Änderung von 0 (unbegrenzt) kann die Netzwerkleistung beeinträchtigen und sollte nur mit Vorsicht vorgenommen werden.                                                                                                                                                                                                                   | 0                                        |
| ***Minuten, für die ein Konto gesperrt wird***                                                                               | Gibt die Dauer (in Minuten) an, für die ein Benutzerkonto nach Überschreiten der Anzahl fehlgeschlagener Anmeldeversuche gesperrt bleibt. Dies hilft, vor Brute-Force-Angriffen zu schützen.                                                                                                                                                                                                                    | 15                                       |
| ***Domänenname für diese Cloud***                                                                                            | Dieses Feld bietet eine Überschreibung für die ansonsten standardmäßige, aus dem System-SSL-Zertifikat extrahierte Domäne                                                                                                                                                                                                                                                                                       |                                          |
| ***Name dieser Cloud***                                                                                                      | Name zur Identifizierung dieses Systems. Dieser Cloud-Name wird in der Benutzeroberfläche und in Berichten/Alarmen angezeigt, die über Abonnements gesendet werden. Der Cloud-Name identifiziert das System außerdem in Synchronisierungsaufträgen.                                                                                                                                                             | \*bei der Installation festgelegter Name |
| ***Physisches Netzwerk für neue Tenants überschreiben (172.17.0.0/24)***                                                     | **Ändern Sie diese Einstellung nicht, es sei denn, Sie werden ausdrücklich vom VergeIO-Support dazu angewiesen**                                                                                                                                                                                                                                                                                                |                                          |
| ***Anforderung an die Passwortkomplexität***                                                                                 | Zu den Optionen gehören Anforderungen an Kleinbuchstaben, Großbuchstaben, Zahlen und Symbole; Mindestlänge; Erzwingen von Passwortzurücksetzungen (alle Benutzer); jede Kombination von Optionen kann ausgewählt werden.                                                                                                                                                                                        | Länge: 8                                 |
| ***Remote-Syslog-Server (tcp: @@ Name/IP:Port, udp: @ Name/IP:Port)***                                                       | Syslog-Server für den Log-Export angeben                                                                                                                                                                                                                                                                                                                                                                        |                                          |
| ***Maximale SMART-Stunden, die ein Laufwerk erreichen kann, bevor eine Warnung ausgegeben wird***                            | Legt die maximale Betriebszeit (Einschaltstunden) für ein Laufwerk fest, bevor ein **"HD-Warnung - Stunden überschreiten den maximalen Schwellenwert"** Alarm ausgelöst wird. Standardwert ist 43800 Stunden (5 Jahre); der Maximalwert beträgt 87600 Stunden (10 Jahre). Zusätzliche Informationen zu *SMART max Stunden* unten.                                                                               | 43800                                    |
| ***Maximale Anzahl aktueller ausstehender Sektoren, die ein Laufwerk haben kann, bevor eine Warnung ausgegeben wird***       | Definiert den Schwellenwert für ausstehende Sektoren (Sektoren, die auf eine Neuzuordnung warten), bevor eine Warnung ausgegeben wird. Weist auf mögliche Laufwerksprobleme hin.                                                                                                                                                                                                                                | 1                                        |
| ***Maximale Anzahl offline nicht korrigierbarer Sektoren, die ein Laufwerk haben kann, bevor eine Warnung ausgegeben wird*** | Gibt die maximale Anzahl von Sektoren an, die bei Offline-Tests nicht gelesen werden konnten, bevor eine Warnung ausgelöst wird. Weist auf ernsthafte Laufwerksprobleme hin.                                                                                                                                                                                                                                    | 1                                        |
| ***Maximale Anzahl neu zugewiesener Sektoren, die ein Laufwerk haben kann, bevor eine Warnung ausgegeben wird***             | Legt die Grenze für neu zugewiesene Sektoren (schlechte Sektoren, die ersetzt wurden) fest, bevor eine Warnung ausgegeben wird. Weist auf eine Verschlechterung des Laufwerks hin.                                                                                                                                                                                                                              | 1                                        |
| ***Maximale Temperatur (Celsius), die ein Laufwerk erreichen kann, bevor eine Warnung ausgegeben wird***                     | Definiert die maximale Temperatur, die ein Laufwerk erreichen kann, bevor eine Temperaturwarnung ausgelöst wird. Hilft, hitzebedingte Ausfälle zu verhindern.                                                                                                                                                                                                                                                   | 51                                       |
| ***Maximaler Verschleiß (Prozent), den ein Laufwerk erreichen kann, bevor eine Warnung ausgegeben wird***                    | Gibt den maximalen Verschleißgrad (in Prozent) für SSDs an, bevor eine Warnung ausgegeben wird. Hilft, die Lebensdauer von SSDs zu überwachen.                                                                                                                                                                                                                                                                  | 95                                       |
| ***SMART-Wert in Minuten: wie oft Diagnosen auf physischen Laufwerken ausgeführt werden***                                   | Legt die Häufigkeit der SMART-Diagnoseprüfungen auf physischen Laufwerken fest. Regelmäßige Prüfungen helfen, potenzielle Laufwerksprobleme frühzeitig zu erkennen.                                                                                                                                                                                                                                             | 30                                       |
| ***Sitzungsablauf (Sekunden)***                                                                                              | Dauer, bevor ein Benutzer automatisch abgemeldet wird und sich erneut anmelden muss.                                                                                                                                                                                                                                                                                                                            | 259200                                   |
| ***Zeitüberschreitung bei Sitzungsinaktivität (Sekunden)***                                                                  | Dauer (während der der Benutzer inaktiv ist), bevor er automatisch abgemeldet wird                                                                                                                                                                                                                                                                                                                              | 86400                                    |
| ***System-ID***                                                                                                              | WARNUNG: Das Ändern Ihrer System-ID wirkt sich auf Ihre VergeOS-Lizenz aus und kann dazu führen, dass das System keine Workloads mehr ausführen kann.                                                                                                                                                                                                                                                           | *variiert*                               |
| ***System-Snapshot-Profil***                                                                                                 | Gibt das Snapshot-Profil an, das für Snapshots auf Systemebene verwendet werden soll. Das Profil „System Snapshots“ wird während der Installation automatisch erstellt. Sie können dieses enthaltene Profil ändern oder hier ein anderes Profil auswählen.                                                                                                                                                      | System Snapshots                         |
| ***TCP-MTU-Probing (0: deaktiviert, 1: deaktiviert, aber aktiviert, wenn erkannt, 2: aktiviert)***                           | Steuert die TCP Maximum Transmission Unit (MTU) Path Discovery. Wenn aktiviert (2), prüft das System aktiv, um die optimale MTU-Größe für TCP-Verbindungen zu ermitteln, was hilft, Paketfragmentierung zu verhindern. Einstellung 1 deaktiviert das Probing, aktiviert es jedoch, wenn ICMP-Blackholes erkannt werden.                                                                                         | 2                                        |
| ***Vorlage für den Syslog-Server definieren (siehe rsyslog für das Format)***                                                | Konsultieren *rsyslog* Dokumentation zur korrekten Eingabesyntax.                                                                                                                                                                                                                                                                                                                                               |                                          |
| ***Zeitüberschreitung in Sekunden, bevor eine Maschine nicht mehr reagiert***                                                | Schwellenzeit, nach der das System eine VM als nicht reagierend einstuft und versucht, die VM auf einem alternativen Knoten zu starten                                                                                                                                                                                                                                                                          | 120                                      |
| ***Zeitüberschreitung in Sekunden, bevor ein nicht reagierender Knoten über IPMI neu gestartet wird***                       | Gibt die Dauer an, die das System wartet, bevor ein nicht reagierender Knoten automatisch über IPMI neu gestartet wird. Erfordert eine korrekte IPMI-Konfiguration.                                                                                                                                                                                                                                             | 3600                                     |
| ***Zwei-Faktor-Authentifizierung***                                                                                          | Bestimmt die standardmäßige Einstellung für die Zwei-Faktor-Authentifizierung (2FA) für neue Benutzer. Optionen sind „Standardmäßig ein“ (standardmäßig aktiviert) oder „Standardmäßig aus“ (standardmäßig deaktiviert).                                                                                                                                                                                        | Standardmäßig aus                        |
| ***Ablaufzeit der Zwei-Faktor-Authentifizierung für authentifizierte Benutzergeräte***                                       | Legt die Dauer (in Sekunden) fest, für die ein Gerät für 2FA authentifiziert bleibt. Auf 0 setzen für kein Ablaufdatum.                                                                                                                                                                                                                                                                                         | 7884000                                  |
| ***Ablaufzeit der Zwei-Faktor-Authentifizierung für temporäre Codes***                                                       | Definiert die Gültigkeitsdauer (in Sekunden) für temporäre 2FA-Codes.                                                                                                                                                                                                                                                                                                                                           | 300                                      |
| ***Maximale API-Befehle des Webservers***                                                                                    | Begrenzt die maximale Anzahl von API-Befehlen, die gleichzeitig verarbeitet werden können.                                                                                                                                                                                                                                                                                                                      | 50                                       |
| ***Maximale Verbindungen des Webservers***                                                                                   | Legt die maximale Anzahl gleichzeitiger Verbindungen zum Webserver fest.                                                                                                                                                                                                                                                                                                                                        | 500                                      |
| ***Maximales API-Ratenlimit pro Webserver-Sitzung***                                                                         | Beschränkt die Anzahl der API-Anfragen, die eine einzelne Sitzung innerhalb eines kurzen Zeitraums stellen kann.                                                                                                                                                                                                                                                                                                | 50                                       |
| ***vSAN-Host/IP-Überschreibung***                                                                                            | Gibt einen alternativen Host oder eine alternative IP-Adresse für vSAN-Vorgänge an, insbesondere für eingehende Standort-Synchronisierungen.                                                                                                                                                                                                                                                                    |                                          |
| ***Maximale vSAN-Auslastung in Prozent***                                                                                    | Legt den maximal zulässigen Auslastungsprozentsatz für vSAN-Speicher während eingehender Standort-Synchronisierungen fest.                                                                                                                                                                                                                                                                                      | 90                                       |

{% hint style="info" %}
**SMART max hours — eine Alterswarnung, kein Fehler**

Die Warnung „HD-Warnung - Stunden überschreiten den maximalen Schwellenwert“ bedeutet, dass die kumulierten Einschaltstunden eines Laufwerks den SMART-max-hours-Schwellenwert überschritten haben. Es ist ein Altersindikator, kein SMART-Gesundheitsfehler — ein Laufwerk kann null neu zugewiesene oder ausstehende Sektoren haben und diese Warnung dennoch auslösen.

Ein häufiger Auslöser sind gebrauchte oder erneut eingesetzte Laufwerke: Die Einschaltstunden gehören dem Laufwerk selbst, nicht dem Cluster, sodass Laufwerke mit vorheriger Betriebszeit diese Historie in eine neue Bereitstellung mitbringen.

Zur Behebung:

Wenn die Laufwerke gesund sind (SMART-Status OK, keine neu entstandenen Defekte): Erhöhen Sie SMART max hours über den aktuellen Wert der Laufwerke, um die Warnung zu unterdrücken. Das Feld ist auf 87.600 Stunden (10 Jahre) begrenzt; ein höherer Wert führt zu einem Validierungsfehler.

**Für HDDs:** sehr hohe Einschaltstunden erhöhen die Wahrscheinlichkeit eines plötzlichen mechanischen Ausfalls, selbst wenn SMART keine neu zugewiesenen oder ausstehenden Sektoren anzeigt. Für kritische Workloads sollten Sie eine Laufwerksaktualisierung planen. Ersetzen Sie jeweils nur ein Laufwerk und lassen Sie vSAN vollständig neu aufbauen, bevor Sie das nächste Laufwerk entfernen, um die Redundanz zu erhalten.

**Für SSDs:** hohe Einschaltstunden allein sind kein Zuverlässigkeitsproblem. Der Verschleiß von SSDs wird durch die Schreibbelastbarkeit bestimmt, nicht durch die Einschaltzeit. Verlassen Sie sich bei der Beurteilung des SSD-Zustands auf SMART-Verschleißindikatoren (z. B. Prozent verwendet, Media Wearout Indicator) und nicht auf die Stunden.

**Bestätigen Sie den SMART-Status auf jedem Laufwerk unabhängig, bevor Sie die Warnung ignorieren.**
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/run-the-platform/de/systemadministration/advanced-system-settings.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
