# Creating and managing Roles

Roles in AIsuru are the key to creating personalized experiences with your Agents. This powerful tool lets you tailor the Agent's responses based on specific user roles or categories, making interactions more relevant and effective.

### Creating a new Role

To add a new Role to your Agent:

1. From the sidebar, select "Roles";
2. Click the  **New role** button;
3. Define the required information:

   1. Name: assign a descriptive name (e.g., "Director", "VIP Customer");
   2. Information: assign a description to this role;
   3. Select an emoji as a Tag;
   4. (Optional) Customize the Pin (must remain a 6-digit numeric code).

   *The person's Tag and Pin can be used to access the Agent with that specific role via the API.*
4. Press "Confirm" to save.

### Assigning users to specific roles

You can assign users who are already registered on the platform to specific roles:

1. Go to the Roles section of your Agent;
2. Find the Role you're interested in in the table;
3. Press the **Invite** button on the right in the same row as the Role, then click  **Add**;
4. Add the email address and, if you want, customize the message;
5. Press the  **Send** button to confirm the assignment.

✅ Done! From now on, invited users who chat with the Agent will access it with the Role you assigned them.

#### What about unregistered users?

You can have unregistered users automatically access the Agent with a certain role. To do this:

* **Create a "Unregistered users" Role** and don't invite anyone to it;
* Go to the Sharing section from the sidebar and press **Add Layout**;
* In the [advanced parameters](/en/sharing/create-and-manage-sharing-layouts.md#advanced-layout-configuration), **set "Unregistered users" as the role**;
* **Set the layout as default**.

From now on, all unregistered users will have a dedicated Role that you can [assign content to](/en/agent-training/advanced/content-customization/assigning-contents-to-roles.md).

{% hint style="warning" %} <mark style="color:orange;">**Deleting a Role does not affect content or layouts**</mark> <mark style="color:orange;">associated with it, but removes the personalization based on that role.</mark>
{% endhint %}

Roles in AIsuru let you create a highly personalized interaction experience. Experiment with different roles and customizations to maximize your Agent's effectiveness and give each user exactly what they need.


---

# 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/user-management/creating-and-managing-roles.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.