> For the complete documentation index, see [llms.txt](https://help.vario-software.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.vario-software.de/vario-cloud-handbuch/einstellungen/kasse/kassen-oberflachen.md). # Kassen-Oberflächen Kassen-Oberflächen mit Widgets, Aktionskacheln und Schnellauswahl konfigurieren, exportieren, importieren und Kassen oder Benutzern zuordnen. Mit Kassen-Oberflächen passt Du den Kassenarbeitsplatz an Deinen Ablauf an. Du ordnest Widgets an, definierst Aktionskacheln und hinterlegst Schnellauswahlen. Öffne [**Einstellungen → Kasse → Kassen-Oberflächen**](https://help.vario-software.de/vario-cloud-handbuch/einstellungen/kasse/pages/tRTckhsjfcDaVrzQp7YH#id-3.-kassen-oberflachen-gestalten). Wähle eine vorhandene Oberfläche oder erstelle eine neue. Im Bearbeitungsmodus verschiebst Du Widgets per Drag-and-drop und speicherst anschließend die Oberfläche. {% hint style="info" %} **Hinweis** Lege für Desktop, Tablet und Smartphone eigene Layouts an. Welches Layout Du bearbeitest, richtet sich nach der Breite des Browserfensters: unter 800 Pixeln Smartphone, von 800 bis unter 1680 Pixeln Tablet, ab 1680 Pixeln Desktop. {% endhint %} ### Oberflächen verwalten Die Liste unter **Kassen-Oberflächen** zeigt **Bezeichnung**, **Beschreibung** und **Erstellt am** jeder Oberfläche. | Aktion | Wirkung | | -------------------------- | ----------------------------------------------------------------------------------------------------- | | **Oberfläche erstellen** | Öffnet die Kasse im Bearbeitungsmodus für eine neue Oberfläche. | | Klick auf eine Zeile | Öffnet die Oberfläche im Bearbeitungsmodus der Kasse. | | **Duplizieren** | Legt eine Kopie der markierten Oberflächen an. Die Bezeichnung erhält den Zusatz „\_clone“. | | **Exportieren** | Speichert jede markierte Oberfläche als JSON-Datei mit ihrer Bezeichnung als Dateiname. | | **Oberfläche importieren** | Legt aus einer exportierten JSON-Datei eine neue Oberfläche an. Die Datei darf bis zu 5 MB groß sein. | Löschen kannst Du nur Oberflächen, die Du bearbeiten darfst. Beim **Exportieren** öffnet sich der Dialog **Kassenoberfläche exportieren**: | Feld | Bedeutung | | ------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | | **Hinterlegte Selektionen mit exportieren** | Nimmt die Selektionen der Selektions-Buttons mit in die Datei auf. Standardmäßig ausgeschaltet. | | **Suffix für importierte Selektionen** | Zusatz für die Bezeichnung der Selektionen, die beim Import neu angelegt werden. Vorgabe ist „\_imported“. | Beim Import legt VARIO Cloud mitexportierte Selektionen als neue Selektionen an. Enthält die Datei keine Bezeichnung, erhält die Oberfläche den Dateinamen. Ist die Datei keine Kassen-Oberfläche, erscheint die Meldung „Die Datei ist keine gültige Kassenoberfläche“. ### Bearbeitungsmodus Im Bearbeitungsmodus zeigt die Kasse oben die Leiste **Oberfläche bearbeiten**: | Schaltfläche | Wirkung | | ------------------------------- | ----------------------------------------------------------------------------------------------- | | **Widget hinzufügen** | Fügt ein Widget in das aktuelle Layout ein. Bereits vorhandene Widgets sind ausgegraut. | | **Kundendisplay-Layout** | Öffnet den Editor für das Kundendisplay, siehe [Kundendisplay](#kundendisplay). | | **Logo / Branding** | Legt das Logo der Oberfläche fest, siehe [Branding](#branding). | | **Kundendisplay konfigurieren** | Öffnet die allgemeinen Einstellungen des Kundendisplays, siehe [Kundendisplay](#kundendisplay). | | **Speichern** | Öffnet den Dialog zum Speichern der Oberfläche. | | **Abbrechen** | Verwirft die Änderungen und kehrt zur Liste der Oberflächen zurück. | Ein Widget verschiebst Du am Griff oben links. Über die Ecke unten rechts änderst Du die Größe. Das Papierkorb-Symbol entfernt das Widget aus dem aktuellen Layout. Beim **Speichern** legst Du fest: | Feld | Bedeutung | | ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Bezeichnung** | Pflichtfeld. Name der Oberfläche. | | **Beschreibung** | Optionaler Text zur Oberfläche. | | **Zugriffsrechte für alle Benutzer** | **Individuell**, **Nur Lesen** oder **Lesen und Bearbeiten**. Neue Oberflächen stehen auf **Lesen und Bearbeiten**. | | **Benutzer (Nur Lesen)**, **Benutzergruppe (Nur Lesen)**, **Benutzer (Lesen und Bearbeiten)**, **Benutzergruppe (Lesen und Bearbeiten)** | Bei **Individuell** wählst Du, wer die Oberfläche nur lesen und wer sie bearbeiten darf. Bei **Nur Lesen** wählst Du nur, wer sie zusätzlich bearbeiten darf. | Mindestens ein Benutzer oder eine Benutzergruppe muss die Oberfläche bearbeiten dürfen. Nach dem Speichern erscheint „Oberfläche erfolgreich gespeichert“ und Du kehrst zur Liste zurück. ### Welche Oberfläche zeigt die Kasse? Eine Oberfläche hinterlegst Du an einer Kasse oder wählst sie in Deinen Benutzereinstellungen. Die Kasse prüft in dieser Reihenfolge: 1. **Benutzer:** In den Benutzereinstellungen wählst Du im Reiter **Kassen-Oberfläche** unter **Oberfläche auswählen** Deine bevorzugte Oberfläche. Mit **Keine Oberfläche (Standard)** entfällt die Auswahl. 2. **Kasse:** Im Feld **Kassen-Oberfläche** der Kasse hinterlegst Du die Oberfläche für alle Benutzer dieser Kasse ohne eigene Auswahl. Kassen richtest Du im Verkaufskanal vom Typ Kassen-Standort ein, siehe [Die Kasse einrichten](/vario-cloud-handbuch/verkaufskanaele/kasse/die-kasse-einrichten.md#schublade-und-zahlungsarten-zuordnen). 3. **Standard:** Ist nichts hinterlegt, zeigt die Kasse die Standard-Anordnung. ### Widgets der Kassen-Oberfläche | Widget | Zweck | | --------------- | ---------------------------------------------------------------------------- | | Aktionen | Enthält Funktions-, Such- und Selektionskacheln. | | Schnellauswahl | Bietet Artikel-, Varianten-Hauptartikel- und Texteingabe-Kacheln in Gruppen. | | Positionen | Zeigt die Artikelpositionen des aktuellen Vorgangs. | | Eingabefeld | Erfasst Artikelnummern, Barcodes und Eingabebefehle. | | Zusammenfassung | Zeigt Kunden-, Vorgangs- und Zahlungsinformationen. | | Nummernblock | Ermöglicht Eingaben über Bildschirmtasten. | | Letzte Belege | Listet Bons, Retouren und Kassenbewegungen. | | Letzter Beleg | Zeigt Daten des zuletzt abgeschlossenen Bons. | | Logo | Zeigt das für die Oberfläche hinterlegte Branding-Logo. |
Kasse im Bearbeitungsmodus mit der Leiste Oberfläche bearbeiten und den Standard-Widgets
Jedes Widget kann je Bildschirmansicht einmal eingefügt werden. ### Aktionskacheln Das Widget **Aktionen** bündelt häufig benötigte Kassenfunktionen. Wähle **Aktion hinzufügen**, um eine Kachel anzulegen. Über das Stift-Symbol bearbeitest Du eine vorhandene Kachel.
Menü Aktion hinzufügen im Widget Aktionen
Weitere Aktionen zur Oberfläche hinzufügen
#### Einstellungen einer Aktionskachel Die folgenden Einstellungen legst Du für jede Aktionskachel fest. Du bearbeitest sie beim Anlegen oder später über das Stift-Symbol der Kachel.
Aktionskacheln mit Stift-Symbol zum Bearbeiten
| Einstellung | Beschreibung | | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Beschriftung | Text auf der Kachel. Die Beschriftung ist erforderlich. | | Größe und Position | Verschiebe die Kachel im Raster. Ziehe sie auf die gewünschte Größe. | | Barcode | Barcode zum Auslösen einer Funktions- oder Selektionskachel. Er hat Vorrang vor der Artikelsuche. | | Icon | Optionales Symbol. Wähle ein vorgeschlagenes Symbol oder trage eine Font-Awesome-Klasse ein. | | Tastenkürzel | Funktionstaste oder Alt-Tastenkombination für Funktions- und Selektionskacheln. Klicke auf **Tastenkürzel aufnehmen** und drücke die Taste. **Esc** bricht ab, **Löschen** entfernt das Kürzel. | | Schriftgröße | Größe der Beschriftung von 8 bis 64 Pixeln. Vorgabe sind 14 Pixel. | | Schriftfarbe | Farbe für Beschriftung und Icon. | | Hintergrundfarbe | Hintergrundfarbe der Kachel. | | Vorschau | Zeigt die Kachel vor dem Speichern. |
Bearbeiten einer Aktionskachel mit Vorschau
{% hint style="warning" %} **Wichtig:** Ein Barcode einer Aktions- oder Selektionskachel hat Vorrang vor einem Artikelbarcode. Verwende daher keine identischen Codes. {% endhint %} Überschneidet sich das Tastenkürzel mit einem globalen Tastenkürzel, weist der Dialog darauf hin. #### Belegart festlegen Die Einstellung **Belegart** bestimmt die Belegart, wenn eine Aktion einen neuen Beleg erstellt. Ohne Auswahl verwendet die Kasse die Standard-Belegart. | Aktion | Verwendung der Belegart | | ------------- | ---------------------------------------------------------- | | Neuer Vorgang | Erstellt einen Kassenbon mit der gewählten Belegart. | | Einzahlung | Erstellt eine Kasseneinzahlung mit der gewählten Belegart. | | Auszahlung | Erstellt eine Kassenauszahlung mit der gewählten Belegart. | | Abschöpfung | Erstellt eine Abschöpfung mit der gewählten Belegart. | | Kunde wählen | Merkt die Belegart für den Bon nach der Kundenwahl vor. | Die Auswahl enthält nur passende Belegarten. Für einen neuen Vorgang stehen daher nur Kassenbon-Belegarten bereit. Alle anderen Aktionen haben keine Belegart-Einstellung. #### Typ für Einzahlung und Auszahlung vorauswählen Für **Einzahlung** und **Auszahlung** kannst Du zusätzlich einen Typ vorauswählen. Die Aktion öffnet dann direkt mit diesem Einzahlungs- oder Auszahlungstyp. Die Einstellung ist optional. ### Verfügbare Aktionen | Aktion | Funktion | | ------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | Kunde wählen | Öffnet die Adresssuche. Die gewählte Adresse wird Kunde des Vorgangs, auch vor der ersten Position. | | Artikel suchen | Öffnet die Artikelsuche. Alle ausgewählten Artikel kommen als Positionen in den Vorgang. | | Quittung suchen | Öffnet die Suche nach Kassenbelegen. Ein Klick auf einen Bon, eine Retoure oder eine Kassenbewegung lädt den Beleg in die Kasse. | | Kasse wechseln | Öffnet die Auswahl einer anderen Kasse. | | Vorgang abbrechen | Bricht den aktuellen Vorgang nach Bestätigung ab. | | Neuer Vorgang | Startet einen neuen leeren Kassenbon. | | Einzahlung | Erfasst eine Kasseneinzahlung. | | Auszahlung | Erfasst eine Kassenauszahlung. | | Abschöpfung | Erfasst eine Abschöpfung. | | Kassenabschluss | Startet den Kassenabschluss. | | Quittung parken | Legt den aktuellen Vorgang zur späteren Bearbeitung ab. | | Retoure | Startet eine neue Kassenretoure ohne Quellbon. | | Sofortstorno | Erstellt aus einem geladenen abgeschlossenen Bon eine Retoure. | | Nachdruck | Druckt einen geladenen abgeschlossenen Bon erneut. | | Beleg suchen | Öffnet offene Posten für den gewählten Kunden. | | Kundeneinzahlung | Erfasst Guthaben auf dem Kundenkonto. | | Preisauskunft | Öffnet die Preisauskunft. | | Selektions-Button | Öffnet eine gefilterte Artikel- oder Adressauswahl. | | Auto-Druck | Schaltet den automatischen Papierbon-Druck ein oder aus. | | Gutschein verkaufen | Startet den Gutscheinverkauf. | | Gutschein einlösen | Öffnet die Auswahl zum Einlösen eines Gutscheins. | Die Kachel **Auto-Druck** zeigt den aktuellen Zustand **an** oder **aus**. Sie übersteuert die Vorgabe **Papierbelege automatisch drucken** des Verkaufskanals nur für die aktuelle Kassenansicht. Beim Wechsel der Kasse oder Neuladen gilt wieder die Kanalvorgabe; die Einstellung am Verkaufskanal wird durch die Kachel nicht geändert. **Gutschein verkaufen** und **Gutschein einlösen** benötigen eine freigeschaltete Gutschein-Funktion. Andernfalls sind die Kacheln gesperrt und zeigen den Hinweis **„Gutscheine sind nicht freigeschaltet.“** Wie Du die Aktionen im täglichen Kassieren verwendest, erklärt [**Kassiervorgänge**](/vario-cloud-handbuch/verkaufskanaele/kasse/kassiervorgaenge.md). Dort findest Du auch den Unterschied zwischen **Beleg suchen** zum Bezahlen einer Forderung und **Kundeneinzahlung** zum Erfassen von Guthaben. Die Voraussetzungen für Kunden erklärt [Die Kasse einrichten](/vario-cloud-handbuch/verkaufskanaele/kasse/die-kasse-einrichten.md#kasse-und-kundenadresse-zuordnen). Welche Aktionen im laufenden Vorgang verfügbar sind, findest Du unter [Die Kasse im Überblick](/vario-cloud-handbuch/verkaufskanaele/kasse/die-kasse-im-uberblick.md#in-der-kasse-arbeiten). ### Selektions-Button Mit einem Selektions-Button öffnest Du eine Artikel- oder Adressauswahl direkt über eine Kachel. | Einstellung | Beschreibung | | -------------------------- | ------------------------------------------------------------- | | Selektionstyp | Wähle **Artikel** oder **Adressen**. | | Selektion | Optionale gespeicherte Selektion für die Auswahl. | | Kachelansicht als Standard | Nur für Artikel. Öffnet die Artikelauswahl als Kachelansicht. | | Barcode und Darstellung | Entspricht den allgemeinen Einstellungen einer Aktionskachel. |
Dialog eines Selektions-Buttons mit Selektionstyp, Barcode, Icon und Tastenkürzel
Aus einer Artikelauswahl kannst Du mehrere Artikel übernehmen. Eine ausgewählte Adresse wird als Kunde für den Vorgang übernommen. ### Schnellauswahl Die Schnellauswahl eignet sich für häufig verkaufte Artikel und wiederkehrende Eingaben. #### Gruppen verwalten Du kannst Gruppen hinzufügen, umbenennen und löschen. Jede Gruppe besitzt eigene Kacheln und eigene Anordnungen für Desktop, Tablet und Smartphone. Mindestens eine Gruppe muss bestehen bleiben. Eine neue Oberfläche beginnt mit der Gruppe „Gruppe 1“. Über das Plus-Symbol unter den Gruppen öffnest Du **Gruppe hinzufügen** und gibst den **Gruppennamen** ein. Mit einem Rechtsklick auf eine Gruppe wählst Du **Gruppe bearbeiten** oder **Gruppe löschen**. #### Artikel-Kachel erstellen 1. Wähle **Taste hinzufügen → Artikel hinzufügen**. 2. Suche und wähle den Artikel. 3. Passe die Beschriftung an und speichere die Kachel. Eine Artikel-Kachel verweist auf genau einen Artikel. Beim Antippen fügt die Kasse diesen Artikel zum aktuellen Vorgang hinzu. Über **Taste hinzufügen → Varianten-Hauptartikel hinzufügen** legst Du stattdessen eine Kachel für einen Varianten-Hauptartikel an. Sie öffnet die Variantenauswahl im Positionsbereich, ohne selbst eine Position zu erfassen. Die Auswahl enthält nur verkaufbare Varianten-Hauptartikel. #### Texteingabe-Kachel erstellen Wähle **Taste hinzufügen → Automatische Eingabe hinzufügen**. Hinterlege eine Beschriftung und den Text, den die Kasse wie eine Eingabe mit Enter verarbeiten soll. Für Mengen-, Preis- und Rabattbefehle muss das Widget **Eingabefeld** im jeweiligen Layout vorhanden sein. Für Artikel-, Varianten-Hauptartikel- und Texteingabe-Kacheln kannst Du Bild, Icon, Schriftgröße, Schriftfarbe und Hintergrundfarbe festlegen. | Bildmodus | Beschreibung | | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | Standard (Artikelbild) | Verwendet bei Artikel- und Varianten-Hauptartikel-Kacheln das Artikelbild. | | Eigenes Bild | Verwendet ein Bild aus dem DMS der eigenen Adresse. Über **Bild auswählen** öffnest Du die Auswahl, über **Hochladen** fügst Du neue Bilder hinzu. | | Kein Bild | Zeigt kein Bild. | Für Bilder stehen **Ausfüllen**, **Komplett sichtbar** und **Strecken** zur Verfügung. ### Weitere Widgets konfigurieren #### Positionen Im Bearbeitungsmodus öffnest Du über das Stift-Symbol des Widgets **Positionsdarstellung bearbeiten**. Unter **Felder** wählst Du die angezeigten Spalten. Auch aktive, sichtbare **Zusatzfelder der Belegposition** stehen zur Auswahl. Du kannst die Reihenfolge per Ziehen ändern, eigene Überschriften und eine **Breite** in Prozent hinterlegen oder Spalten entfernen. Neu ausgewählte Felder werden am Ende ergänzt. Lässt Du eine eigene Spaltenüberschrift leer, gilt die Standardbezeichnung. Für die **Breite** kannst Du **1 bis 100 Prozent** eintragen; ohne Angabe bestimmt die Kasse die Breite automatisch. Mindestens eine Spalte muss ausgewählt bleiben. Ohne eigene Spaltenkonfiguration verwendet die Kasse die Standardspalten für Position, Artikelnummer, Bezeichnung, Preis, Menge und Gesamtpreis. Bei Netto-Belegen erscheint zur Preisspalte zusätzlich der Brutto-Einzelpreis. **Standard wiederherstellen** setzt die Spaltenauswahl zurück. Bestätige den Dialog mit **OK** und speichere anschließend die **Oberfläche**. Die Spaltenkonfiguration wird mit der Oberfläche gespeichert und beim Export mitgenommen. Die Bedienung und den Positionsimport erklärt [**In der Kasse arbeiten**](/vario-cloud-handbuch/verkaufskanaele/kasse/die-kasse-im-uberblick.md#in-der-kasse-arbeiten). #### Eingabefeld und Nummernblock Die Bedienung von Eingabefeld und Nummernblock sowie die Mengen-, Preis- und Rabattbefehle erklärt [Die Kasse im Überblick](/vario-cloud-handbuch/verkaufskanaele/kasse/die-kasse-im-uberblick.md#in-der-kasse-arbeiten). Im Bearbeitungsmodus öffnest Du über das Stift-Symbol des Widgets **Eingabefeld bearbeiten**. Dort blendest Du mit **Knopf „Positionen importieren“ anzeigen** und **Knopf „Barcode-Scanner“ anzeigen** die beiden Knöpfe ein oder aus. Beide sind standardmäßig eingeschaltet. #### Letzte Belege und letzter Beleg Wie Du Belege filterst und lädst, erklärt [Die Kasse im Überblick](/vario-cloud-handbuch/verkaufskanaele/kasse/die-kasse-im-uberblick.md#letzte-belege-und-zusammenfassung). Hier legst Du fest, mit welchem Filter das Widget startet. Im Bearbeitungsmodus öffnest Du über das Stift-Symbol des Widgets **Letzte Belege bearbeiten**. Unter **Standard-Filter** wählst Du **Alle**, **Bons**, **Bewegungen** oder **Eröffnung & Abschluss**. Vorgabe ist **Alle**. Mit **Nur geparkte Belege** zeigt das Widget ausschließlich geparkte Bons. #### Branding Über **Logo / Branding** hinterlegst Du das Logo der Oberfläche. | Feld | Bedeutung | | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | **Firmenlogo** | Mit **Logo auswählen** wählst Du ein Bild aus dem DMS der eigenen Adresse. **Löschen** entfernt das Logo wieder. | | **Darstellung** | **Einpassen (contain)** zeigt das Logo vollständig, **Ausfüllen (cover)** füllt die Fläche und schneidet zu. Gilt für das Widget **Logo**. | | **Wo soll das Logo erscheinen?** | **In der Statusleiste** und **Im leeren Bon (zwischen zwei Vorgängen)**. Beide sind standardmäßig eingeschaltet. | Ist noch kein Logo gewählt, schlägt der Dialog das Logo aus **Kundendisplay konfigurieren** vor. ### Kundendisplay Das Kundendisplay ist ein eigenes Fenster, das Deinen Kunden den laufenden Vorgang zeigt, z. B. auf einem zweiten Bildschirm. **Kundendisplay-Layout** öffnet in einem neuen Fenster den Editor **Kundendisplay bearbeiten**. Für jede Phase ordnest Du eigene Widgets an: | Phase | Das Display zeigt sie, … | | ------------- | ----------------------------------------- | | **Start** | solange der Vorgang keine Positionen hat. | | **Kauf** | sobald der Vorgang Positionen enthält. | | **Zahlung** | während der Zahlung. | | **Abschluss** | nach dem Abschluss des Vorgangs. | Über **Widget** fügst Du Logo, Begrüßung, Text, Bild, Uhr, Positionen, Zwischensumme, Zu zahlen, Rückgeld, Danke, Kunde, Zahlungs-Hinweis, Video und Bon-QR-Code hinzu. Inhalt und Aussehen der meisten Widgets bearbeitest Du über ihr Stift-Symbol. **Übernehmen** übergibt das Layout an die Oberfläche. Gespeichert wird es, wenn Du die Oberfläche speicherst. **Kundendisplay konfigurieren** enthält allgemeine Einstellungen, die lokal im Browser gespeichert werden. Sie werden separat vom Layout der Kassen-Oberfläche gespeichert: | Feld | Bedeutung | | ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- | | **Logo** | Logo für das Kundendisplay. Du wählst es über **Logo auswählen**. | | **Begrüßungstext** | Text für das Widget Begrüßung, wenn dort kein eigener Text steht. | | **Dankestext** | Text für das Widget Danke, wenn dort kein eigener Text steht. | | **Akzentfarbe** | Farbe für Hervorhebungen im Kundendisplay. | | **Idle-Timeout nach Beleg-Abschluss (Sekunden)** | Danach springt das Display zurück auf den Start, falls nicht vorher der nächste Vorgang beginnt. Vorgabe sind 20 Sekunden. | | **Bildschirme** | Braucht der Browser eine Freigabe, erlaubst Du mit **Bildschirme freigeben** einmalig, das Kundendisplay auf dem Kundenbildschirm zu öffnen. | --- # 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://help.vario-software.de/vario-cloud-handbuch/einstellungen/kasse/kassen-oberflachen.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.