# Managing suggestions

AIsuru lets you guide conversations with your Agent through suggestions. This feature lets you present users with a set of predefined options as clickable buttons, making interactions smoother and more focused.

### How suggestions work

When you add suggestions to a content:

1. The user will see the suggestions as **interactive buttons** after the Agent's response;
2. Clicking a button sends the suggestion's text as if the user had typed it;
3. The Agent will respond based on the content that matches the selected suggestion.

💡 This feature is especially useful for **guiding users through specific processes** or steering the conversation toward **predefined topics**.

### How to add suggestions

To add suggestions to a content:

1. Go to the content creation or editing screen;
2. Find and open the "Advanced: suggestions" section under "Advanced";
3. Click  **Add** to insert a new suggestion;
4. Enter the text you want to appear on the button;
5. Repeat the process to add more suggestions, then save your changes by clicking the confirm button at the bottom right.

To delete suggestions, click the red button  next to each one.

### Benefits of using suggestions

* **Guides the user**: helps users navigate through predefined options;
* **Reduces errors**: limits the chances of unexpected or misunderstood inputs;
* **Improves user experience**: makes interactions smoother and more intuitive;
* **Increases efficiency**: speeds up the process of getting the desired information.

### Example conversation flow

User: "I'm having a problem with my computer."

Agent: "Sorry to hear that. I can help you fix it. What kind of problem is it?"

Suggestions:

* The computer won't turn on
* The internet connection isn't working
* An application is not responding
* Something else

User: \[Clicks "The computer won't turn on"]

Agent: "I understand your computer won't turn on. Let's try a few steps to fix it. First, check that the power cable is properly connected. Have you checked?"

Suggestions:

* Yes, the cable is connected correctly
* No, the cable wasn't plugged in

### Tips for effective use of suggestions

1. **Limit suggestions to 2–5** to avoid overwhelming the user;
2. Make sure there are matching contents for each suggestion (or at least that the [generative AI](/en/generative-ai.md) knows how to respond correctly);
3. Regularly update suggestions based on the most common user interactions.

Smart use of suggestions can transform your Agent from a simple assistant into an interactive, effective guide. Use this feature to create rich, focused conversational experiences that significantly improve user engagement and satisfaction.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aisuru.com/en/agent-training/advanced/content-customization/managing-suggestions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
