> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/en/org/roles.md).

# Roles and Permissions

Roles are how MaiAgent controls who can see what and who can do what. These pages explain how to use roles, from configuration to planning.

Roles determine which features members can see, whether they can create items, and which assistants and knowledge bases they can access. Choose a page based on what you want to do:

<table><thead><tr><th width="260">What do you want to do?</th><th>Read this page</th></tr></thead><tbody><tr><td>Learn about role types, create roles, and select feature permissions</td><td><a href="/maiagent-user-guide/en/org/roles/role-permission.md">Role Permission Management</a></td></tr><tr><td>Control which assistants and knowledge bases a role can see and use</td><td><a href="/maiagent-user-guide/en/org/roles/group-resource-access.md">Role Resource Access Permissions</a></td></tr><tr><td>Filter the member list by role</td><td><a href="/maiagent-user-guide/en/org/roles/group-member-filtering.md">Role Member Filtering</a></td></tr><tr><td>Understand the difference between roles and contacts</td><td><a href="/maiagent-user-guide/en/org/roles/contact-role-comparison.md">Differences Between Roles and Contacts</a></td></tr><tr><td>Let colleagues create assistants while requiring approval and staged publishing for sharing</td><td><a href="/maiagent-user-guide/en/org/roles/role-design-guide.md">Role Permission Planning Guide</a></td></tr></tbody></table>

{% hint style="info" %}
**In simple terms:**

The first four pages explain where the controls are and how to configure them. The last page explains how to structure your roles. When planning your organization's roles for the first time, read the planning guide first, then return to configure them using the first four pages.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.maiagent.ai/maiagent-user-guide/en/org/roles.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.