# Funções

A aba "Funções" é destinada à configuração dos direitos de acesso dos usuários às ferramentas do Sherpa AI Server. O número de funções que podem ser criadas não é limitado.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%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>№ p/p</strong></td><td><strong>Elemento da interface</strong></td><td valign="top"><strong>Descrição</strong></td></tr><tr><td>1.</td><td>botão "Criar"</td><td valign="top">Permite criar novas Funções.</td></tr><tr><td>2.</td><td>botão "Atualizar"</td><td valign="top">Permite atualizar forçadamente a tabela "Funções".</td></tr><tr><td>3.</td><td>botão "Excluir selecionado"</td><td valign="top">Permite excluir as Funções selecionadas do Sherpa AI Server. Também é possível excluir Funções individuais clicando no botão na linha desejada da tabela "Funções". Ao excluir Funções, uma janela de confirmação de exclusão aparece.</td></tr><tr><td>4.</td><td>botão "Exportar para CSV"</td><td valign="top">Gera um arquivo de dados das Funções no formato CSV (Comma-Separated Values) para importação em planilhas e sistemas de contabilidade.</td></tr><tr><td>5.</td><td>botão "Exportar para XLSX"</td><td valign="top">Gera um arquivo de dados das Funções no formato Microsoft Excel (XLSX) para importação em planilhas e sistemas de contabilidade.</td></tr><tr><td>6.</td><td>coluna "Nome"</td><td valign="top">Nome da Função no Sherpa AI Server.</td></tr><tr><td>7.</td><td>coluna "Descrição"</td><td valign="top">Descrição da Função, contendo informações sobre a finalidade da Função.</td></tr><tr><td>8.</td><td>coluna "Acesso"</td><td valign="top">Lista de direitos de acesso da Função com a indicação de permissões (Criação/Leitura/Atualização/Exclusão) para as seguintes ferramentas: Licenças, Contas, Funções, Usuários, API, Auditoria, Pastas de objetos, Documentos, Histórico de chats, Chat GPT, Assistentes, Modelos, Moderação.</td></tr></tbody></table>

## Criar função

Para criar uma nova Função, é necessário clicar no botão "Criar" na tabela "Funções" e preencher o formulário que aparece na janela pop-up "Função".

Os campos e caixas de seleção para preenchimento na janela pop-up "Função":

1. A aba "Principais" inclui os campos:

* Nome\* – campo obrigatório para inserir o nome da função;
* Descrição – campo para inserir a descrição da função.

2. A aba "Acesso" inclui caixas de seleção:

* Licenças:
  * Criação – permite a criação de novas licenças;
  * Leitura – permite visualizar a lista de licenças e suas propriedades;
  * Atualização – permite editar licenças existentes;
  * Exclusão – permite excluir licenças;
* Contas:
  * Criação – permite a criação de novas contas;
  * Leitura – permite visualizar a lista de contas e suas propriedades;
  * Atualização – permite editar contas existentes;
  * Exclusão – permite excluir contas;
* Funções:
  * Criação – permite a criação de novas funções;
  * Leitura – permite visualizar a lista de funções e suas propriedades;
  * Atualização – permite editar funções existentes;
  * Exclusão – permite excluir funções;
* Usuários:
  * Criação – permite a criação de novos usuários;
  * Leitura – permite visualizar a lista de usuários e suas propriedades;
  * Atualização – permite editar usuários existentes;
  * Exclusão – permite excluir usuários;
* API:
  * Criação – permite a criação de novas APIs;
  * Leitura – permite visualizar a lista de APIs;
  * Atualização – permite editar APIs existentes;
  * Exclusão – permite excluir APIs;
* Auditoria:
  * Criação – permite a criação de registros de auditoria;
  * Leitura – permite visualizar o log de auditoria;
  * Atualização – permite editar registros de auditoria;
  * Exclusão – permite excluir registros de auditoria;
* Pastas de objetos:
  * Criação – permite a criação de novas pastas de acesso;
  * Leitura – permite visualizar a estrutura e propriedades das pastas de acesso;
  * Atualização – permite editar as propriedades das pastas de acesso;
  * Exclusão – permite excluir pastas de acesso;
* Documentos:
  * Criação – permite a criação de novos documentos;
  * Leitura – permite visualizar a lista de documentos e seu conteúdo;
  * Atualização – permite editar documentos existentes;
  * Exclusão – permite excluir documentos;
* Histórico de chats:
  * Criação – permite a criação de registros do histórico de chats;
  * Leitura – permite visualizar o histórico de chats;
  * Atualização – permite editar registros do histórico de chats;
  * Exclusão – permite excluir registros do histórico de chats;
* Chat GPT:
  * Criação – permite a criação de sessões de chat GPT;
  * Leitura – permite visualizar o histórico de chats GPT;
  * Atualização – permite editar as configurações do chat GPT;
  * Exclusão – permite excluir sessões de chat GPT;
* Assistentes:
  * Criação – permite a criação de novos assistentes;
  * Leitura – permite visualizar a lista de assistentes e suas propriedades;
  * Atualização – permite editar assistentes existentes;
  * Exclusão – permite excluir assistentes;
* Modelos:
  * Criação – permite adicionar novos modelos de IA;
  * Leitura – permite visualizar a lista de modelos de IA disponíveis;
  * Atualização – permite editar as configurações dos modelos de IA;
  * Exclusão – permite excluir modelos de IA;
* Moderação:
  * Criação – permite a criação de regras de moderação;
  * Leitura – permite visualizar a lista de regras de moderação;
  * Atualização – permite editar regras de moderação;
  * Exclusão – permite excluir regras de moderação.

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

3. A aba "Pastas de objetos" inclui caixas de seleção que determinam pastas de acesso específicas às quais a função tem acesso. As pastas disponíveis para seleção são exibidas em forma de árvore hierárquica.\
   Estrutura das caixas de seleção:
   1. A caixa de seleção na pasta raiz concede automaticamente acesso a todas as pastas filhas;
   2. A caixa de seleção na pasta filha concede acesso apenas a essa pasta.

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

## Editar função

Para visualizar e editar uma Função, é necessário selecioná-la na lista e clicar no ícone ![](https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%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). Após isso, o formulário de edição da Função será aberto, onde é possível fazer as alterações necessárias.

Na aba "Principais", além dos campos preenchidos ao criar a Função, ao editar, é exibido o GUID (identificador único atribuído à função após sua criação). Este campo não pode ser editado.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%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>

Na aba "Acesso", é possível marcar todos os objetos e operações permitidos para esta Função.

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

Na aba "Pastas de objetos", é possível marcar as pastas de acesso às quais o acesso é permitido para esta Função.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%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/pt/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.