> For the complete documentation index, see [llms.txt](https://docs.dnt.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dnt.de/dnt-lw-etrv-c/kommunikationsprotokoll/7.-temperaturregelung.md).

# 7. Temperaturregelung

## 7.1 Soll-Temperatur

{% tabs %}
{% tab title="GET SET-POINT TEMPERATURE" %}
Abfrage der Soll-Temperatur.

**Downlink**

| Byte | Bit(s) |        Value        |
| :--: | :----: | :-----------------: |
|   0  |    7   |          IR         |
|   0  |   6:0  | `0x21` (Command ID) |

**Uplink**

|     Byte     | Bit(s) |            Value           |
| :----------: | :----: | :------------------------: |
|       0      |    7   |            Res.            |
|       0      |   6:0  |     `0x21` (Command ID)    |
|       1      |   7:0  | `ID_TEMPERATURE_SET_POINT` |
| {% endtab %} |        |                            |

{% tab title="SET SET-POINT TEMPERATURE" %}
Konfiguration der Soll-Temperatur.

**Beispiel**

```
222Bh = 21,5 °C Soll-Temperatur
```

|      Byte     | Bit(s) |            Value           |
| :-----------: | :----: | :------------------------: |
|       0       |    7   |            Res.            |
|       0       |   6:0  |     `0x22` (Command ID)    |
|       1       |   7:0  | `ID_TEMPERATURE_SET_POINT` |
|  {% endtab %} |        |                            |
| {% endtabs %} |        |                            |

<details>

<summary>ID_TEMPERATURE_SET_POINT</summary>

|   Eigenschaft  |                              Wert                             |
| :------------: | :-----------------------------------------------------------: |
|  Beschreibung  | Solltemperatur des Heizkörperthermostats im normalen Betrieb. |
|      Größe     |                             8 Bit                             |
|  Wertebereich  |                            10 - 60                            |
|  Standardwert  |                               20                              |
| Interpretation | <p><code>y = x \* 0,5</code></p><p><code>\[y] = °C</code></p> |
|   Persistent   |                               Ja                              |
|     Zugriff    |                              r/w                              |

</details>

***

## 7.2 Minimale Set-Point Temperatur

{% hint style="info" %}
Das Setzen der minimalen Solltemperatur ist ab Firmwareversion 1.4.3 und Co-Prozessor Version 1.2.0 möglich.
{% endhint %}

{% tabs %}
{% tab title="GET MINIMUM SET-POINT TEMPERATURE" %}
Abfrage der minimalen Solltemperaturbegrenzung.

**Downlink**

| Byte | Bit(s) |        Value        |
| :--: | :----: | :-----------------: |
|   0  |    7   |          IR         |
|   0  |   6:0  | `0x3D` (Command ID) |

**Uplink**

<table><thead><tr><th align="center">Byte</th><th width="160.181884765625" align="center">Bit(s)</th><th align="center">Value</th></tr></thead><tbody><tr><td align="center">0</td><td align="center">7</td><td align="center">Res.</td></tr><tr><td align="center">0</td><td align="center">6:0</td><td align="center"><code>0x3D</code> (Command ID)</td></tr><tr><td align="center">1</td><td align="center">7:0</td><td align="center"><code>ID_TEMPERATURE_SET_POINT_MIN</code></td></tr></tbody></table>
{% endtab %}

{% tab title="SET MINIMUM SET-POINT TEMPERATURE" %}
Konfiguration der Soll-Temperatur.

**Beispiel**

```
3E14h = 10 °C minimale Solltemperatur
```

<table><thead><tr><th align="center">Byte</th><th width="147.45458984375" align="center">Bit(s)</th><th align="center">Value</th></tr></thead><tbody><tr><td align="center">0</td><td align="center">7</td><td align="center">Res.</td></tr><tr><td align="center">0</td><td align="center">6:0</td><td align="center"><code>0x3E</code> (Command ID)</td></tr><tr><td align="center">1</td><td align="center">7:0</td><td align="center"><code>ID_TEMPERATURE_SET_POINT_MIN</code></td></tr></tbody></table>
{% endtab %}
{% endtabs %}

<details>

<summary>ID_TEMPERATURE_SET_POINT_MIN</summary>

|             Eigenschaft             |                              Wert                             |
| :---------------------------------: | :-----------------------------------------------------------: |
|             Beschreibung            |           Begrenzt die einstellbare Soll-Temperatur           |
| <p><br>auf einen minimalen Wert</p> |                                                               |
|                Größe                |                             8 Bit                             |
|             Wertebereich            |            FW ≥ 1.3.0: 10 - 60 FW < 1.3.0: 10 - 36            |
|             Standardwert            |                               10                              |
|            Interpretation           | <p><code>y = x \* 0,5</code></p><p><code>\[y] = °C</code></p> |
|              Persistent             |                               Ja                              |
|               Zugriff               |                              r/w                              |

</details>

***

## 7.3 Maximale Set-Point Temperatur

{% tabs %}
{% tab title="GET MAXIMUM SET-POINT TEMPERATURE" %}
Abfrage der minimalen Solltemperaturbegrenzung.

**Downlink**

| Byte | Bit(s) |        Value        |
| :--: | :----: | :-----------------: |
|   0  |    7   |          IR         |
|   0  |   6:0  | `0x3F` (Command ID) |

**Uplink**

<table><thead><tr><th align="center">Byte</th><th width="160.181884765625" align="center">Bit(s)</th><th align="center">Value</th></tr></thead><tbody><tr><td align="center">0</td><td align="center">7</td><td align="center">Res.</td></tr><tr><td align="center">0</td><td align="center">6:0</td><td align="center"><code>0x3F</code> (Command ID)</td></tr><tr><td align="center">1</td><td align="center">7:0</td><td align="center"><code>ID_TEMPERATURE_SET_POINT_MAX</code></td></tr></tbody></table>
{% endtab %}

{% tab title="SET MAXIMUM SET-POINT TEMPERATURE" %}
Konfiguration der Soll-Temperatur.

**Beispiel**

```
3E14h = 10 °C minimale Solltemperatur
```

<table><thead><tr><th align="center">Byte</th><th width="147.45458984375" align="center">Bit(s)</th><th align="center">Value</th></tr></thead><tbody><tr><td align="center">0</td><td align="center">7</td><td align="center">Res.</td></tr><tr><td align="center">0</td><td align="center">6:0</td><td align="center"><code>0x40</code> (Command ID)</td></tr><tr><td align="center">1</td><td align="center">7:0</td><td align="center"><code>ID_TEMPERATURE_SET_POINT_MAX</code></td></tr></tbody></table>
{% endtab %}
{% endtabs %}

<details>

<summary>ID_TEMPERATURE_SET_POINT_MAX</summary>

|             Eigenschaft             |                              Wert                             |
| :---------------------------------: | :-----------------------------------------------------------: |
|             Beschreibung            |           Begrenzt die einstellbare Soll-Temperatur           |
| <p><br>auf einen maximalen Wert</p> |                                                               |
|                Größe                |                             8 Bit                             |
|             Wertebereich            |            FW ≥ 1.3.0: 10 - 60 FW < 1.3.0: 36 - 60            |
|             Standardwert            |                               60                              |
|            Interpretation           | <p><code>y = x \* 0,5</code></p><p><code>\[y] = °C</code></p> |
|              Persistent             |                               Ja                              |
|               Zugriff               |                              r/w                              |

</details>

***

## 7.4 Externe Raumtemperatur

{% tabs %}
{% tab title="SET EXTERNAL ROOM TEMPERATURE" %}
Setzen der extern gemessenen Raumtemperatur.

**Beispiel**

```
2300C6h = Externe Raumtemperatur 19,8 °C
```

<table><thead><tr><th width="155.199951171875" align="center">Byte</th><th width="212.60009765625" align="center">Bit(s)</th><th align="center">Value</th></tr></thead><tbody><tr><td align="center">0</td><td align="center">7</td><td align="center">Res.</td></tr><tr><td align="center">0</td><td align="center">6:0</td><td align="center"><code>0x23</code> (Command ID)</td></tr><tr><td align="center">1</td><td align="center">7:0</td><td align="center"><code>ID_EXTERNAL_ROOM_TEMPERATURE[15:8]</code></td></tr><tr><td align="center">2</td><td align="center">7:0</td><td align="center"><code>ID_EXTERNAL_ROOM_TEMPERATURE[7:0]</code></td></tr></tbody></table>
{% endtab %}
{% endtabs %}

<details>

<summary>ID_EXTERNAL_ROOM_TEMPERATURE</summary>

|   Eigenschaft  |                                                              Wert                                                             |
| :------------: | :---------------------------------------------------------------------------------------------------------------------------: |
|  Beschreibung  |                              Extern gemessene Raumtemperatur, die an das Gerät übermittelt wird.                              |
|      Größe     |                                                             16 Bit                                                            |
|  Wertebereich  |                                                            0 - 451                                                            |
|  Standardwert  |                                                               -                                                               |
| Interpretation | <p><code>0</code> → underflow</p><p><code>1 - 450</code> → <code>y = x \* 0,1</code> °C</p><p><code>451</code> → overflow</p> |
|   Persistent   |                                                              Nein                                                             |
|     Zugriff    |                                                               w                                                               |

</details>

## 7.5 Temperaturoffset

{% tabs %}
{% tab title="GET TEMPERATURE OFFSET" %}
Abfrage des konfigurierten Temperaturoffsets.

**Downlink**

| Byte | Bit(s) |        Value        |
| :--: | :----: | :-----------------: |
|   0  |    7   |          IR         |
|   0  |   6:0  | `0x24` (Command ID) |

**Uplink**

|     Byte     | Bit(s) |          Value          |
| :----------: | :----: | :---------------------: |
|       0      |    7   |           Res.          |
|       0      |   6:0  |   `0x24` (Command ID)   |
|       1      |   7:0  | `ID_TEMPERATURE_OFFSET` |
| {% endtab %} |        |                         |

{% tab title="SET TEMPERATURE OFFSET" %}
Konfiguration des Temperaturoffsets.

**Beispiel**

```
258Fh = +1,5 K Temperaturoffset
```

|      Byte     | Bit(s) |          Value          |
| :-----------: | :----: | :---------------------: |
|       0       |    7   |           Res.          |
|       0       |   6:0  |   `0x25` (Command ID)   |
|       1       |   7:0  | `ID_TEMPERATURE_OFFSET` |
|  {% endtab %} |        |                         |
| {% endtabs %} |        |                         |

<details>

<summary>ID_TEMPERATURE_OFFSET</summary>

|   Eigenschaft  |                                 Wert                                |
| :------------: | :-----------------------------------------------------------------: |
|  Beschreibung  |         Offset zur Korrektur der gemessenen Raumtemperatur.         |
|      Größe     |                                8 Bit                                |
|  Wertebereich  |                               0 - 255                               |
|  Standardwert  |                                 128                                 |
| Interpretation | <p><code>y = x \* 0,1 - 12,8</code></p><p><code>\[y] = K</code></p> |
|   Persistent   |                                  Ja                                 |
|     Zugriff    |                                 r/w                                 |

</details>

***

## 7.6 Vom Regler verwendete Raumtermperatur

{% tabs %}
{% tab title="GET HEATING CONTROLLER INPUT ROOM TEMPERATURE" %}
Abfrage der von der Regelung verwendeten Raumtemperatur.

**Downlink**

| Byte | Bit(s) |        Value        |
| :--: | :----: | :-----------------: |
|   0  |    7   |          IR         |
|   0  |   6:0  | `0x26` (Command ID) |

**Uplink**

<table><thead><tr><th width="154.39990234375" align="center">Byte</th><th width="169.39990234375" align="center">Bit(s)</th><th align="center">Value</th></tr></thead><tbody><tr><td align="center">0</td><td align="center">7</td><td align="center">Res.</td></tr><tr><td align="center">0</td><td align="center">6:0</td><td align="center"><code>0x26</code> (Command ID)</td></tr><tr><td align="center">1</td><td align="center">7:0</td><td align="center"><code>ID_CONTROLLER_INPUT_ROOM_TEMPERATURE[H]</code></td></tr><tr><td align="center">2</td><td align="center">7:0</td><td align="center"><code>ID_CONTROLLER_INPUT_ROOM_TEMPERATURE[L]</code></td></tr></tbody></table>
{% endtab %}
{% endtabs %}

<details>

<summary>ID_CONTROLLER_INPUT_ROOM_TEMPERATURE</summary>

|   Eigenschaft  |                                                              Wert                                                             |
| :------------: | :---------------------------------------------------------------------------------------------------------------------------: |
|  Beschreibung  |                                 Aktuelle Raumtemperatur, die von der Regelung verwendet wird.                                 |
|      Größe     |                                                             16 Bit                                                            |
|  Wertebereich  |                                                            0 - 451                                                            |
|  Standardwert  |                                                               -                                                               |
| Interpretation | <p><code>0</code> → underflow</p><p><code>1 - 450</code> → <code>y = x \* 0,1</code> °C</p><p><code>451</code> → overflow</p> |
|   Persistent   |                                                              Nein                                                             |
|     Zugriff    |                                                               r                                                               |

</details>

***

## 7.7 Vom Regler verwendete Solltemperatur

{% tabs %}
{% tab title="GET HEATING CONTROLLER INPUT SET-POINT TEMPERATURE" %}
Abfrage der Soll-Temperatur, die von der Regelung verwendet wird.

**Downlink**

| Byte | Bit(s) |        Value        |
| :--: | :----: | :-----------------: |
|   0  |    7   |          IR         |
|   0  |   6:0  | `0x27` (Command ID) |

**Uplink**

<table><thead><tr><th width="161.5999755859375" align="center">Byte</th><th width="152" align="center">Bit(s)</th><th align="center">Value</th></tr></thead><tbody><tr><td align="center">0</td><td align="center">7</td><td align="center">Res.</td></tr><tr><td align="center">0</td><td align="center">6:0</td><td align="center"><code>0x27</code> (Command ID)</td></tr><tr><td align="center">1</td><td align="center">7:0</td><td align="center"><code>ID_CONTROLLER_INPUT_SET_POINT_TEMPERATURE</code></td></tr></tbody></table>
{% endtab %}
{% endtabs %}

<details>

<summary>ID_CONTROLLER_INPUT_SET_POINT_TEMPERATURE</summary>

|   Eigenschaft  |                              Wert                             |
| :------------: | :-----------------------------------------------------------: |
|  Beschreibung  | Aktuelle Solltemperatur, die von der Regelung verwendet wird. |
|      Größe     |                             8 Bit                             |
|  Wertebereich  |                            10 - 60                            |
|  Standardwert  |                               10                              |
| Interpretation | <p><code>y = x \* 0,5</code></p><p><code>\[y] = °C</code></p> |
|   Persistent   |                              Nein                             |
|     Zugriff    |                               r                               |

</details>

***

## 7.8 Heizungsregler-Konfiguration

{% tabs %}
{% tab title="GET HEATING CONTROLLER CONFIG" %}
Abfrage der Konfiguration der Raumtemperaturregelung.

**Downlink**

| Byte | Bit(s) |        Value        |
| :--: | :----: | :-----------------: |
|   0  |    7   |          IR         |
|   0  |   6:0  | `0x28` (Command ID) |

**Uplink**

<table><thead><tr><th width="153.7999267578125" align="center">Byte</th><th width="166.5455322265625" align="center">Bit(s)</th><th align="center">Value</th></tr></thead><tbody><tr><td align="center">0</td><td align="center">7</td><td align="center">Res.</td></tr><tr><td align="center">0</td><td align="center">6:0</td><td align="center"><code>0x28</code> (Command ID)</td></tr><tr><td align="center">1</td><td align="center">7</td><td align="center"><code>ID_CONTROLLER_ADAPTIVE_GAIN_ADJUSTMENT_EN</code></td></tr><tr><td align="center">1</td><td align="center">6</td><td align="center"><code>ID_CONTROLLER_ROOM_TEMPERATURE_INPUT_SEL</code></td></tr><tr><td align="center">1</td><td align="center">5:0</td><td align="center">Res.</td></tr></tbody></table>
{% endtab %}

{% tab title="SET HEATING CONTROLLER CONFIG" %}
Konfiguration der Raumtemperaturregelung.

**Beispiel**

```
29C0h = Adaptive Regelung aktiv, externe Raumtemperatur als Quelle
```

<table><thead><tr><th width="130.4000244140625" align="center">Byte</th><th width="191" align="center">Bit(s)</th><th align="center">Value</th></tr></thead><tbody><tr><td align="center">0</td><td align="center">7</td><td align="center">Res.</td></tr><tr><td align="center">0</td><td align="center">6:0</td><td align="center"><code>0x29</code> (Command ID)</td></tr><tr><td align="center">1</td><td align="center">7:0</td><td align="center"><code>ID_CONTROLLER_ADAPTIVE_GAIN_ADJUSTMENT_EN</code></td></tr><tr><td align="center">1</td><td align="center">6</td><td align="center"><code>ID_CONTROLLER_ROOM_TEMPERATURE_INPUT_SEL</code></td></tr><tr><td align="center">1</td><td align="center">5:0</td><td align="center">Res.</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

<details>

<summary>ID_CONTROLLER_ADAPTIVE_GAIN_ADJUSTMENT_EN</summary>

|   Eigenschaft  |                                 Wert                                 |
| :------------: | :------------------------------------------------------------------: |
|  Beschreibung  |           Aktiviert oder deaktiviert die adaptive Regelung.          |
|      Größe     |                                 1 Bit                                |
|  Wertebereich  |                                 0 - 1                                |
|  Standardwert  |                                   1                                  |
| Interpretation | <p><code>0</code> → deaktiviert</p><p><code>1</code> → aktiviert</p> |
|   Persistent   |                                  Ja                                  |
|     Zugriff    |                                  r/w                                 |

</details>

<details>

<summary>ID_CONTROLLER_ROOM_TEMPERATURE_INPUT_SEL</summary>

|   Eigenschaft  |                                                      Wert                                                      |
| :------------: | :------------------------------------------------------------------------------------------------------------: |
|  Beschreibung  |                                 Auswahl der Temperaturquelle für die Regelung.                                 |
|      Größe     |                                                      1 Bit                                                     |
|  Wertebereich  |                                                      0 - 1                                                     |
|  Standardwert  |                                                        0                                                       |
| Interpretation | <p><code>0</code> → intern gemessene Raumtemperatur</p><p><code>1</code> → extern gemessene Raumtemperatur</p> |
|   Persistent   |                                                       Ja                                                       |
|     Zugriff    |                                                       r/w                                                      |

</details>

***

## 7.9 Statische Reglerverstärkung

{% tabs %}
{% tab title="GET HEATING CONTROLLER STATIC GAINS" %}
Abfrage der statischen Verstärkung des Reglers.

**Downlink**

| Byte | Bit(s) |        Value        |
| :--: | :----: | :-----------------: |
|   0  |    7   |          IR         |
|   0  |   6:0  | `0x2A` (Command ID) |

**Uplink**

|     Byte     | Bit(s) |           Value          |
| :----------: | :----: | :----------------------: |
|       0      |    7   |           Res.           |
|       0      |   6:0  |    `0x2A` (Command ID)   |
|       1      |   7:0  | `ID_STATIC_P_GAIN[15:8]` |
|       2      |   7:0  |  `ID_STATIC_P_GAIN[7:0]` |
|       3      |   7:0  |    `ID_STATIC_I_GAIN`    |
| {% endtab %} |        |                          |

{% tab title="SET HEATING CONTROLLER STATIC GAINS" %}
Konfiguration der statischen Verstärkung des Reglers.

**Beispiel**

```
2B03E864h = P-Verstärkung 1000 und I-Verstärkung 0,000100
```

|      Byte     | Bit(s) |           Value          |
| :-----------: | :----: | :----------------------: |
|       0       |    7   |           Res.           |
|       0       |   6:0  |    `0x2B` (Command ID)   |
|       1       |   7:0  | `ID_STATIC_P_GAIN[15:8]` |
|       2       |   7:0  |  `ID_STATIC_P_GAIN[7:0]` |
|       3       |   7:0  |    `ID_STATIC_I_GAIN`    |
|  {% endtab %} |        |                          |
| {% endtabs %} |        |                          |

<details>

<summary>ID_STATIC_P_GAIN</summary>

|   Eigenschaft  |                               Wert                              |
| :------------: | :-------------------------------------------------------------: |
|  Beschreibung  | P-Verstärkung des Reglers bei deaktivierter adaptiver Regelung. |
|      Größe     |                              16 Bit                             |
|  Wertebereich  |                            720 - 4100                           |
|  Standardwert  |                               1050                              |
| Interpretation |                             `y = x`                             |
|   Persistent   |                                Ja                               |
|     Zugriff    |                               r/w                               |

</details>

<details>

<summary>ID_STATIC_I_GAIN</summary>

|   Eigenschaft  |                               Wert                              |
| :------------: | :-------------------------------------------------------------: |
|  Beschreibung  | I-Verstärkung des Reglers bei deaktivierter adaptiver Regelung. |
|      Größe     |                              8 Bit                              |
|  Wertebereich  |                             17 - 167                            |
|  Standardwert  |                               100                               |
| Interpretation |                        `y = x / 1000000`                        |
|   Persistent   |                                Ja                               |
|     Zugriff    |                               r/w                               |

</details>

***

## 7.10 Aktuell verwendete Reglerverstärkung

{% tabs %}
{% tab title="GET HEATING CONTROLLER INPUT GAINS" %}
Abfrage der aktuell verwendeten Verstärkungsfaktoren.

**Downlink**

| Byte | Bit(s) |        Value        |
| :--: | :----: | :-----------------: |
|   0  |    7   |          IR         |
|   0  |   6:0  | `0x2C` (Command ID) |

**Uplink**

<table><thead><tr><th width="155.2000732421875" align="center">Byte</th><th width="218.2000732421875" align="center">Bit(s)</th><th align="center">Value</th></tr></thead><tbody><tr><td align="center">0</td><td align="center">7</td><td align="center">Res.</td></tr><tr><td align="center">0</td><td align="center">6:0</td><td align="center"><code>0x2C</code> (Command ID)</td></tr><tr><td align="center">1</td><td align="center">7:0</td><td align="center"><code>ID_CONTROLLER_INPUT_P_GAIN[15:8]</code></td></tr><tr><td align="center">2</td><td align="center">7:0</td><td align="center"><code>ID_CONTROLLER_INPUT_P_GAIN[7:0]</code></td></tr><tr><td align="center">3</td><td align="center">7:0</td><td align="center"><code>ID_CONTROLLER_INPUT_I_GAIN</code></td></tr></tbody></table>
{% endtab %}
{% endtabs %}

<details>

<summary>ID_CONTROLLER_INPUT_P_GAIN</summary>

|   Eigenschaft  |                      Wert                     |
| :------------: | :-------------------------------------------: |
|  Beschreibung  | Aktuell verwendete P-Verstärkung des Reglers. |
|      Größe     |                     16 Bit                    |
|  Wertebereich  |                   720 - 4100                  |
|  Standardwert  |                       -                       |
| Interpretation |                    `y = x`                    |
|   Persistent   |                       Ja                      |
|     Zugriff    |                       r                       |

</details>

<details>

<summary>ID_CONTROLLER_INPUT_I_GAIN</summary>

|   Eigenschaft  |                      Wert                     |
| :------------: | :-------------------------------------------: |
|  Beschreibung  | Aktuell verwendete I-Verstärkung des Reglers. |
|      Größe     |                     8 Bit                     |
|  Wertebereich  |                    17 - 167                   |
|  Standardwert  |                       -                       |
| Interpretation |               `y = x / 1000000`               |
|   Persistent   |                       Ja                      |
|     Zugriff    |                       r                       |

</details>

***

## 7.11 Adaptive Reglerverstärkung zurücksetzen

{% tabs %}
{% tab title="RESET HEATING CONTROLLER ADAPTIVE GAINS" %}
Zurücksetzen der adaptiven Verstärkungsfaktoren.

|      Byte     | Bit(s) |        Value        |
| :-----------: | :----: | :-----------------: |
|       0       |    7   |          IR         |
|       0       |   6:0  | `0x2D` (Command ID) |
|  {% endtab %} |        |                     |
| {% endtabs %} |        |                     |


---

# 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.dnt.de/dnt-lw-etrv-c/kommunikationsprotokoll/7.-temperaturregelung.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.
