# What are dynamic intents and how to configure them

**Dynamic intents** are an advanced AIsuru feature that lets your Agent perform **actions** in response to specific user requests. This powerful feature lets you connect your Agent **to external services, automate processes, and deliver dynamic responses** based on **real-time data**.

### How a dynamic intent works

A dynamic intent goes through several phases:

* The user sends a specific message (the dynamic intent invocation);
* AIsuru recognizes the intent and extracts any **slot** values;
* AIsuru calls the **webhook**, passing the intent name and slot values;
* The webhook processes the request and returns a response;
* The Agent shows the processed response to the user, without any further processing.

### How to configure a dynamic intent

To configure a new dynamic intent, follow these steps:

1. Go to your Agent's management panel in AIsuru;
2. Select "**Functions**" from the sidebar;
3. Navigate to the "**Dynamic intents**" tab and press the "**New intent**" button;
4. Fill in the following fields:
   * **Name**: a unique identifier for the intent (no spaces);
   * **Invocations**: the phrases that will trigger this intent;
   * **Webhook**: the URL of the external service to call;
   * **Validity**: specifies how long to cache the response.
5. Select the "**Call when inactive**" option if you want the intent to be triggered during user inactivity:
   * If selected, this intent will be called when the user is inactive.
   * Can be used to notify service statuses or provide personalized suggestions based on background actions.
   * In this case, the invocation text will be empty.
6. Save the intent;
7. Remember to [**configure slots**](/en/advanced-features/integrations/dynamic-intents/how-to-use-slots.md) if needed.

### Benefits of dynamic intents

1. **Integration with external services**: easily connect the Agent to external APIs and databases;
2. **Real-time responses**: provide up-to-date information based on current data;
3. **Automation**: execute specific actions in response to certain requests;
4. **Personalization**: create tailored, contextual user experiences;
5. **Flexibility**: easily adapt the Agent to new features and use cases.

### Usage examples

Dynamic intents can be used in various scenarios, such as:

* Retrieving real-time **weather** information;
* Making **reservations** in an external system;
* Checking the **status of an order** or shipment;
* Providing updated **stock quotes**;
* Interacting with **home automation** systems.

Once configured, your Agent will use this intent whenever it recognizes one of the invocation phrases in a conversation, letting you create more dynamic and powerful interactions.


---

# 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/advanced-features/integrations/dynamic-intents/what-are-dynamic-intents-and-how-to-configure-them.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.