> For the complete documentation index, see [llms.txt](https://docs.pascom.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pascom.net/user/pascom-app-userguide/client-profiles.md).

# App-Profile verwalten und nutzen

In diesem Handbuch erfahren Sie, wie der Präsenzstatus mit Aktionen verknüpft werden kann und gleichzeitig in Profilen abgespeichert wird.

🖥️ + 📱 Desktop & Mobile

## Trainings Video

{% embed url="<https://www.youtube.com/watch?v=KsjwprxocIg>" %}

## Übersicht

App-Profile sind ein mächtiges Werkzeug um Ihren Präsenzstatus mit Aktionen zu verknüpfen. So lässt sich die PASCOM App für jede Situation entsprechend individualisieren und das mit nur einem Mausklick.

![App-Profile Übersicht](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-c8c9f3c3125a93fbab2be4737a8355efe1531cd0%2Fclientprofiles-overview.de.png?alt=media)

1. Sie wechseln z.B. oft zwischen Ihrem Büro und dem Home Office und möchten eventuell im Büro ein anderes Anrufverhalten Ihrer Geräte als im Home Office.
2. Sie möchten z.B. in Meetings nur für Notfälle über die PASCOM Mobile App erreichbar sein.
3. Sie möchten bei Kaffeepausen überhaupt nicht gestört werden und sich auch gleichzeitig bei Warteschlangen abmelden.

Dies sind nur wenige Beispiele und Ideen, die sich mit App-Profilen umsetzen lassen.

## Präsenzstatus mit Aktionen verknüpfen

Wie funktioniert das nun genau? Den Präsenzstatus haben Sie bereits in der Anleitung [Profil und Kontaktliste](/user/pascom-app-userguide/contactlist.md) kennengelernt.

![Eigener Präsenzstatus](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-7ef96994313d96d1c3fa0dbdc0d4b64f136192e6%2Fstatus.de.png?alt=media) *Eigener Präsenzstatus sichtbar für alle Kollegen*

Der Präsenzstatus lässt sich nun über die Client Einstellungen mit Aktionen verknüpfen, sodass sich nicht nur die Signalisierung für Ihre Kollegen ändert, sondern auch im Hintergrund eine vorkonfigurierte Aktion ausgeführt wird.

{% hint style="success" %}
Aktionen die mit dem Präsenzstatus verknüpft sind, werden in Profilen gespeichert und mit einem Mausklick bei jedem Umschalten ausgeführt.
{% endhint %}

### Profileinstellungen

1. Die **Profileinstellungen** finden Sie in den **Client-Einstellungen**

![Client Einstellungen öffnen](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-c4a4bcf8655b2611f171482cd10614fb8b2e4052%2Fopen_clientsettings.jpg?alt=media)

2. Bei den **Profileinstellungen** lassen sich Ihre Profile verwalten und anpassen.

![Client Profile systemweit](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-5b6629987d9c68e5c5397cd0933df996c974066d%2Fclientprofiles-system.de.png?alt=media)

Per Default finden Sie in der Übersicht der Profileinstellungen zwei systemweite Profile, welche für alle Benutzer vorgegeben sind. Mit den dahinterliegenden Aktionen sind entweder alle Geräte erreichbar oder deaktiviert.

{% hint style="info" %}
Systemweite Profile erkennt man daran, dass man sie als Benutzer nicht löschen kann. Der Administrator verwaltet diese Profile serverseitig und sind für alle Benutzer vorgegeben.
{% endhint %}

### Neues Profil hinzufügen

Um ein neues Profil zu erstellen klicken Sie auf den Button **Profil hinzufügen**

![Neues Profil erstellen](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-6615e2daf9690fc705324fd689e0031365a3d527%2Fclientprofiles-create.de.png?alt=media)

Im nachfolgenden finden Sie das Konfigurationsfenster eines Profils, in welchem Sie zum einen den Präsenzstatus hinterlegen und zum anderen verschiedene Aktionen platzieren können.

![Profil konfigurieren](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-74e06aa96ad0e8ed9ceed5ee5a20e1e04231e149%2Fclientprofiles-configuration.de.png?alt=media)

### Präsenzstatus festlegen

Machen Sie sich zunächst gedanken, wie das Profil heissen soll. Hier ist es wichtig zu wissen, dass der **Profilname** auch gleichzeitig der **Präsenzstatus** für Ihre Kollegen ist. Daher legen Sie zunächst fest, was Sie Ihren Kollegen mit dem Profil sagen wollen.

1. Profilname vergeben.

![Profilname vergeben](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-3026764f4d98d1ef0198fa7583922ccf91d22e0a%2Fclientprofiles-profilename.de.png?alt=media) *Vergeben Sie als Profilnamen z.B. Büro, Home Office, Pause etc.*

2. Farbe, Symbol und Sichtbarkeit

Vergeben Sie zu Ihrem Profilnamen ein Symbol mit der passenden Farbe. Hier können Sie aus einigen Symbolen und Farben wählen. Zusätzlich können Sie entscheiden, ob Sie das Symbol für Ihre Kollegen sichtbar machen möchten, oder nicht.

Bei der Zusammenstellung der Symbole und Farben haben Sie völlig freie Hand. Es hat sich jedoch bewährt, für Profile in denen man erreichbar ist die Farbe **grün** zu wählen. Möchte man nicht gestört werden, bietet sich die Farbe **rot** an.

*z.B. Home Office - Symbol: Haus, Farbe: grün*

### Profil anheften - Sticky Profile

Mit der Einstellung **Profil anheften**, können App-Profile von Auslösern (Trigger) nicht automatisch übersteuert werden.

**Beispiel:**

Sie wechseln in ein Profil **Krank**, welches für die kommenden Tage aktiv bleiben soll. Nun haben Sie noch ein Profil, welches automatisch mit einem **Zeitauslöser** jeden Tag um 12 Uhr auf das Profil **Mittag** umstellt. Ein **angeheftetes Profil** kann somit nicht übersteuert werden, was in diesem Beispiel Sinn macht.

### Aktionen definieren

Im folgenden Abschnitt definieren Sie Aktionen, welche beim Umschalten auf das Profil ausgeführt werden sollen. Ein Profil besitzt **2 Aktions-Trigger**, die jeweils eigene Aktionsketten beinhalten können.

1. Aktionen, welche ausgeführt werden sobald das **Profil aktiviert wurde.**
2. Aktionen, welche ausgeführt werden sobald das **Profil verlassen wird.**

![Aktionen vergeben](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-7b6abd1b31e59a74b1ceee0bffff9d3bcbb91980%2Fclientprofiles-setactions.de.png?alt=media)

Über den Button **Aktion hinzufügen** gelangen Sie zur Aktionsübersicht und können eine neue Aktion definieren.

### Aktion - FollowMe ändern

Mit der Aktion **FollowMe ändern**, bestimmern Sie das Verhalten Ihrer Endgeräte beim Umschalten der Profile. Die FollowMe Einstellungen lassen sich auf **"Alle"** Geräte anwenden, oder aber nur für eine spezifische Endgerätfamilie.

![Aktion FollowMe](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-ce20a7c3c3c37348826cb7815c648dbefdd78430%2Fclientprofiles-followme.de.png?alt=media)

| Einstellung            | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Gerätefamilie          | <p><strong>Alle</strong> - wendet die FollowMe Änderungen auf alle Geräte an<br><strong>Mobil</strong> - wendet die FollowMe Änderungen nur auf Mobilgeräte an<br><strong>Softphone</strong> - wendet die FollowMe Änderungen nur auf das Softphone an<br><strong>Tischtelefon</strong> - wendet FollowMe Änderungen nur auf Tischtelefone an<br><strong>DECT</strong> - wendet FollowMe Änderungen nur auf DECT Geräte an.</p> |
| FollowMe Einstellungen | Weitere Infos finden Sie in der Anleitung [Meine Gerätesteuerung](/user/pascom-app-userguide/mydevices.md)                                                                                                                                                                                                                                                                                                                      |

### Aktion - GSM Modus festlegen

Mit der Aktion **GSM Modus festlegen**, können Sie den GSM Fallback Ihrer Mobilgeräte dauerhaft einschalten.

![Aktion GSM Modus](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-bba29cc684649747c2dd3dc22c2fccdaa7e65780%2Fclientprofiles-gsm.de.png?alt=media)

| Einstellung                                                    | Beschreibung              |
| -------------------------------------------------------------- | ------------------------- |
| GSM-Modus für alle meine Mobiltelefone aktivieren/deaktivieren | aktivieren / deaktivieren |

### Aktion - Anmelden, Abmelden und Pausieren in Teams

Mit den nachfolgenden Aktionen für das Team Management können Sie sich beim Umschalten Ihrer Profile bei Warteschlangen anmelden, abmelden oder pausieren.

1. Aktion - Team-Login

![Aktion Team Login](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-7efe5a352b80eb9c49ed06987d6f3e25fba46cde%2Fclientprofiles-teamlogin.de.png?alt=media)

1. Aktion - Team-Logout

![Aktion Team Login](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-91a4e0e1bc14e935c5a3b24401d6b85a084fea2f%2Fclientprofiles-teamlogout.de.png?alt=media)

1. Aktion - Team Pause

![Aktion Team Pause](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-a426cf5a4027d11efbc94551f74f0d5af53ff881%2Fclientprofiles-teampause.de.png?alt=media)

1. Aktion - Team Pause beenden

![Aktion Team Pause](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-a79d209cef79f18fdff36bb2dfc03b3cc8913ffc%2Fclientprofiles-teampause-end.de.png?alt=media)

| Einstellung      | Beschreibung                                        |
| ---------------- | --------------------------------------------------- |
| Alle Teams       | aktivieren / deaktivieren (öffnet Auswahl Dropdown) |
| Auswahl Dropdown | Wählen Sie ein einzelnes Team für die Aktion        |

### Aktion - Arbeitsplatz festlegen oder entfernen

Mit der Aktion für Arbeistplätze können Sie mit Umschalten Ihres Profils die Arbeitsplätze festlegen oder entfernen. Dies macht Sinn, wenn Sie im Büro einen Arbeitsplatz mit einem fest konfigurierten Endgerät nutzen und im Home Office diesen Arbeitsplatz nicht benötigen.

1. Aktion - Arbeitsplatz festlegen

![Aktion Arbeitsplatz festlegen](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-c2924576fea8e90f5a4a92f2110092808365a82f%2Fclientprofiles-setlocation.de.png?alt=media)

1. Aktion - Kein Arbeitsplatz

![Aktion kein Arbeitsplatz](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-7d085ecdab7dd15f32250b74a7b454144042f73f%2Fclientprofiles-removelocation.de.png?alt=media)

| Einstellung       | Beschreibung                                     |
| ----------------- | ------------------------------------------------ |
| Ziel Arbeitsplatz | Legen Sie einen Arbeitsplatz aus der Liste fest. |

*Aktion - Kein Arbeitsplatz, meldet Sie vom aktuellen Arbeitsplatz ab.*

### Aktion - Weiterleitungsnummer festlegen oder entfernen

Mit der Aktion für Rufumleitungen können Sie mit Umschalten Ihres Profils Anrufe an eine interne oder externe Rufnummern umleiten. Das macht Sinn, wenn z.B. in Ihrer Abwesenheit Anrufe weiter bearbeitet werden sollen.

1. Aktion - Weiterleitungsnummer festlegen

![Aktion Weiterleitungsnummer festlegen](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-088bde76951dca3529ec01611ba7a73fbeb89120%2Fclientprofiles-setredirect.de.png?alt=media)

1. Aktion - Umleitung aufheben

![Aktion kein Arbeitsplatz](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-c6725c5632d15167f9b564e49e3cbce7f00a195f%2Fclientprofiles-removeredirect.de.png?alt=media)

| Einstellung                                        | Beschreibung                                                   |
| -------------------------------------------------- | -------------------------------------------------------------- |
| Legen Sie eine Umleitung zum angegebenen Ziel fest | Neue Rufumleitung hinzufügen oder eine der letzten aktivieren. |

*Aktion - Umleitung aufheben, entfernt die Weiterleitungsnummer.*

### Aktionen verketten

In einem Profil ist es möglich, mehrere Aktionen miteinander zu verketten. So können Profile sehr detailliert an die eigene Arbeitsweise angepasst werden. In folgendem Beispiel, legen wir ein Home Office Profil an, welches beim Aktivieren die definierten Aktionen nacheinander auslöst.

![Aktionskette Home Office Profil](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-b11db5acdaa3bfe2ccc49c278e4c3169b19472f9%2Fclientprofiles-homeoffice.de.png?alt=media)

**Was passiert beim Umschalten auf dieses Home Office Profil?**

1. Als erstes wird der Benutzer bei seinem aktuellen Arbeitsplatz abgemeldet.
2. Nachfolgend wird ein neuer Arbeitsplatz festgelegt.
3. Anschließend werden die FollowMe Einstellungen für das **Softphone** angepasst.
4. Zum Schluss werden nochmals FollowMe Einstellungen für das Mobilgerät angepasst, sodass nur interne Anrufe durchklingeln.

{% hint style="success" %}
Sie merken anhand des Beispiels, dass die Aktionen nacheinander ausgeführt werden. Von oben nach unten. Um die Hirarchie der Aktionen zu beinflussen, nutzen Sie die **Richtungspfeile**.
{% endhint %}

### Auslöser - Trigger verwenden

Mit **Auslösern** können Sie den Wechsel in verschiedene Profile weitestgehend automatisieren.

Fügen Sie über den Register **Auslöser** Ihrem aktuellen Profil einen automatischen Trigger hinzu.

![Auslöser verwenden](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-883dbbeb86f86c617811658e9167d5b826732dd2%2Fclientprofiles-trigger.de.png?alt=media)

### Auslöser - Zeitauslöser einrichten

Mit dem **Zeitauslöser** können Sie den Wechsel zwischen Profilen zu bestimmten Zeiten automatisieren. Sie können so z.B. jeden Tag um 12:00 Uhr automatisch in ein **Mittagsprofil** wechseln.

<figure><img src="https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-5c7aad1ee2899be111057c43dc3eef1bf422506c%2Fclientprofiles-timetrigger.de.png?alt=media" alt="Time Trigger" width="70%"><figcaption></figcaption></figure>

| Einstellung | Beschreibung                                                                     |
| ----------- | -------------------------------------------------------------------------------- |
| Zeit        | Um wieviel Uhr soll der Trigger auslösen. Definieren Sie eine Uhrzeit            |
| Wiederholen | An welchen Tagen soll sich bei der definierten Uhrzeit der Auslöser wiederholen. |

*Zeitauslöser entfernen - Zeitauslöser können vorübergehend deaktivert oder komplett gelöscht werden.*

### Auslöser - Microsoft Teams Meeting

<figure><img src="https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-fc6028083de916d12283285640fb0d846dd24f07%2Fpascom-ms-teams-logo.png?alt=media" alt="MS-Teams Trigger" width="40%"><figcaption></figcaption></figure>

Der **Microsoft Teams Meeting Auslöser** erkennt automatisch, wenn Sie ein Telefonat oder eine Videokonferenz über **Microsoft Teams** starten und welchselt dann in ein Profil z.B. **Teams-Meeting**.

{% embed url="<https://www.youtube.com/watch?v=odyY4TdS0tM>" %}

Die Synchronisation dauert in der Regel zwischen **05 und 10 Sekunden** bis der Präsenzstatus im PASCOM App umschaltet.

{% hint style="info" %}
Ein **Profil** mit dem **Mircosoft Teams Meeting Auslöser** sollten Sie **anheften** (Sticky Profil), damit dieses von anderen Profilen während Ihres Teams-Meeting nicht automatisch übersteuert werden kann.
{% endhint %}

Nach einem **Teams-Meeting** springt Ihr Präsenzstatus automatisch zurück auf das zuvor benutzte Profil.

<figure><img src="https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-14c18aabffafae079a380767d210a24cafe263e1%2Fclientprofiles-msteamstrigger.de.png?alt=media" alt="MS Teams Trigger" width="50%"><figcaption></figcaption></figure>

| Einstellung                   | Beschreibung                                                     |
| ----------------------------- | ---------------------------------------------------------------- |
| Keine Einstellungen vorhanden | Der Microsoft Teams Meeting Auslöser ist bereits vorkonfiguriert |

*Microsoft Teams Meeting Auslöser entfernen - Der Auslöser kann vorübergehend deaktivert oder komplett gelöscht werden.*

{% hint style="warning" %}
Der **Mircosoft Teams Meeting Auslöser** funktioniert nur, wenn der **Microsoft 365 Status Connector** auf der PASCOM Telefoanlage eingerichtet wurde. Sprechen Sie im Falle einer Fehlermeldung mit Ihrem Administrator.
{% endhint %}

### Aktionen bearbeiten, deaktivieren und löschen

Sie können jederzeit Änderungen an Ihren Aktionen vornehmen, diese deaktivieren oder auch löschen.

![Client Profil Aktion löschen](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-f89f104fe0ce9175e8b7ce0c1db1945da3cb7395%2Fclientprofiles-deleteaction.de.png?alt=media)

{% hint style="warning" %}
Änderungen an **Aktionen** können nur durchgeführt werden, wenn das **Profil** gerade nicht in Benutzung ist.
{% endhint %}

**Aktion bearbeiten**\
Jede Aktion kann im nachhinein nochmal angepasst werden. Klicken Sie dazu einfach auf die **Aktion** selbst und Sie gelangen wieder zu der **Konfigurationsmaske**.

**Aktion deaktivieren**\
Sie möchten Testen, wie Sich Ihre Aktionskette verhält, wenn Sie eine Aktion entfernen? Dann können Sie die Aktion vorübergehend **deaktivieren** und zu einem späteren Zeitpunkt wieder aktivieren.

**Aktion löschen**\
Eine Aktion können Sie dauerhaft entfernen, indem Sie auf **Löschen** klicken. **Nach dem Löschen, kann die Aktion nicht wiederhergestellt werden**.

### Profil bearbeiten und löschen

Sie können jederzeit Änderungen an Ihren Profilen vornehmen oder diese entfernen.

![Client Profil löschen](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-241bedb3911155a83ff2066ac33b438f9ee7804e%2Fclientprofiles-profiles.de.png?alt=media)

{% hint style="warning" %}
Änderungen an **Profilen** können nur durchgeführt werden, wenn das **Profil** gerade nicht in Benutzung ist.
{% endhint %}

**Profil bearbeiten**\
Jedes Profil kann im nachhinein nochmal angepasst werden. Klicken Sie dazu einfach auf das **Bleistiftsymbol** und Sie gelangen wieder zu der **Aktionsübersicht**.

**Profil löschen**\
Um ein Profil zu entfernen, klicken Sie auf das **Mülleimersymbol**.\
**Nach dem Löschen, kann das Profil nicht wiederhergestellt werden**


---

# 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 following URL with the `ask` and `goal` query parameters:

```
GET https://docs.pascom.net/user/pascom-app-userguide/client-profiles.md?ask=<question>&goal=<user_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 `build a script that syncs our docs to a CMS` 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.
