> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pyne.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ask

The `Ask` step presents the user with a question and multiple-choice answers (actions).

**Key Characteristics:**

* **Avatar Behaviour:** The avatar pauses until the user selects one of the provided answer options (actions).
* **Progression:** The guide proceeds based on the action configured for the selected answer (e.g., proceed to next step, redirect, pause guide).
* **Common Use Cases:**
  * Inviting the user to start a tour.
  * Asking questions mid-guide to collect user data or feedback.
  * Providing branching logic (e.g., "What do you want to learn about?").
  * Linking to external resources (Knowledge Center, booking links).
  * Connecting different guides together.

*Example: Starting the guide using Question in TheyDo (actions: first, Pause the Guide, then Proceed to Next)*

<video controls width="100%" src="https://base.pyne.ai/storage/v1/object/public/docs//ezgif-3-9316917bb1.mp4" title="Ask Step Example Video">
  Sorry, your browser doesn't support embedded videos.
</video>

***

### Setup & Styling

The `Ask` step is configured in the **right sidebar**. First, specify the question text. Then, add actions (answer options) and configure their behavior.

### Step Configuration

Configure the `Ask` step using the right sidebar:

<img src="https://mintcdn.com/pynegmbh/kQ-U5xvcWyOX7gqR/assets/images/ask-step-sidebar.png?fit=max&auto=format&n=kQ-U5xvcWyOX7gqR&q=85&s=560ee80ff3044c4082fed0edba0027c4" alt="Ask Step Sidebar" width="776" height="898" data-path="assets/images/ask-step-sidebar.png" />

**Button Type:**

You can set the **Button type** for each action as **primary** (white) or **secondary** (dark with white border). Use the primary style to visually emphasize the desired or most common outcome.

<img src="https://mintcdn.com/pynegmbh/kQ-U5xvcWyOX7gqR/assets/images/button-type-options.png?fit=max&auto=format&n=kQ-U5xvcWyOX7gqR&q=85&s=798ddb0c8dfde572b4499353f1cd59e4" alt="Button Type Options" width="1530" height="518" data-path="assets/images/button-type-options.png" />

**Available Actions (Behaviours):**

There are **6 actions** that can be triggered when a user clicks an answer option:

1. **Proceed to next**
   The avatar continues to the next step in the current guide.

   <video controls width="100%" src="https://base.pyne.ai/storage/v1/object/public/docs//ezgif-3-9316917bb1.mp4" title="Proceed to Next Action Video">
     Sorry, your browser doesn't support embedded videos.
   </video>

2. **Redirect to link**
   The user is redirected to an external URL (e.g., Calendly, Knowledge Base article).
   *Configuration:* Specify the URL and whether it opens in the same tab, new tab, or new window.

   <video controls width="100%" src="https://base.pyne.ai/storage/v1/object/public/docs//ezgif-5-5407d18fb9.mp4" title="Redirect to Link Action Video">
     Sorry, your browser doesn't support embedded videos.
   </video>

   > **💡 URL format:** Use a standard URL, e.g., `https://pyne.ai/`

3. **Pause the guide**
   The avatar minimizes. The user can resume the guide later by clicking the minimized avatar.

   <video controls width="100%" src="https://base.pyne.ai/storage/v1/object/public/docs//Minimised_avatar.mp4" title="Pause Guide Action Video">
     Sorry, your browser doesn't support embedded videos.
   </video>

4. **End the guide**
   The avatar is completely dismissed. The user cannot easily resume the guide.

5. **Redirect to the guide**
   A different, specified guide is started.
   *Configuration:* Connect guides using the target **Guide ID**.

   <video controls width="100%" src="https://base.pyne.ai/storage/v1/object/public/docs//Redirect_to_the_guide.mp4" title="Redirect to Guide Action Video">
     Sorry, your browser doesn't support embedded videos.
   </video>

   > **💡 Finding the Guide ID:** The ID is the alphanumeric string in the guide's
   > URL after `/guides/`. For `https://dashboard.pyne.ai/guides/ce3eba58-37d1-4bb6-962d-c08955a0a3fb`,
   > the ID is `ce3eba58-37d1-4bb6-962d-c08955a0a3fb`.

6. **Click to element**
   The avatar simulates a click on a specified page element. No user action is required after selecting the answer.
   <video controls width="100%" src="https://base.pyne.ai/storage/v1/object/public/docs//Element.mp4" title="Click to Element Action Video">
     Sorry, your browser doesn't support embedded videos.
   </video>
