> 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/dscout-ai/dscout-ai-studio/draft-a-study-with-dscout-ai.md).

# Draft a study with Dscout AI

Dscout AI can help you draft entire screeners and studies, chatting through research goals, defining recruitment criteria, and writing comprehensive study questions. Unsure where to start when testing your Figma prototype? Have an idea of what you want to learn but no concrete plan on how to get answers? Dscout AI can take you from question to launch-ready in no time.

**Dscout AI can help you draft the following:**

* Standalone screeners.
* Usability tests.
* Media surveys.
* AI moderated studies.

{% hint style="info" %}
**Note:** To draft a study with Dscout AI, you must first have a project set up in Dscout. For more information, see [Create a project, study, or screener](https://help.dscout.com/getting-started/workspaces-and-projects/create-a-project-study-or-screener.md).
{% endhint %}

**To draft a study with Dscout AI:**

{% stepper %}
{% step %}
Click the **Draft with Dscout AI** button in the top right corner of your project. A new chat with Dscout AI is displayed.

<div align="left"><img src="https://content.gitbook.com/content/IKfn7RcT4CW9XaIbqAdd/blobs/VTdUkMEwXlC1oAgblv8G/47420998482836" alt=""></div>
{% endstep %}

{% step %}
Enter and send a prompt (or choose a starter prompt) to begin chatting with Dscout AI.

{% hint style="success" %}
**Tip:** Have a research brief or an HTML prototype? Attach it to your message to give Dscout AI more to work with. For more information, see [Add files to your chat](#add-files-to-your-chat).
{% endhint %}

<div align="left"><figure><img src="https://3976082747-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIKfn7RcT4CW9XaIbqAdd%2Fuploads%2FspgDoY7zaeiqUAkvl66A%2FDYS%20updates.jpg?alt=media&amp;token=5ae8684f-1d48-4328-aa87-532742c58071" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Continue chatting with Dscout AI to confirm some study basics, including:

* Research objectives.
* Recruitment approach and criteria.
* Prototype or website URLs you wish to test (or upload an HTML prototype).

{% hint style="success" %}
**Tip:** If you're testing a password-protected Figma prototype, be sure to provide the password in the chat with Dscout AI. Dscout AI will then help you work it into your study so participants can access it.
{% endhint %}

<div align="left"><img src="https://content.gitbook.com/content/IKfn7RcT4CW9XaIbqAdd/blobs/XOpb1Ft1jZnHuKVFsChA/47421030361364" alt=""></div>
{% endstep %}
{% endstepper %}

Once Dscout AI has enough information, your chat will narrow to the left of the page and a draft will open on the right. You can continue chatting with Dscout AI to make adjustments, or you can edit your draft directly. Edit question and answer text right in the draft, or change a question’s settings yourself. For more information, see [Change question settings](#change-question-settings).

![](https://content.gitbook.com/content/IKfn7RcT4CW9XaIbqAdd/blobs/yr1aFIlNIPjRlyce17Hb/47421030362772)

{% hint style="info" %}
**Note:** Studies drafted with Dscout AI won’t include skip logic. You can add skip logic manually in the builder. For more information, see [Open a drafted study in the builder](#open-a-drafted-study-in-the-builder).
{% endhint %}

When everything looks good, refer to the [Open a drafted study in the builder](#open-a-drafted-study-in-the-builder) section to learn how to move into the builder where you’ll launch your screener or study.

## Add files to your chat

Give Dscout AI more to work with by attaching files to your messages:

* **PDFs**, like a research brief or project plan, help Dscout AI understand what you want to learn and draft your study around it.
* **HTML prototypes** are added to your study's task questions for participants to test.

You can attach files to your first message or at any point in the conversation, and a single message can include both a PDF and prototypes.

**To attach a file:**

{% stepper %}
{% step %}
Click the **Add attachment (+)** icon in the chat box. Then, select **Upload a PDF file** or **Upload HTML/ZIP prototype**.

{% hint style="info" %}
**Note:** If only one option is available to you, clicking the icon opens your files right away. PDF upload isn't available to collaborators.
{% endhint %}

<figure><img src="https://3976082747-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIKfn7RcT4CW9XaIbqAdd%2Fuploads%2F7PyrKUwT3owKaCZR5UK6%2FDYS_upload.jpg?alt=media&amp;token=da5c195e-0190-4dca-9426-36b7400e57b2" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Locate and select your file. Then, click **Open**. Your file is displayed as a card in the chat box.

{% hint style="success" %}
**Tip:** You can also drag and drop files straight into the chat.
{% endhint %}
{% endstep %}

{% step %}
Add a message letting Dscout AI know what the file is for, then send it.
{% endstep %}
{% endstepper %}

### How Dscout AI uses a PDF

Dscout AI reads your entire PDF—text, tables, charts, and images—and refers back to it throughout your conversation. Scanned documents work, too.

{% hint style="success" %}
**Tip:** Have a Word document or Google Doc? Save or export it as a PDF first, then attach the PDF.
{% endhint %}

When drafting your study from a PDF, Dscout AI:

* **Keeps your wording.** Research objectives, success metrics, and similar details are carried into your study as written, not paraphrased.
* **Only uses links it can see.** If your PDF mentions a prototype but doesn't include the link, Dscout AI asks you for it.
* **Checks before overriding.** If a new PDF conflicts with something you've already agreed on in the chat, Dscout AI asks which one should win before changing your draft.
* **Does not refer to documents from other sessions.** PDFs uploaded to other chats do not influence decisions made in your current chat.

Click a PDF's card at any time to open it again.

{% hint style="info" %}
**Note:** Once you send a PDF, it stays in the conversation and can’t be removed. If you no longer want Dscout AI to use it, tell Dscout AI in the chat. To work from a completely different document, start a new thread. For more information, see [Start a new thread](#start-a-new-thread).
{% endhint %}

**PDF limits:**

| Requirement               | Limit                     |
| ------------------------- | ------------------------- |
| **File type**             | `.pdf`                    |
| **File size**             | 10 MB or smaller          |
| **PDFs per message**      | 1                         |
| **PDFs per conversation** | 50 MB and 100 pages total |
| **PDFs per day**          | 200 MB in any 24 hours    |

### How Dscout AI uses an HTML prototype

When you attach a prototype, Dscout checks it against the same requirements as any other HTML upload: HTML and CSS only, with everything it needs bundled inside. Dscout AI then tells you which files passed. For any that didn't, it explains what went wrong. For the full list of requirements, see [Upload an HTML prototype to a study](https://help.dscout.com/study-basics/testing-prototypes/upload-an-html-prototype-to-a-study.md).

Once a prototype passes, Dscout AI adds it to a task question as that question's task stimuli. If your study doesn't have a task question yet, Dscout AI adds one or asks you where the prototype belongs.

{% hint style="info" %}
**Note:** Dscout AI can't see your prototype's screens. To get the most relevant tasks, describe the flows and screens you want participants to work through in the chat.
{% endhint %}

You can attach up to 5 prototypes per message. Each prototype can be up to 25 MB. When a PDF and prototypes are attached to the same message, they can't exceed 25 MB combined.

You can also add a prototype directly to a task question in your draft. Hover over the question, click the **Question settings (...)** icon, then select **Upload HTML/ZIP prototype**.

{% hint style="info" %}
**Note:** Before you can launch your study, you’ll need to preview and confirm any uploaded prototype in the builder, including prototypes Dscout AI added for you. For more information, see [Preview an uploaded file](https://help.dscout.com/study-basics/testing-prototypes/upload-an-html-prototype-to-a-study.md#preview-an-uploaded-file).
{% endhint %}

## Change question settings

You don’t need to ask Dscout AI to change how a question works. Randomize choices, adjust a scale’s range, set the minimum and maximum number of choices participants can select, and more, right in your draft.

**To change a question’s settings:**

{% stepper %}
{% step %}
Hover over a question in your draft, then click the **Question settings (...)** icon in the top right corner of the question.

<div align="left"><figure><img src="https://3976082747-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIKfn7RcT4CW9XaIbqAdd%2Fuploads%2F4kNZ4819zHeTyK4hSpXA%2FDYS_edits.jpg?alt=media&amp;token=b15df1fa-29e5-4049-ad8b-c82ce823061f" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Adjust any of the settings displayed in the menu.
{% endstep %}
{% endstepper %}

The settings available depend on the question type. For example:

| Question type                                                                                                                                               | Settings you can change                                                                                                                                                                             |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Multiple choice](https://help.dscout.com/study-basics/question-types/closed-ended-questions/multiple-choice-questions.md) (Single-select and Multi-select) | <ul><li>Min and Max (number of choices participants can select)</li><li>Randomize choices</li><li>"Other" option</li><li>"None of the above" option</li></ul>                                       |
| [Scale](https://help.dscout.com/study-basics/question-types/closed-ended-questions/scale-questions.md)                                                      | <ul><li>Start value</li><li>End value</li><li>"Not applicable (N/A)" option</li></ul>                                                                                                               |
| [Rank](https://help.dscout.com/study-basics/question-types/closed-ended-questions/ranking-questions.md)                                                     | <ul><li>Rank at least</li><li>Rank at most</li><li>Mark rank options as N/A</li><li>Randomize rank choices</li><li>"Other" option</li></ul>                                                         |
| [Card sort](https://help.dscout.com/study-basics/question-types/activity-questions/card-sort-questions.md)                                                  | <ul><li>Type (Closed, Open, or Hybrid)</li><li>Randomize card order</li><li>Randomize category order</li></ul>                                                                                      |
| [Task](https://help.dscout.com/study-basics/question-types/activity-questions/task-questions.md)                                                            | <ul><li>Privacy blur</li><li>Self-reported completion</li><li>Single Ease Question (SEQ)</li><li>SEQ difficulty</li><li>Task URL</li><li>Close task URL</li><li>Upload HTML/ZIP prototype</li></ul> |
| [Typed response](https://help.dscout.com/study-basics/question-types/open-ended-questions/typed-response-questions.md)                                      | <ul><li>Character limit</li><li>Copy & paste allowed</li></ul>                                                                                                                                      |
| [Video](https://help.dscout.com/study-basics/question-types/open-ended-questions/video-questions.md)                                                        | <ul><li>Video length</li></ul>                                                                                                                                                                      |
| [Question group](https://help.dscout.com/study-basics/question-types/question-settings-and-organization/question-groups.md)                                 | <ul><li>Randomize questions</li></ul>                                                                                                                                                               |
| [Multi-variate](https://help.dscout.com/study-basics/question-types/question-settings-and-organization/multi-variate-testing.md)                            | <ul><li><strong>Show one</strong> variant or <strong>Show all</strong> variants</li></ul>                                                                                                           |

To change the settings of a question group or multi-variate question, hover over it and click the **Group settings** or **Multivariate settings** icon instead.

In AI moderated studies, some questions also include settings like **Ask follow-ups** and **Read verbatim**.

You can also duplicate or delete a question from the **Question settings (...)** menu.

{% hint style="info" %}
**Note:** If you can’t change a question’s settings, your draft may be locked for editing. This can happen while Dscout AI is making changes, or if your user permissions don’t allow editing. Wait a moment and try again, or try once you open your study in the builder.
{% endhint %}

## Open a drafted study in the builder

When you and Dscout AI have gotten your study to a good place, you’ll open your study in the builder. Here, you can give everything one final look and add advanced settings like skip logic before opening your study to participants.

**To open your study in the builder:**

{% stepper %}
{% step %}
Click **Create study** in the top right corner of the Dscout AI chat window. A modal is displayed containing your study’s details.

<div align="left"><img src="https://content.gitbook.com/content/IKfn7RcT4CW9XaIbqAdd/blobs/AMTbOLv3bLm6bvQPPoXg/47421030367636" alt=""></div>
{% endstep %}

{% step %}
Verify the following details are correct, as populated by your chat with Dscout AI.

{% hint style="info" %}
**Note:** The fields displayed in this modal will vary based on screener or study type.
{% endhint %}

<div align="left"><figure><img src="https://3976082747-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIKfn7RcT4CW9XaIbqAdd%2Fuploads%2FlyVjnl8Q6o14wY5lYGQX%2FCreate%20modal.png?alt=media&amp;token=2ac852cd-b3f5-438d-b937-e61c7d090c53" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Click **Create study**.
{% endstep %}
{% endstepper %}

Now, your study opens in the builder. Here, you can add advanced settings like skip logic, verify your study overview and incentive, and launch your study when everything looks exactly how you want it.

## View chat history

Previous chats with Dscout AI are available even after they’ve been turned into launched studies. Existing chats can serve as good starting points if you need to conduct similar research. Pick up right where you left off, chat with Dscout AI to make any needed changes, then launch your next study.

{% hint style="info" %}
**Note:** You only have access to your own previous chats, and the chat history is project-specific. You’ll only see chats from the project through which you access Dscout AI.
{% endhint %}

**To view your Dscout AI chat history:**

{% stepper %}
{% step %}
Click the **Draft with Dscout AI** button in the top right corner of your project. A new chat with Dscout AI is displayed.

<div align="left"><img src="https://content.gitbook.com/content/IKfn7RcT4CW9XaIbqAdd/blobs/VTdUkMEwXlC1oAgblv8G/47420998482836" alt=""></div>
{% endstep %}

{% step %}
Click the **History (clock)** icon in the left sidebar.

<div align="left"><figure><img src="https://3976082747-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIKfn7RcT4CW9XaIbqAdd%2Fuploads%2FzM0yEVavQzCrwVY7n3E2%2FDYS%20updates%20(1).jpg?alt=media&amp;token=ea6fc626-bba0-4db7-b509-4d6cd861fdf2" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

Now, a list of your previous chats is displayed. Click any chat to open it again right where you left off:

![](https://content.gitbook.com/content/IKfn7RcT4CW9XaIbqAdd/blobs/4gLkc7PH70lvbQaAgrq7/47421030377876)

## Start a new thread

While you’re drafting with Dscout AI, you can start a new thread at any time to work on something new. Previous threads are available in your chat history, so you can switch back to your existing conversation when you’re ready.

**To start a new thread with Dscout AI,** click the **New thread (plus)** icon in the left sidebar:

![](https://content.gitbook.com/content/IKfn7RcT4CW9XaIbqAdd/blobs/xxx3wgeFGS2MHfoMPFIH/47420998520596)

Now, a new chat opens where you can talk through new ideas, share new research objectives, and draft a new study.

To learn more about how Dscout AI can help speed up your research, see [What is Dscout AI?](https://help.dscout.com/dscout-ai/what-is-dscout-ai.md).


---

# 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/dscout-ai/dscout-ai-studio/draft-a-study-with-dscout-ai.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.
