# Roles

La pestaña "Roles" está destinada a la configuración de los derechos de acceso de los usuarios a las herramientas de Sherpa AI Server. No hay un límite en la cantidad de roles que se pueden crear.

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-62b2a9cf4ba92ea1e4cad0378b90aa4907ff2892%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(489).png?alt=media" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="55.77777099609375"></th><th width="260.66668701171875"></th><th valign="top"></th></tr></thead><tbody><tr><td><strong>N.º</strong></td><td><strong>Elemento de interfaz</strong></td><td valign="top"><strong>Descripción</strong></td></tr><tr><td>1.</td><td>botón "Crear"</td><td valign="top">Permite crear nuevos Roles.</td></tr><tr><td>2.</td><td>botón "Actualizar"</td><td valign="top">Permite actualizar forzosamente la tabla "Roles".</td></tr><tr><td>3.</td><td>botón "Eliminar seleccionado"</td><td valign="top">Permite eliminar los Roles seleccionados de Sherpa AI Server. También se pueden eliminar Roles individuales haciendo clic en el botón en la fila correspondiente de la tabla "Roles". Al eliminar Roles, aparece una ventana para confirmar la eliminación.</td></tr><tr><td>4.</td><td>botón "Exportar a CSV"</td><td valign="top">Genera un archivo de datos de Roles en formato CSV (Comma-Separated Values) para importar en hojas de cálculo y sistemas de contabilidad.</td></tr><tr><td>5.</td><td>botón "Exportar a XLSX"</td><td valign="top">Genera un archivo de datos de Roles en formato Microsoft Excel (XLSX) para importar en hojas de cálculo y sistemas de contabilidad.</td></tr><tr><td>6.</td><td>columna "Nombre"</td><td valign="top">Nombre del Rol en Sherpa AI Server.</td></tr><tr><td>7.</td><td>columna "Descripción"</td><td valign="top">Descripción del Rol, que contiene información sobre el propósito del Rol.</td></tr><tr><td>8.</td><td>columna "Acceso"</td><td valign="top">Lista de derechos de acceso del Rol con indicación de permisos (Creación/Lectura/Actualización/Eliminación) para las siguientes herramientas: Licencias, Cuentas, Roles, Usuarios, API, Auditoría, Carpetas de objetos, Documentos, Historial de chats, Chat GPT, Asistentes, Modelos, Moderación.</td></tr></tbody></table>

## Crear rol

Para crear un nuevo Rol, es necesario hacer clic en el botón "Crear" en la tabla "Roles" y completar el formulario que aparece en la ventana emergente "Rol".

Los campos y casillas para completar en la ventana emergente "Rol":

1. La pestaña "Principales" incluye los campos:

* Nombre\* – campo obligatorio para ingresar el nombre del rol;
* Descripción – campo para ingresar la descripción del rol.

2. La pestaña "Acceso" incluye casillas de verificación:

* Licencias:
  * Creación – permite la creación de nuevas licencias;
  * Lectura – permite ver la lista de licencias y sus propiedades;
  * Actualización – permite editar licencias existentes;
  * Eliminación – permite eliminar licencias;
* Cuentas:
  * Creación – permite la creación de nuevas cuentas;
  * Lectura – permite ver la lista de cuentas y sus propiedades;
  * Actualización – permite editar cuentas existentes;
  * Eliminación – permite eliminar cuentas;
* Roles:
  * Creación – permite la creación de nuevos roles;
  * Lectura – permite ver la lista de roles y sus propiedades;
  * Actualización – permite editar roles existentes;
  * Eliminación – permite eliminar roles;
* Usuarios:
  * Creación – permite la creación de nuevos usuarios;
  * Lectura – permite ver la lista de usuarios y sus propiedades;
  * Actualización – permite editar usuarios existentes;
  * Eliminación – permite eliminar usuarios;
* API:
  * Creación – permite la creación de nuevas API;
  * Lectura – permite ver la lista de API;
  * Actualización – permite editar API existentes;
  * Eliminación – permite eliminar API;
* Auditoría:
  * Creación – permite la creación de registros de auditoría;
  * Lectura – permite ver el registro de auditoría;
  * Actualización – permite editar registros de auditoría;
  * Eliminación – permite eliminar registros de auditoría;
* Carpetas de objetos:
  * Creación – permite la creación de nuevas carpetas de acceso;
  * Lectura – permite ver la estructura y propiedades de las carpetas de acceso;
  * Actualización – permite editar propiedades de las carpetas de acceso;
  * Eliminación – permite eliminar carpetas de acceso;
* Documentos:
  * Creación – permite la creación de nuevos documentos;
  * Lectura – permite ver la lista de documentos y su contenido;
  * Actualización – permite editar documentos existentes;
  * Eliminación – permite eliminar documentos;
* Historial de chats:
  * Creación – permite la creación de registros del historial de chats;
  * Lectura – permite ver el historial de chats;
  * Actualización – permite editar registros del historial de chats;
  * Eliminación – permite eliminar registros del historial de chats;
* Chat GPT:
  * Creación – permite la creación de sesiones de chat GPT;
  * Lectura – permite ver el historial de chats GPT;
  * Actualización – permite editar la configuración del chat GPT;
  * Eliminación – permite eliminar sesiones de chat GPT;
* Asistentes:
  * Creación – permite la creación de nuevos asistentes;
  * Lectura – permite ver la lista de asistentes y sus propiedades;
  * Actualización – permite editar asistentes existentes;
  * Eliminación – permite eliminar asistentes;
* Modelos:
  * Creación – permite agregar nuevos modelos de IA;
  * Lectura – permite ver la lista de modelos de IA disponibles;
  * Actualización – permite editar la configuración de modelos de IA;
  * Eliminación – permite eliminar modelos de IA;
* Moderación:
  * Creación – permite la creación de reglas de moderación;
  * Lectura – permite ver la lista de reglas de moderación;
  * Actualización – permite editar reglas de moderación;
  * Eliminación – permite eliminar reglas de moderación.

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-89fc6091d9e46e3ae48c8cd2944862308bed5510%2F2026-03-24_16-43-13.png?alt=media" alt=""><figcaption></figcaption></figure>

3. La pestaña "Carpetas de objetos" incluye casillas de verificación que determinan carpetas de acceso específicas a las que se concede el rol. Las carpetas disponibles para seleccionar se muestran en forma de árbol jerárquico.\
   Estructura de las casillas de verificación:
   1. La casilla de verificación en la carpeta raíz otorga automáticamente acceso a todas las carpetas anidadas;
   2. La casilla de verificación en una carpeta anidada otorga acceso solo a esa carpeta.

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-3805a947f2cb906ea1cbbd69ef7b4e94a75b52fe%2F2026-03-24_17-34-58.png?alt=media" alt=""><figcaption></figcaption></figure>

## Editar rol

Para ver y editar un Rol, es necesario seleccionarlo en la lista y hacer clic en el ícono ![](https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-dc74b7a07745f14c6ce68ae542872c3b70988ebe%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20\(70\).png?alt=media). Después de esto, se abrirá el formulario de edición del Rol, donde se pueden realizar los cambios necesarios.

En la pestaña "Principales", además de los campos que se completan al crear el Rol, al editar se muestra el GUID (identificador único asignado al rol después de su creación). Este campo no se puede editar.

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-e6bbb95494fcf3a424952d0c1d2e058a53608ea1%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(492).png?alt=media" alt=""><figcaption></figcaption></figure>

En la pestaña "Acceso" se pueden marcar todos los objetos y operaciones permitidos para este Rol.

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-b838df360e885f18025a1b636a7ec7fcefc16289%2F2025-08-07_18-12-41%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

En la pestaña "Carpetas de objetos" se pueden marcar las carpetas de acceso a las que se permite el acceso para este Rol.

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-6affd6dcb612646e230d23a2d1c72176f518c4b7%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(521).png?alt=media" alt=""><figcaption></figcaption></figure>


---

# 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.sherparpa.ru/es/sherpa-ai/sherpa-ai-server/rabota-v-sherpa-ai-server/roli.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.