> For the complete documentation index, see [llms.txt](https://help.dscout.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.dscout.com/study-basics/question-types/activity-questions/task-questions.md).

# Task questions

<table><thead><tr><th>Study type</th><th data-type="checkbox">Availability</th></tr></thead><tbody><tr><td><strong>Usability tests</strong></td><td>true</td></tr><tr><td><strong>Intercept studies</strong></td><td>true</td></tr><tr><td><strong>AI moderated studies</strong></td><td>true</td></tr></tbody></table>

Task questions ask participants to complete an action using a live website, prototype, or app. Maybe you want to see how easily users can find a specific page or how intuitive your newly designed search functionality is. With task questions, you can find out directly from your participants.

![](https://content.gitbook.com/content/IKfn7RcT4CW9XaIbqAdd/blobs/5ZJV1RO9auDqDc2GrtWj/37450804811284)

When building a task question, you can add as much (or as little!) guidance as you want depending on what you’re trying to learn. You can also add task stimuli, such as a website, a Figma prototype, or an HTML file, that opens automatically for participants where you want them to complete the task.

Task question usage varies depending on your study’s device type:

| Desktop studies                                                                                                                                                                                                                                                                          | Mobile studies                                                                                                                                                                                                                                                                     |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <ul><li><strong>(Usability tests and intercept studies)</strong> Up to 15 task questions with no duration limit.</li><li><strong>(AI moderated studies)</strong> Up to 5 task questions with no duration limit.</li><li>Capture face, screen, and audio during task questions.</li></ul> | <ul><li>Up to 15 task questions with a total recording time of 40 minutes. After 40 minutes, recording ends—even if the participant hasn’t finished the study.</li><li>Capture face, screen, and audio with the in-app view, or screen and audio with the external view.</li></ul> |

For a side-by-side comparison of what's available on each device and recording option, see [Usability testing features by device](/usability-tests/what-are-usability-tests-in-dscout/usability-testing-features-by-device.md).

{% hint style="info" %}
Keep the duration of your test in mind when adding task questions. Participants can feel fatigued in just 15 minutes during unmoderated testing.
{% endhint %}

### Task question settings

The settings available on a task question depend on your study type. Select your study type below.

{% tabs %}
{% tab title="Usability tests and intercept studies" %}
The three follow-up settings (**Self-reported completion**, **Single Ease Question (SEQ)**, and **SEQ Difficulty**) appear under **Power follow-ups** in the question settings.

<table><thead><tr><th width="220">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Task</strong></td><td><p>The prompt or instructions participants see as part of this task. Here, enter guidance they should follow or any context they should know before beginning the task. For example, if they should complete the task using your company’s app, you should tell them that here.</p><p></p><p>You can format your text in the following ways:</p><p></p><ul><li><code>*bold*</code> = <strong>bold</strong></li><li><code>_italic_</code> = <em>italic</em></li><li><code>&#x3C;https://examplelink.com></code> = <a href="https://examplelink.com/">https://examplelink.com</a></li><li><code>[Sample link](https://examplelink.com)</code> = <a href="https://examplelink.com/">Sample link</a></li></ul><p></p><p>However, only include links here that are supplementary. To link participants to a specific page or prototype related to the task, add it under <strong>Task stimuli</strong>.</p><div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p><strong>Tip:</strong> For inspiration writing task questions, see <a href="https://dscout.com/people-nerds/usability-for-newbies-task-writing-pro">Become a Task Writing Pro</a> from Dscout’s People Nerds.</p></div></td></tr><tr><td><strong>Task stimuli</strong> (optional)</td><td><p>A Figma prototype, website, or HTML file participants should use to complete this task. Stimuli open automatically when participants reach this task. (To stop displaying the stimuli after the task question, see <strong>Close task stimuli</strong>.)</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Note:</strong> If you're using a Figma Make prototype, first <a href="https://help.figma.com/hc/en-us/articles/31304586129559-Publish-update-or-unpublish-a-functional-prototype-or-web-app">publish</a> your prototype in Figma Make. Then, add the provided URL as a <strong>Website</strong> to your task question. Heat maps are not generated for Figma Make prototypes.</p></div><p>For more details on configuring a Figma prototype in Dscout, see <a href="/study-basics/testing-prototypes/add-a-figma-prototype-to-a-study.md">Add a Figma prototype to a study</a>. To upload an HTML file, see <a href="/study-basics/testing-prototypes/upload-an-html-prototype-to-a-study.md">Upload an HTML prototype to a study</a>. Mask task URL is applied automatically to uploaded HTML files.</p><div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p><strong>Tip:</strong> Try managing your task stimuli at the study level rather than on a question-by-question basis. For more information, see <a href="#manage-task-stimuli">Manage task stimuli</a>.</p></div></td></tr><tr><td><strong>Set success URL</strong> (optional, website only)</td><td><p>The URL participants should land on when successfully completing the task. Dscout will report success for this task during analysis based on whether participants visit the URL entered here.</p><div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p><strong>Tip:</strong> Use an asterisk (*) to create a wildcard URL if the place where participants land upon completion can vary.<br><br>For example, <strong><code>https://www.sneakers.com/running/*</code></strong> will consider any URL beginning with <strong>https://www.sneakers.com/running/</strong> a success regardless of what else is in the URL.</p></div><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Note:</strong> In mobile studies, success URLs aren't available when the recording option is <strong>External view</strong>. To use one, choose <strong>In-app view</strong>. For more information, see <a href="/usability-tests/what-are-usability-tests-in-dscout/device-and-recording-options-in-a-usability-test.md">Device and recording options in a usability test</a>.</p></div></td></tr><tr><td><strong>Task flow</strong> (Figma prototype only)</td><td><p>Defines where participants should start and end the task in your Figma prototype. This is useful if you are using the same prototype for multiple tasks because it lets you override the default start screen set by Figma.</p><p></p><p>Hover over the following and click <strong>Edit</strong> to make your selections:</p><p></p><ul><li><strong>Starting screen:</strong> Where participants will be directed when the task begins.</li><li><strong>Success screen (optional):</strong> Where you expect participants to end upon successful completion. Dscout will report success for this task during analysis based on whether participants land on the screen chosen here.</li></ul></td></tr><tr><td><strong>Self-reported completion</strong> (optional)</td><td><p>Adds a follow-up question immediately after the task asking participants, <em>Were you able to successfully complete this task?</em></p><p></p><p>Participants choose one of four answers:</p><p></p><ul><li><strong>Yes</strong></li><li><strong>No - The task was too difficult</strong></li><li><strong>No - I didn't understand the prompt</strong></li><li><strong>No - I had technical issues</strong></li></ul><p>In analysis, you’ll see the percentage of participants who answered Yes.</p></td></tr><tr><td><strong>Single Ease Question (SEQ)</strong> (optional)</td><td><p>Adds a follow-up question immediately after the task asking participants how easy or difficult they found the task.</p><p></p><p>When enabled, participants will see a scale question, <em>Overall, how difficult or easy did you find this task?</em>, with options ranging from <strong>1 - Very difficult</strong> to <strong>7 - Very easy</strong>. In analysis, you’ll see an effort rating distribution for this task.</p></td></tr><tr><td><strong>SEQ Difficulty</strong> (optional)</td><td><p>Adds a follow-up question immediately after the Single Ease follow-up asking participants to explain why they found the task difficult.</p><p></p><p>When enabled, participants who rate task difficulty 1, 2, 3, or 4 will see an open-ended typed response question, <em>Why was this task difficult?</em></p></td></tr><tr><td><strong>Close task stimuli</strong> (optional)</td><td><p>Hides the website or prototype from participants after this task. <strong>By default, task stimuli remain open after participants complete a task.</strong> This setting appears once the task has task stimuli.</p><p></p><p>When enabled, the following behavior applies for each device and recording option:</p><p></p><ul><li><strong>Desktop:</strong> After the task is complete, <em>all</em> non-Dscout tabs are closed.</li><li><strong>Mobile (in-app view):</strong> After the task is complete, the tab where the stimuli were accessible closes so participants can’t revisit them.</li><li><strong>Mobile (external view):</strong> A banner is displayed asking participants to exit the linked URL or prototype.</li></ul><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Note:</strong> Close task stimuli is enabled by default on task questions added to multi-variate sets. For more information, see <a href="/study-basics/question-types/question-settings-and-organization/multi-variate-testing.md">Multi-variate testing</a>.</p></div></td></tr><tr><td><strong>Privacy blur</strong> (optional)</td><td><p>Blurs the participant’s screen during the task. This protects participants’ personally identifiable information (PII) during studies.</p><p></p><p>When enabled, participant audio is recorded during the task, but their screen will not be visible to you during analysis.</p><p></p><p>For more information, see <a href="/study-basics/testing-prototypes/privacy-blur.md">Privacy blur</a>.</p></td></tr><tr><td><strong>Skip logic</strong> (optional)</td><td>Route participants to a later question, question group, or the end of the study once they finish this question. Every participant who answers goes to the same place. For more information, see <a href="/study-basics/design-a-study/skip-logic-in-usability-tests-media-surveys-and-intercept-studies.md">Skip logic</a>.</td></tr></tbody></table>
{% endtab %}

{% tab title="AI moderated studies" %}

<table><thead><tr><th width="220">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Task</strong></td><td><p>The prompt or instructions participants see as part of this task. Here, enter guidance they should follow or any context they should know before beginning the task. For example, if they should complete the task using your company’s app, you should tell them that here.</p><p></p><p>You can format your text in the following ways:</p><p></p><ul><li><code>*bold*</code> = <strong>bold</strong></li><li><code>_italic_</code> = <em>italic</em></li><li><code>&#x3C;https://examplelink.com></code> = <a href="https://examplelink.com/">https://examplelink.com</a></li><li><code>[Sample link](https://examplelink.com)</code> = <a href="https://examplelink.com/">Sample link</a></li></ul><p></p><p>However, only include links here that are supplementary. To link participants to a specific page or prototype related to the task, add it under <strong>Task stimuli</strong>.</p><div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p><strong>Tip:</strong> For inspiration writing task questions, see <a href="https://dscout.com/people-nerds/usability-for-newbies-task-writing-pro">Become a Task Writing Pro</a> from Dscout’s People Nerds.</p></div></td></tr><tr><td><strong>Task stimuli</strong> (optional)</td><td><p>A Figma prototype, website, or HTML file participants should use to complete this task. Stimuli open automatically when participants reach this task.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Note:</strong> If you're using a Figma Make prototype, first <a href="https://help.figma.com/hc/en-us/articles/31304586129559-Publish-update-or-unpublish-a-functional-prototype-or-web-app">publish</a> your prototype in Figma Make. Then, add the provided URL as a <strong>Website</strong> to your task question. Heat maps are not generated for Figma Make prototypes.</p></div><p>For more details on configuring a Figma prototype in Dscout, see <a href="/study-basics/testing-prototypes/add-a-figma-prototype-to-a-study.md">Add a Figma prototype to a study</a>. To upload an HTML file, see <a href="/study-basics/testing-prototypes/upload-an-html-prototype-to-a-study.md">Upload an HTML prototype to a study</a>.</p><div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p><strong>Tip:</strong> Try managing your task stimuli at the study level rather than on a question-by-question basis. For more information, see <a href="#manage-task-stimuli">Manage task stimuli</a>.</p></div></td></tr><tr><td><strong>Starting screen / Success screen</strong> (Figma prototypes)</td><td>For a Figma prototype, set where the participant begins and, optionally, the screen that counts as success.</td></tr><tr><td><strong>Self-reported completion</strong></td><td><p>Adds a follow-up question immediately after the task asking participants, <em>Were you able to successfully complete this task?</em></p><p></p><p>Participants choose one of four answers:</p><p></p><ul><li><strong>Yes</strong></li><li><strong>No - The task was too difficult</strong></li><li><strong>No - I didn't understand the prompt</strong></li><li><strong>No - I had technical issues</strong></li></ul><p>In analysis, you’ll see the percentage of participants who answered Yes.<br><br>This setting is on by default.</p></td></tr><tr><td><strong>Mask task URL</strong></td><td>Hides the destination URL for task questions from participant view. For more information, see <a href="/study-basics/testing-prototypes/mask-task-url.md">Mask task URL</a>.</td></tr><tr><td><strong>Privacy blur</strong></td><td><p>Blurs the participant’s screen during the task. This protects participants’ personally identifiable information (PII) during studies.</p><p></p><p>When enabled, participant audio is recorded during the task, but their screen will not be visible to you during analysis.</p><p></p><p>For more information, see <a href="/study-basics/testing-prototypes/privacy-blur.md">Privacy blur</a>.</p></td></tr><tr><td><strong>Follow-up questions</strong></td><td><p>How many follow-ups the AI moderator asks based on the participant's spoken response: <strong>Only if response is short</strong>, <strong>1 follow-up</strong>, or <strong>2-3 follow-ups</strong>. You can also add optional <strong>Follow-up guidance</strong>.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Note:</strong> Follow-up questions for Task questions are only based on the participant's spoken response. The AI moderator cannot see any action taken by the participant on their screen.</p></div></td></tr><tr><td><strong>Visual intelligence</strong></td><td><p>Captures expressions and screen behavior in participant responses. For more information, see <a href="/ai-moderated-studies/analyze-an-ai-moderated-study/visual-intelligence.md">Visual intelligence</a>.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Note:</strong> Visual intelligence and Privacy blur can't both be on for the same task question. Turn off Privacy blur to use Visual intelligence, or the other way around.</p></div></td></tr></tbody></table>

{% hint style="info" %}
**Note:** Some standard Task settings aren't available in AI moderated studies: SEQ, SEQ difficulty, a website success URL, Close task stimuli, and skip logic. The AI moderator always reads the prompt verbatim.
{% endhint %}
{% endtab %}
{% endtabs %}

### Add a task question to a study

You’ll add task questions on your study's builder tab—the **Usability test**, **Study**, or **AI moderator** tab, depending on your study type.

{% stepper %}
{% step %}
Navigate to your study's builder tab (the **Usability test**, **Study**, or **AI moderator** tab, depending on your study type).
{% endstep %}

{% step %}
Click **+ Add** in the center of the builder or in the left sidebar.
{% endstep %}

{% step %}
Select **Task**. In usability tests and intercept studies, you’ll find it under the **Usability** category.

<div align="left"><figure><img src="https://3976082747-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIKfn7RcT4CW9XaIbqAdd%2Fuploads%2FFBWRPy8nyAwKOMXaXjW2%2FTask_questions.jpg?alt=media&amp;token=472e68b3-565e-40d1-8b57-1881c4650042" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Enter the **Task** prompt or instructions.
{% endstep %}

{% step %}
(Optional) Click **Add** beside **Task stimuli** to add a website or prototype, or to upload an HTML file. The applicable fields will display. For help completing these fields, see [Task question settings](#task-question-settings).

<div align="left"><figure><img src="https://3976082747-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIKfn7RcT4CW9XaIbqAdd%2Fuploads%2FrzjhunQVHvSeJHhXw0kc%2FTask_questions%20(2).jpg?alt=media&amp;token=7516629a-4190-41bd-8b1a-cfe2bff70f6f" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Configure the question's settings in the right sidebar. For more information, see [Task question settings](#task-question-settings).
{% endstep %}

{% step %}
Click **Done**.
{% endstep %}
{% endstepper %}

Now, you’ve successfully added a task question to your study. When participants reach this question, they’ll see the provided instructions for the task. And if you’ve included task stimuli, they open for participants automatically when they begin the task.

#### Group and randomize task questions

In usability tests and intercept studies, task questions work with Dscout's question-organization features:

* [**Question groups**](/study-basics/question-types/question-settings-and-organization/question-groups.md) keep related questions together and can randomize the order they're presented in.
* [**Multi-variate testing**](/study-basics/question-types/question-settings-and-organization/multi-variate-testing.md) presents different concepts or design variants to different participants.
* [**Question banks**](/study-basics/question-types/question-settings-and-organization/question-banks.md) let you save a task question and reuse it across studies.

### Manage task stimuli

Your study might use a number of task stimuli, some of which might apply to multiple task questions. While you can manage stimuli from within each task question, you can also manage them at the study level. Click the **Task stimuli** button at the top of the builder to access all stimuli included in your study:

<figure><img src="https://3976082747-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIKfn7RcT4CW9XaIbqAdd%2Fuploads%2F7tVtyusbFV1VEu6a1hRG%2FHTML_upload%20(9).jpg?alt=media&amp;token=a897829a-396b-4a2f-bdb5-499d9990eed8" alt=""><figcaption></figcaption></figure>

Here, you can add, refresh, and delete stimuli as needed:

<figure><img src="https://3976082747-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIKfn7RcT4CW9XaIbqAdd%2Fuploads%2FDRwjUeVw2bZ03vIxD4Ej%2FHTML_upload%20(10).jpg?alt=media&amp;token=8ac22f4b-b16c-4cea-aa02-52b8c4ccf0ac" alt="" width="563"><figcaption></figcaption></figure>

### Analyze a task question

From the **Responses** tab of a study, you can access specific metrics for each task question in your study:

<img src="https://content.gitbook.com/content/IKfn7RcT4CW9XaIbqAdd/blobs/aHAkb5IbpbjYskPP5k0L/37450804840596" alt="" width="563">

Here, you’ll find the following details:

{% hint style="info" %}
**Note:** In AI moderated studies, analysis includes self-reported completion and (for Figma prototypes) success via the success screen. SEQ ease ratings aren’t available, and click data requires the Chrome extension.
{% endhint %}

<table><thead><tr><th width="220">Metric</th><th>Description</th></tr></thead><tbody><tr><td><strong>Success</strong></td><td>Percentage of participants who reached your designated success URL or prototype success screen. (Only visible if a <strong>Success URL</strong> or <strong>Success screen</strong> is set when building your study.)</td></tr><tr><td><strong>Self-reported completion</strong></td><td>Percentage of participants who indicated they successfully completed the task. (Only visible if the <strong>Self-reported completion</strong> follow-up question is enabled when building your study.)</td></tr><tr><td><strong>Average time on task</strong></td><td><p>Average time participants spent on the task, measured from when they click <strong>Start task</strong> to when they click <strong>End task</strong>. Here, you can also hover over the box plot to see the following statistics:</p><p></p><ul><li><strong>Min:</strong> The shortest amount of time it took for a participant to complete the task.</li><li><strong>Q1:</strong> The lower quartile of response times. 25% of participants took less time than this to complete the task.</li><li><strong>Median:</strong> The exact mid-point of response times for the task.</li><li><strong>Q3:</strong> The upper quartile of response times. 75% of participants took less time than this to complete the task.</li><li><strong>Max:</strong> The longest amount of time it took for a participant to complete the task.</li><li><strong>Mean:</strong> The average amount of time it took participants to complete the task.</li><li><strong>Outliers:</strong> Data points significantly above or below the rest of responses.</li></ul></td></tr><tr><td><strong>Average ease rating</strong></td><td>Average of how participants rated the effort required by the task. (Only visible if the <strong>Single Ease Question (SEQ)</strong> follow-up is enabled when building your study.)</td></tr></tbody></table>

To view details from individual responses, navigate to the **Participants** view while on the **Responses** tab of your study.

### Frequently asked questions

<details>

<summary>Can I use the same Figma prototype for more than one task?</summary>

Yes. Add the prototype to your study once, then select it in each task question and use **Task flow** to set a different **Starting screen** for each task.

If you try to add a prototype that's already in your study, you'll see this message: "This prototype has already been added to the study. To set different starting screens, select this prototype in a task question and edit the starting screen for your task." Select the existing prototype instead of adding it again. You can see every prototype in your study under **Task stimuli** at the top of the builder.

</details>

<details>

<summary>Can I measure task success on a Figma Make prototype?</summary>

Yes, with a success URL. First publish your prototype in Figma Make, then add the published URL as a **Website** (not as a Figma prototype) in your task question, and use **Set success URL** to define the page that counts as success. Dscout doesn't generate heat maps for Figma Make prototypes.

</details>

<details>

<summary>Can I set more than one success URL for a task?</summary>

Each task question has one success URL, but you can use an asterisk (\*) as a wildcard to cover several pages. For example, `https://www.sneakers.com/running/*` counts any page that starts with that address as a success if it's visited at any point during the task. You can use more than one asterisk in a URL, but not two in a row (`**`), and success URLs must start with `https://`.

A trailing slash at the end of the URL is ignored, so `https://www.sneakers.com/cart` and `https://www.sneakers.com/cart/` are treated the same.

</details>

<details>

<summary>Do the Self-reported completion and SEQ follow-ups count toward the 15-task limit?</summary>

No. Only task questions count toward the limit. The follow-up questions that Dscout adds after a task don't use up any of your 15 tasks.

</details>

<details>

<summary>What happens to task data if participants don't use the Chrome extension?</summary>

In desktop usability tests and AI moderated studies where you invite your own participants, you can make the Chrome extension optional by choosing **Extension free**. Auto-recruited studies and intercept studies always require the extension, and mobile studies don't use it.

Without the extension, Dscout can't capture click data or generate heat maps, and can't automatically report success from a success URL or success screen. Time on task, self-reported completion, and the SEQ follow-ups are still collected.

For more information, see [Manage participant experience in a usability test](/usability-tests/create-a-usability-test/manage-participant-experience-in-a-usability-test.md), [Manage participant experience in an AI moderated study](/ai-moderated-studies/create-an-ai-moderated-study/manage-participant-experience-in-an-ai-moderated-study.md), and [Analyze heat maps and click data](/study-basics/testing-prototypes/analyze-heat-maps-and-click-data.md).

</details>

<details>

<summary>How is time on task calculated?</summary>

In usability tests and intercept studies, time on task is measured differently depending on the device:

* **Desktop:** From when the participant selects **Start task** to when they select **End task**. If their recording is interrupted and they pause to fix it, that time is subtracted.
* **Mobile (iOS and Android):** From when the participant begins the task to when they select **End task**. Time spent away from the app, such as responding to a notification, is not subtracted.

On every device, time spent loading a prototype or website counts toward time on task, so a slow-loading prototype can make the time longer. In AI moderated studies, time on task is tracked automatically between the start and end of the task.

</details>

<details>

<summary>Can I change the task stimuli or success URL after launching my study?</summary>

No. Once a study is launched, you can't add, edit, or remove task stimuli or a success URL on a task question. Make sure they're set up the way you want before launching, and preview your study first. For more information, see [Test a usability test](/usability-tests/create-a-usability-test/test-a-usability-test.md).

</details>

<details>

<summary>Can I add photos or other images to a task question?</summary>

No. Task questions only support task stimuli: a website, a Figma prototype, or an HTML file. Regular stimuli, such as images, aren't available on task questions. To show an image, add a separate question that supports stimuli before the task. If you want to show different concepts to different participants, see [Multi-variate testing](/study-basics/question-types/question-settings-and-organization/multi-variate-testing.md).

</details>


---

# 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.dscout.com/study-basics/question-types/activity-questions/task-questions.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 `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.
