> For the complete documentation index, see [llms.txt](https://docs.askyazi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.askyazi.com/build-a-study/ask-yazi.md).

# Ask Yazi

Use Ask Yazi, the assistant inside the app, to draft and edit studies, change logic and translations, and check how fieldwork is going.

Ask Yazi is the AI assistant built into the Yazi web app. You describe what you want in plain language, for example "add a question asking how often they shop online" or "who is stuck in my study?", and it either makes the change for you (after you approve it) or explains how to do it.

{% hint style="info" %}
**In short:** open Ask Yazi from the tab on the right edge of any screen. It can edit questions, logic, translations and AI interview settings, convert a study's type and report on fieldwork. On a live or paused study it always shows you the change and waits for your approval. It never sends anything to participants.
{% endhint %}

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2F7Qqbf66JtFbHZ4HziAMG%2Fask-yazi-panel.webp?alt=media&amp;token=5bf43370-9b3a-43b6-a849-4416d8bda2c4" alt="The Ask Yazi panel with past conversations and suggested prompts"><figcaption></figcaption></figure>

## Where to find it

When you land on a screen, Ask Yazi introduces itself for a few seconds in the bottom right and then tucks away as a small tab on the right edge. Hover over the tab and it slides out; click it to open the chat. The panel opens to about half the screen and you can drag it wider or narrower. Use **Minimise** inside the panel to send it back to the tab.

Ask Yazi knows which screen and which study you are on, so you can say "this study" or "Q4" without naming it.

## What it can do

| Area                      | Examples of what you can ask                                                                                                                                                                                                                                                                            |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Draft a study**         | "Propose a 15-question survey on how students budget for data." It can also build a study from a document you attach.                                                                                                                                                                                   |
| **Edit questions**        | Add, reword, reorder or delete questions; change a question's type; add or edit answer options; build or convert matrix questions.                                                                                                                                                                      |
| **Logic**                 | "Screen out anyone under 18 at Q2", "only show Q9 to people who chose Daily at Q8". Several logic changes can be applied in one go.                                                                                                                                                                     |
| **Translations**          | Translate questions, or paste in corrected translations from a reviewer and have them written into the study.                                                                                                                                                                                           |
| **AI interview settings** | Change probing intensity, question style, interview flow, sensitive-topic handling, the maximum number of questions, target audience, key topics, required questions, the multiple-choice toggle, cultural notes, comparative brands, when the interview may end early, and **Cross-campaign context**. |
| **Study type**            | Convert a study from one type to another, for example a survey into an AI interview, keeping questions and responses.                                                                                                                                                                                   |
| **Fieldwork status**      | "How is my study going?" or "Is anyone stuck?" It places every participant by activity, names who has gone quiet and why (for example "on question 6, which asks for a video; the last thing they sent was a photo"), and can draft a message you could send.                                           |
| **Explain features**      | It can explain features it cannot set up itself. See below.                                                                                                                                                                                                                                             |

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2F0XUQNEY9xmlUFIR9yiGu%2Fask-yazi-audit.webp?alt=media&amp;token=ffd8e111-a1f8-4782-b265-e951d4ef3686" alt="Ask Yazi reviewing a study&#x27;s branching logic and suggesting fixes in a summary table"><figcaption></figcaption></figure>

### Attaching documents and using your voice

* **Attach files** with the paperclip: PDF, DOCX, DOC, TXT, XLSX and XLS, plus images. Useful for "build a study from this brief" or "apply the translations in this file".
* **Speak instead of typing** with the microphone. Your words are transcribed as you speak, for voice notes of up to about four minutes.

### When it asks you something back

If your request is ambiguous, Ask Yazi asks a clarifying question rather than guessing. Short choices, such as yes or no, appear as buttons you can tap.

## How changes are applied

1. You ask for a change.
2. Ask Yazi shows a proposal card that names the study and the questions it will touch (for example "Q1"), with answer options shown as tags.
3. On a draft study, simple edits are applied directly. On a **Live** or **Paused** study, every change that could affect participants, including deleting a question, waits for you to approve it.
4. When it has finished, a summary card at the top of the panel tells you what happened, for example "3 of 4 changes applied", and lists anything that failed or was skipped. Expand it to see each step.

Several changes in one request are proposed and approved together on one card.

## What it cannot do

Ask Yazi explains these features but does not set them up for you. Use the screens named here instead:

| Feature                        | Where to set it up                                                                                                                                                                |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Rewards and incentives         | **Build > Study configuration > Completion & follow-up > Advanced options > Give a reward**. See [Set up rewards](https://docs.askyazi.com/reach-participants/set-up-rewards.md). |
| Automatic reminders            | **Share > Reminders**, using an approved broadcast with **Continue** and **Opt-out** buttons. See [Reminders](https://docs.askyazi.com/reach-participants/reminders.md).          |
| Answer-option piping           | The **Piping** window on the question. See [Piping](https://docs.askyazi.com/build-a-study/piping.md).                                                                            |
| Sending broadcasts or messages | **Share > Send broadcast**. Ask Yazi only ever drafts messages; it never sends anything to a participant.                                                                         |
| Launching or deleting a study  | You do this yourself from the study status and **Manage study** menu.                                                                                                             |

## Tips for good results

* **Be specific.** "Make Q7 a multi-select with a maximum of 3 and add None of the above" works better than "fix Q7".
* **Name questions by number.** Ask Yazi uses the same Q numbers you see in the builder.
* **Review before approving.** Read the proposal card, especially on a live study.
* **Check the result in the builder.** Open the question and the **Logic Map** after a logic change, and test the study again.
* **Proofread AI wording.** Like the brief importer, Ask Yazi may rephrase. If wording is signed off, say "keep the wording exactly as written".

## Limits and things to know

* **It needs AI to be switched on for your organisation.** If your organisation has turned AI off, or has reached its AI spend limit, Ask Yazi says so once in the chat (for example "AI spend cap reached. Try again later.") and stops.
* **It cannot apply AI interview settings to a survey or diary study**, and says so rather than pretending.
* **Editing options on a live study can affect results.** Changing answer options mid-field can make earlier answers harder to chart. Pause the study first and see [Publish and go live](https://docs.askyazi.com/study-types/publish-and-go-live.md).
* **It does not know about every early-access feature.** If it says something cannot be done and you think it can, check the docs or contact support.
* **Conversations are listed in the panel** and name themselves after your first question, so you can return to them later.

## Related

* [Create a study](https://docs.askyazi.com/build-a-study/create-a-study.md)
* [Question types](https://docs.askyazi.com/build-a-study/question-types.md)
* [Logic and routing](https://docs.askyazi.com/build-a-study/logic-and-routing.md)
* [AI-moderated interviews](https://docs.askyazi.com/study-types/ai-interviews.md)
* [Languages and translation](https://docs.askyazi.com/study-types/languages-and-translation.md)
