Suggested questions

Enable and display suggested questions in your Ask AI experience.

Ask AI is part of Agent Studio and isn’t available as a standalone feature for new applications. Use these docs for existing Ask AI implementations. To move an existing assistant, see Migrate Ask AI to Agent Studio.

Suggested questions guide users toward common or helpful queries and improve engagement. They appear in your Ask AI interface as clickable prompts. Users select a prompt to get started.

Getting started

You can set up suggested questions during assistant creation or from the assistant analytics view:

During assistant creation

When creating a new Ask AI assistant, the last (optional) step lets you add suggested questions in the setup flow. This is the quickest way to add initial suggestions before launching your assistant.

You can add up to three questions. They become active as soon as you create your assistant.

From the assistant analytics view

For existing assistants, you can manage suggested questions from the Analytics view. This approach is data-driven. Select questions based on real user behavior and performance metrics.

1. Open your assistant’s Analytics page and locate the Active Suggestions section.

   

2. Click Edit Questions to open the Suggested Questions Manager.

   

3. From there, you can drag questions from a pool of user-submitted queries. Each question shows the number of interactions and any thumbs up or thumbs down feedback.

4. Move up to three questions into the Active Suggested Questions section by Publishing or Unpublishing them. Published questions appear in your frontend UI.

   

Index creation

When you add suggested questions, Algolia automatically creates an named algolia_ask_ai_suggested_questions in your . Ask AI uses this index to retrieve and display suggested questions in your app.

Algolia stores each suggested question with its assistant ID. On the frontend, filters automatically filter these , so each assistant shows only its own suggested questions.

You shouldn’t change the index configuration or records manually. Ask AI automatically manages the index so suggested questions work correctly.

Enabling suggested questions

This feature is available in DocSearch v4.3 and later.

To enable the suggested questions feature in your app, update your Ask AI initialization configuration. This connects your frontend to the algolia_ask_ai_suggested_questions index.

Add the following property to your Ask AI configuration: suggestedQuestions: true

JavaScript

docsearch({
  // ...
  askAi: {
    assistantId: 'YOUR_ALGOLIA_ASSISTANT_ID',
    suggestedQuestions: true,
  },
});

Once you enable it, your app automatically retrieves and displays suggested questions for each assistant.

For more configuration options and examples, see the DocSearch API reference.

Display on the frontend

Once you enable the feature, suggested questions automatically appear in your Ask AI user interface. You can customize their placement, layout, and styling to match your app’s design and user experience.

Generating answers from clicks

When a user clicks a suggested question, Ask AI generates and displays a response, just as it would for a manually entered . This gives users a seamless experience. They discover answers with a single click.