> For the complete documentation index, see [llms.txt](https://docs.enate.net/whats-new/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enate.net/whats-new/dede/altere-versionen/anderungsubersicht-altere-versionen/2021.2-uberblick-uber-veranderungen/mit-verknupften-arbeitsauftragen-arbeiten.md). # Mit verknüpften Arbeitsaufträgen arbeiten v2021.2 Mit einigen Funktionen in Enate können Sie Aktivitäten überwachen, die von verschiedenen Teams ausgeführt werden. Sie können ganz einfach Arbeitsaufträge erstellen und beaufsichtigen, dies sogar dann, wenn Sie nicht die volle Berechtigung für einen Auftrag haben. {% embed url="" %} Sie können: * Arbeitsaufträge erstellen und miteinander verknüpfen, auch solche in Geschäftsbereichen, für die Sie keine Berechtigung haben. * Kommunikationen zwischen diesen Arbeitsaufträgen teilen und hinzufügen. Wenn man einen Fall oder ein Ticket in einem schon existierenden Fall oder Ticket startet, dann werden diese beiden miteinander ‚verknüpft‘ — Aufträge, die so erstellt werden, behalten die Verknüpfung zum Orginalfall/Ticket, der in einem ‚Verknüpft‘-Tab angezeigt wird. Dies erleichtert die Verfolgung von einer Arbeitsauftrags-Gruppe, die miteinander verknüpft sind. Schauen wir uns ein paar dieser Funktionen an, angefangen damit, wie man Arbeitsaufträge verknüpft... ## Ein verknüpftes Ticket erstellen Um ein verknüpftes Ticket von einem schon existierenden Fall oder Ticket aus zu erstellen, dann klicken sie auf den ‚+ Arbeitsauftrag‘ Link und wählen Sie die ‚Ticket‘-Möglichkeit vom Dropdown-Menü aus.
![](https://3283538894-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrbXnyVXyGRZjCB5N5zoM%2Fuploads%2FgNYry4ZnKNHe3zi1WshU%2Fimage.png?alt=media\&token=a9683e78-bf1e-4bd6-853b-1ded655bc46f) In dem darauffolgenden Pop-Up können Sie auf zwei verschiedene Arten nach dem neuen Ticket-Prozess filtern: * Indem Sie nach einer E-Mail-Route suchen — Sie können die E-Mailbox-Adresse angeben, an die Personen normalerweise E-Mails senden würden, um Arbeitsaufträge zu erstellen. Meist repräsentiert die E-Mail-Mailbox einen gewissen Bereicht des Unternehmens, in dem Sie den neuen Arbeitsauftrag erstellen wollen. Wir haben eine Funktion hinzugefügt, mit der Sie nach der Mailbox suchen und sofort den Ticket-Prozess, von dem Sie auswählen, einschränken können. Durch die Auswahl einer Mailbox werden Dropdown-Möglichkeiten herausgefiltert, bei denen nur Prozesse angezeigt werden, die mit dieser Mailbox verlinkt sind. * Indem Sie einen Kunden, Vertrag, eine Dienstleistung oder einen Ticketprozess zum Starten auswählen (diese werden in Werten vorbelegt, wenn nur eine Option zur Auswahl steht). ![](https://3283538894-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrbXnyVXyGRZjCB5N5zoM%2Fuploads%2F1frpgUxbFfqtrYEGQOvg%2Fimage.png?alt=media\&token=2c4c1e27-7c3b-4171-b75a-30ee3e1db423) {% hint style="info" %} Bitte beachten Sie, dass die Verfügbarkeit des Tickets von den Befugnissen im Builder abhängt. Zusätzlich werden Sie auch nur einen Ticket-Prozess von einer E-Mail-Route auswählen können, wenn diese im Builder aktiviert wurde ([klicken Sie hier für weitere Informationen](https://docs.enate.net/enate-help/builder/builder-2021.1/email-mailbox-configuration/email-routes-detail)). Sie werden nur den Ticket-Prozess im [Testmodus ](https://docs.enate.net/enate-help/v/deutsch/testmodus)auswählen können, wenn die E-Mail-Route für diesen Ticket-Prozess im [Testmodus ](https://docs.enate.net/enate-help/v/deutsch/testmodus)zum Start konfiguriert wurde. {% endhint %} Sie können die folgenden Einstellungen für das Ticket einstellen: | Titel |

Sie können den Titel des neuen Tickets bearbeiten

| | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | |

Beschreibung

| Sie können die Beschreibung des neuen Tickets bearbeiten | |

Kategorie & Unter-Kategorie

| Sie müssen die Kategorie & Unter-Kategorie des neuen Tickets auswählen | |

Fälligkeitsdatum überschreiben

| Wenn Ihr System so konfiguriert wurde ([klicken Sie hier für weitere Informationen](https://docs.enate.net/enate-help/builder/builder-2021.1/shared-standardised-settings-flavours/due-date-flavours#overview)), dann können Sie „Fälligkeitsdatum überschreiben“ für das neue Ticket, das Sie erstellen, auswählen. | |

Fehler, Dateien und angepasste Daten kopieren

| Sie können bereits existierende Fehler, Dateien (mit Tags) und angepasste Daten vom Originalfall/-Ticket mit dem neuen Ticket, das Sie erstellen, teilen. | |

Arbeitsauftrags-Kommunikationen kopieren

| Sie können Arbeitsauftrags-Kommunikationen, z.B. E-Mails (darunter E-Mail-Anhänge) und Notizen von dem OriginalFall/-Ticket und dem neuen Ticket, das sie erstellen, teilen. Bitte beachten Sie, dass Sie bei der Erstellung eines Tickets von einem Fall aus nur die Kommunikationen auf Fall-Ebene teilen werden. Hier gibt es keine Aktionstyp-Kommunikationen oder Unterfallkommunikationen. Sie können einzelne Aktions- oder Unterfallkommunikationen kopieren, indem Sie einzelne E-Mails/Notizen vom [Kommunikations-Verlauf](https://docs.enate.net/enate-help/v/deutsch/bildschirme-alle-arbeitsauftrags-typen/hauptabschnitt) teilen. | |

Automatisierte E-Mails deaktivieren

| Sie können automatisierte E-Mails an Kontake senden, die als Hauptkontakt, Antragsteller/in oder Subjekt eingestellt sind. | |

Kontakte hinzufügen

| Wenn die [Befugnisse im Builder](https://docs.enate.net/enate-help/builder/builder-2021.1/user-management/permissions) so konfiguriert sind, dann können Sie mehrere verschiedene Kontakte zu einem neuen Ticket hinzufügen und die Tags zwischen Ihnen teilen. | ![](https://3283538894-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrbXnyVXyGRZjCB5N5zoM%2Fuploads%2FLhsVSGxwoJncjPuPEplq%2Fimage.png?alt=media\&token=e6fc2348-ca7e-443f-b510-dc2941c3cd58) Klicken Sie dann auf ‚Erstellen‘. Eine neue Verknüpfung zum verknüpften Ticket wird im [‚Verknüpft‘-Tab](/whats-new/dede/altere-versionen/anderungsubersicht-altere-versionen/2021.2-uberblick-uber-veranderungen/mit-verknupften-arbeitsauftragen-arbeiten.md#verknuefte-arbeitsauftraege-ansehen-der-verknuepft-tag) erscheinen. ## Einen verknüpften Fall erstellen Ein verknüpfter Fall ist ein Fall, der mit einem Fall oder Ticket verwandt ist, dessen Elternfall allerdings unabhängig ist. Dies ist nützlich, wenn das Fälligkeitsdatum des Elternfalls nicht abhängig vom Abschließen von Unterfällen ist (beispielsweise von einer anderer Abteilung). Um einen verknüpften Fall von einem schon existierenden Fall oder Ticket aus zu erstellen, dann klicken sie auf den ‚+ Arbeitsauftrag‘ Link und wählen Sie die ‚ Fall-Möglichkeit vom Dropdown-Menü aus. ![](https://3283538894-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrbXnyVXyGRZjCB5N5zoM%2Fuploads%2F1Y95b56xOZeOrbGuBqyT%2Fimage.png?alt=media\&token=cb52ae72-609e-427d-b586-4fdabc955fff) In dem darauffolgenden Pop-Up können Sie auf zwei verschiedene Arten nach dem neuen Fall-Prozess filtern: * Indem Sie nach einer E-Mail-Route suchen — Sie können die E-Mailbox-Adresse angeben, an die Personen normalerweise E-Mails senden würden, um Arbeitsaufträge zu erstellen. Meist repräsentiert die E-Mail-Mailbox einen gewissen Bereicht des Unternehmens, in dem Sie den neuen Arbeitsauftrag erstellen wollen. Wir haben eine Funktion hinzugefügt, mit der Sie nach der Mailbox suchen und sofort den Fall-Prozess, von dem Sie auswählen, einschränken können. Durch die Auswahl einer Mailbox werden Dropdown-Möglichkeiten herausgefiltert, bei denen nur Prozesse angezeigt werden, die mit dieser Mailbox verlinkt sind. * Indem Sie einen Kunden, Vertrag, eine Dienstleistung oder einen Fallprozess zum Starten auswählen (diese werden in Werten vorbelegt, wenn nur eine Option zur Auswahl steht). ![](https://3283538894-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrbXnyVXyGRZjCB5N5zoM%2Fuploads%2F9uRbiI1NBS6uXRCy6QmC%2Fimage.png?alt=media\&token=575807a1-6f70-4ba1-aa63-cbc0758af0ec) {% hint style="info" %} Bitte beachten Sie, dass die Verfügbarkeit des Fall von den Befugnissen im Builder abhängt. Zusätzlich werden Sie auch nur einen Fall-Prozess von einer E-Mail-Route auswählen können, wenn diese im Builder aktiviert wurde ([klicken Sie hier für weitere Informationen](https://docs.enate.net/enate-help/builder/builder-2021.1/email-mailbox-configuration/email-routes-detail)). Sie werden nur den Fall-Prozess im [Testmodus ](https://docs.enate.net/enate-help/v/deutsch/testmodus)auswählen können, wenn die E-Mail-Route für diesen Fall-Prozess im [Testmodus](https://docs.enate.net/enate-help/v/deutsch/testmodus) zum Start konfiguriert wurde. {% endhint %} Sie können die folgenden Einstellungen für das Fall einstellen: |

Titel

| Sie können den Titel des neuen Fall bearbeiten | | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | |

Beschreibung

| Sie können den Titel des neuen Fall bearbeiten | |

Zeitplan

| Wenn Ihr System so konfiguriert wurde ([klicken Sie hier für weitere Informationen](https://docs.enate.net/enate-help/builder/builder-2021.1/schedules-and-frequency-based-triggers/configuring-schedules)), dann müssen Sie einen Zeitplan für den neuen Fall, den Sie erstellen, auswählen. | |

Fälligkeitsdatum überschreiben

| Wenn Ihr System so konfiguriert wurde ([klicken Sie hier für weitere Informationen](https://docs.enate.net/enate-help/builder/builder-2021.1/shared-standardised-settings-flavours/due-date-flavours#overview)), dann können Sie „Fälligkeitsdatum überschreiben“ für den neuen Fall, den Sie erstellen, auswählen. | | Fehler, Dateien und angepasste Daten kopieren | Sie können bereits existierende Fehler, Dateien (mit Tags) und angepasste Daten vom Originalfall/-Ticket mit dem neuen Fall, den Sie erstellen, teilen. | | Arbeitsauftrags-Kommunikationen kopieren | Sie können Arbeitsauftrags-Kommunikationen, z.B. E-Mails (darunter E-Mail-Anhänge) und Notizen von dem OriginalFall/-Ticket und dem neuen Fall, den sie erstellen, teilen. Bitte beachten Sie, dass Sie bei der Erstellung eines Arbeitsauftrags von einem Fall aus nur die Kommunikationen auf Fall-Ebene teilen werden. Hier gibt es keine Aktionstyp-Kommunikationen oder Unterfallkommunikationen. Sie können einzelne Aktions- oder Unterfallkommunikationen kopieren, indem Sie einzelne E-Mails/Notizen vom [Kommunikations-Verlauf](https://docs.enate.net/enate-help/v/deutsch/bildschirme-alle-arbeitsauftrags-typen/hauptabschnitt) teilen. | | Kontakte hinzufügen | Sie können mehrere verschiedene Kontakte in einem neuen Fall erstellen und die Tags zwischen Ihnen aufteilen. | ![](https://3283538894-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrbXnyVXyGRZjCB5N5zoM%2Fuploads%2FAWQEoiIkLgySTyi2LYU5%2Fimage.png?alt=media\&token=f1af1625-9635-4345-b9dd-e7c3019086f4) Klicken Sie dann auf ‚Erstellen‘. Eine neue Verknüpfung zum verknüpfen Fall wird im [‚Verknüpft‘-Tab](/whats-new/dede/altere-versionen/anderungsubersicht-altere-versionen/2021.2-uberblick-uber-veranderungen/mit-verknupften-arbeitsauftragen-arbeiten.md#verknuefte-arbeitsauftraege-ansehen-der-verknuepft-tag) erscheinen. ## Einen Unterfall erstellen Ein Unterfall wird sich je nach seiner spezifischen Konfiguration verhalten‚ aber der Elternfall wird nicht abschließen, bis alle Unterfälle abgeschlossen sind. Sie können einen Unterfall also nur von einem bereits existierenden Fall aus erstellen. Um einen Unterfall zu erstellen, dann klicken sie auf den ‚+ Arbeitsauftrag‘ Link und wählen Sie die ‚ Unterfall-Möglichkeit vom Dropdown-Menü aus.
![](https://3283538894-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrbXnyVXyGRZjCB5N5zoM%2Fuploads%2FhbtRK8uDvUapPHPS8vSd%2Fimage.png?alt=media\&token=05789997-0a9e-446c-87f4-dff1e82a6e36) In dem darauffolgenden Pop-Up können Sie auf zwei verschiedene Arten nach dem neuen Unterfall-Prozess filtern: * Indem Sie nach einer E-Mail-Route suchen — Sie können die E-Mailbox-Adresse angeben, an die Personen normalerweise E-Mails senden würden, um Arbeitsaufträge zu erstellen. Meist repräsentiert die E-Mail-Mailbox einen gewissen Bereicht des Unternehmens, in dem Sie den neuen Arbeitsauftrag erstellen wollen. Wir haben eine Funktion hinzugefügt, mit der Sie nach der Mailbox suchen und sofort den Unterfall-Prozess, von dem Sie auswählen, einschränken können. Durch die Auswahl einer Mailbox werden Dropdown-Möglichkeiten herausgefiltert, bei denen nur Prozesse angezeigt werden, die mit dieser Mailbox verlinkt sind. * Indem Sie einen Kunden, Vertrag, eine Dienstleistung oder einen Unterfallprozess zum Starten auswählen (diese werden in Werten vorbelegt, wenn nur eine Option zur Auswahl steht). Bitte beachten Sie, dass der Kunde eines Unterfalls automatisch ausgefüllt wird, und zwar gleich wie beim Elternfall, also dem Fall, von dem aus Sie den Unterfall erstellen. ![](https://3283538894-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrbXnyVXyGRZjCB5N5zoM%2Fuploads%2Fpizk1feUdrwp1j87nCSk%2Fimage.png?alt=media\&token=f04614fb-4856-4395-a205-7f58fa5a74b6) {% hint style="info" %} Bitte beachten Sie, dass die Verfügbarkeit des Unterfall von den Befugnissen im Builder abhängt. Zusätzlich werden Sie auch nur einen Unterfall-Prozess von einer E-Mail-Route auswählen können, wenn diese im Builder aktiviert wurde ([klicken Sie hier für weitere Informationen](https://docs.enate.net/enate-help/builder/builder-2021.1/email-mailbox-configuration/email-routes-detail)). Sie werden nur den Unterfall-Prozess im [Testmodus ](https://docs.enate.net/enate-help/v/deutsch/testmodus)auswählen können, wenn die E-Mail-Route für diesen Fall-Prozess im [Testmodus ](https://docs.enate.net/enate-help/v/deutsch/testmodus)zum Start konfiguriert wurde. {% endhint %} Sie können die folgenden Einstellungen für das Unterfall einstellen: | Fälligkeitsdatum überschreiben | Wenn Ihr System so konfiguriert wurde ([klicken Sie hier für weitere Informationen](https://docs.enate.net/enate-help/builder/builder-2021.1/shared-standardised-settings-flavours/due-date-flavours#overview)), dann können Sie „Fälligkeitsdatum überschreiben“ für den neuen Unterfall, den Sie erstellen, auswählen. | | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Beschreibung | Sie können die Beschreibung\[ME2] des neuen Unterfalls bearbeiten | | Zeitplan | Wenn Ihr System so konfiguriert wurde ([klicken Sie hier für weitere Informationen](https://docs.enate.net/enate-help/builder/builder-2021.1/schedules-and-frequency-based-triggers/configuring-schedules)), dann müssen Sie einen Zeitplan für den neuen Unterfall, den Sie erstellen, auswählen. | | Kontakte hinzufügen | Sie können mehrere verschiedene Kontakte in einem neuen Unterfall erstellen und die Tags zwischen Ihnen aufteilen. | ![](https://3283538894-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrbXnyVXyGRZjCB5N5zoM%2Fuploads%2FZhcucs6F8QKp4UyVXZkT%2Fimage.png?alt=media\&token=e2e7155e-055c-4898-94cc-11a28e0e3034) Eine neue Verknüpfung zum Unterfall wird im [‚Unterfälle‘-Tab](/whats-new/dede/altere-versionen/anderungsubersicht-altere-versionen/2021.2-uberblick-uber-veranderungen/mit-verknupften-arbeitsauftragen-arbeiten.md#unterfall-tab) erscheinen und nicht im [‚Verknüpft‘-Tab](/whats-new/dede/altere-versionen/anderungsubersicht-altere-versionen/2021.2-uberblick-uber-veranderungen/mit-verknupften-arbeitsauftragen-arbeiten.md#verknuefte-arbeitsauftraege-ansehen-der-verknuepft-tab). ### ‚Unterfälle‘-Tab ![](https://3283538894-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrbXnyVXyGRZjCB5N5zoM%2Fuploads%2Fd8U9mFS2jYvaU5EodXRe%2FSub-Cases-Tab.gif?alt=media\&token=a9fdcb44-e5d6-452c-8f06-e19c189bdc69) Das Unterfall-Tab zeigt die folgenden Informationen für alle Unterfälle eines Falles: * Symbol für den aktuellen Status * Referenznummer und Titel des Unterfalles * Aktionszählung - Die Zählung der mit diesem Unterfall verbundenen Aktionen - der Besitzer des Falls *(falls definiert)* * Warteschlange - Die Fallwarteschlange *(falls definiert)* * Fälligkeitsdatum - Das Fälligkeitsdatum des Falls * Symbol zum Erweitern des Unterfalles, um alle Aktionen anzusehen #### Logik der Unterfall-Referenznummer Die Referenznummern der Unterfälle lassen sich wie folgt aufschlüsseln:
![](https://3283538894-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrbXnyVXyGRZjCB5N5zoM%2Fuploads%2F2nrGR4IdrhJOKlzLB6nY%2Fimage.png?alt=media\&token=9e6be297-bb6a-4175-8b4a-da0ccabb07a6) ## Verknüfte Arbeitsaufträge ansehen - der ‚Verknüpft‘-Tab Im Verknüpft-Tag können Sie alle verknüpften Arbeitsaufträgen eines Tickets oder Falles ansehen. ![](https://3283538894-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrbXnyVXyGRZjCB5N5zoM%2Fuploads%2Fe8bwAyMMLqDXJpr6bNaE%2FClicking-on-links-tab.gif?alt=media\&token=fa7334a6-8473-4a42-bf5e-94bfa617a5af) {% hint style="info" %} Beachten Sie, dass der Unterfall, der mittels dem ‚+ Arbeitsauftrag‘-Link erstellt wurde, immer noch im [‚Unterfälle‘-Tab](/whats-new/dede/altere-versionen/anderungsubersicht-altere-versionen/2021.2-uberblick-uber-veranderungen/mit-verknupften-arbeitsauftragen-arbeiten.md#unterfall-tab) und nicht im Verknüpft-Tag angezeigt wird. {% endhint %} Im Verknüpft-Tag sehen Sie eine Liste von verknüpften Arbeitsaufträgen, mit deren Referenz, Titel, an wen sie zugewiesen sind, deren Warteschlange und Fälligkeitsdatum. Es gibt auch ein Symbol zur Aufhebung der Verknüpfung des Arbeitsauftrags falls Sie versehentlich miteinander verknüpft wurden. ![](https://3283538894-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrbXnyVXyGRZjCB5N5zoM%2Fuploads%2FhMUSRT7qVOs1vPz3BSrM%2FUnlink-Work-Items.gif?alt=media\&token=3b9b46ef-ccd3-4793-9008-704c7ec6be03) Sie können die Fälle erweitern, um die Aktionen anzuzeigen. ![](https://3283538894-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrbXnyVXyGRZjCB5N5zoM%2Fuploads%2FLxPRPz5nzYFDttUiNaBZ%2FViewing-Actions-in-Links-Tab.gif?alt=media\&token=e85b4830-f5c4-47b3-8c9a-c4604b42550d) #### Verknüpfte Arbeitsaufträge, wenn Sie nicht die Befugnis haben Wenn Sie keine Befugnis für einen bestimmten Geschäftsvorgang haben, dann wird der Arbeitsauftrag grau dargestellt und Sie können diesen nicht öffnen oder bearbeiten. Sie können immer noch übergeordnete Informationen über den Arbeitsauftrag einsehen, beispielsweise an wen er zugewiesen ist, in welcher Warteschlange er sich befindet und wann das Fälligkeitsdatum ist.
![](https://3283538894-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrbXnyVXyGRZjCB5N5zoM%2Fuploads%2FYwsGZKfpz0z0XwcZQnS9%2Fimage.png?alt=media\&token=7d48d5ec-5f24-4622-864e-80855cc70b77) --- # 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.enate.net/whats-new/dede/altere-versionen/anderungsubersicht-altere-versionen/2021.2-uberblick-uber-veranderungen/mit-verknupften-arbeitsauftragen-arbeiten.md?ask=&goal= ``` `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.