# Assigning contents to specific Roles

Role-based content customization is one of AIsuru's most powerful features. It lets you create tailored experiences for different types of users, ensuring everyone gets the most relevant information for their needs.

### What are Roles in AIsuru

"Roles" in AIsuru **represent roles or categories of users**. It's like having a specialized version of your Agent for each user group.

For example, you can make your Agent:

* Show technical documentation only to the "support" team;
* Offer special promotions only to "new customers";
* Share financial reports only with "managers".

### How content assignment works

After you've [created a Role](#what-are-roles-in-aisuru), you can assign contents to it:

1. Go to the  **Contents** section of your Agent;
2. Create a new content or edit an existing one;
3. In the "**Assigned to**" field, select the desired Role from the dropdown (by default, contents are visible to everyone with the "Public" option);
4. Save the content.

💡 From now on, only users associated with that Role will be able to see that specific content.

{% hint style="info" %}
**How does it work internally?**

The receiver tag (the role) is passed to the LLM, which can behave differently depending on the role, following the [instructions](/en/generative-ai/ai-instructions.md).
{% endhint %}

### What happens to other users?

When a user without the necessary permissions asks a question related to restricted content, the Agent:

1. Will first look for similar public contents the user has access to;
2. If it doesn't find relevant alternatives, it will use generative AI to provide a response (passing only the contents the user has access to);
3. The user won't know they don't have access to specific contents, so the Agent **can never reveal anything, even if tricked into trying**!

### Tips for effective use

* Create Roles for **groups of users with distinct information needs**;
* Use **clear, descriptive names** to make future management easier;
* **Periodically review content assignments** to keep them current;
* **Test the Agent's responses** with different roles to make sure the experience is optimal for everyone.


---

# 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/assigning-contents-to-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.
