> ## Documentation Index
> Fetch the complete documentation index at: https://symphony-docs.fcamara.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Painel Administrativo

> Gerencie usuários, grupos e configurações da sua empresa no Symphony.

<Warning>
  **Acesso restrito.** Este painel é destinado a usuários com perfil **Administrador** (ou **Master**). Usuários comuns não o visualizam.
</Warning>

## O que é

O **Painel Administrativo** permite gerenciar a sua empresa dentro do Symphony: **usuários**, **grupos** e diversas **configurações** (modelos de IA, conexões, documentos, busca na web, áudio, imagem, interface etc.).

## Como acessar

<Steps>
  <Step title="Abra o menu do usuário">
    Clique no seu **nome/avatar** na barra lateral.
  </Step>

  <Step title="Selecione Painel Admin" />
</Steps>

O painel exibe um menu lateral organizado em seções. Os itens visíveis dependem das permissões da empresa:

* **Plataforma** *(apenas Master)* — Empresas, Permissões, Anúncios globais, Cache global.
* **Gestão** — **Usuários** e **Grupos de usuários**.
* **Configurações** — **Geral**, **Conexão**, **Modelos**, **Documentos**, **Busca na web**, **Execução de código**, **Interface**, **Áudio**, **Imagem**, **Pipelines**.

## Gestão de usuários

A página **Usuários** lista as contas da empresa, com colunas como **nome**, **centro de custo/BU**, **tipo de acesso**, **última atividade**, **data de criação** e **ocupação**. A partir dela você pode:

| Ação                  | Descrição                                                  |
| --------------------- | ---------------------------------------------------------- |
| **Adicionar usuário** | Cria uma nova conta.                                       |
| **Editar**            | Altera dados do usuário (ícone de lápis).                  |
| **Ativar/Desativar**  | Liga/desliga o acesso da conta (interruptor).              |
| **Excluir**           | Remove a conta (ícone de lixeira).                         |
| **Ver conversas**     | Abre o histórico de conversas do usuário (ícone de balão). |
| **Tipo de acesso**    | Define/ajusta o nível de acesso do usuário.                |
| **Migrar de empresa** | *(Master)* Move o usuário para outra empresa.              |

### Criar/editar usuário — campos principais

* **Nome completo**
* **E‑mail**
* **Perfil (role)** — Usuário, Administrador ou Master
* **Senha** e **Confirmação** — há um botão para **gerar senha forte** automaticamente e copiá‑la
* **Unidade de negócio (BU)** e **Ocupação**
* **Empresa** *(quando Master)*

<Note>
  O painel também acompanha informações de **licenças** (quantidade de contas permitidas pelo plano).
</Note>

## Grupos de usuários

A página **Grupos de usuários** permite **criar, editar e excluir grupos**. Grupos facilitam o **compartilhamento** de agentes, prompts, conhecimento e ferramentas (você compartilha com um grupo em vez de pessoa por pessoa) e a aplicação de **permissões** de forma coletiva. Alguns grupos podem representar **Unidades de Negócio (BU)**.

## Configurações da empresa

A seção **Configurações** concentra os ajustes técnicos da plataforma para a empresa:

| Seção                  | O que configura                                                                                         |
| ---------------------- | ------------------------------------------------------------------------------------------------------- |
| **Geral**              | Preferências gerais da instância.                                                                       |
| **Conexão**            | Conexões com provedores de modelos (ex.: OpenAI, Ollama) e endpoints.                                   |
| **Modelos**            | Habilita, oculta e configura os **modelos de IA** disponíveis para os usuários.                         |
| **Documentos**         | Parâmetros de processamento de arquivos das bases de conhecimento (tipos, limites, extração/indexação). |
| **Busca na web**       | Provedores e parâmetros da pesquisa na internet.                                                        |
| **Execução de código** | Configuração do interpretador de código.                                                                |
| **Interface**          | Ajustes da aparência/comportamento da interface.                                                        |
| **Áudio**              | Provedores de **fala‑para‑texto (STT)** e **texto‑para‑fala (TTS)**.                                    |
| **Imagem**             | Provedores e parâmetros de **geração de imagens**.                                                      |
| **Pipelines**          | Fluxos/integrações avançadas.                                                                           |

<Tip>
  Os recursos que aparecem **para os usuários** no chat (busca na web, gerar imagem, interpretar código, voz etc.) dependem tanto de estarem **configurados aqui** quanto de estarem **liberados nas permissões**.
</Tip>

## Boas práticas

* Conceda o perfil **Administrador** apenas a quem realmente precisa.
* Use **grupos** para organizar permissões e compartilhamentos — é mais simples de manter do que ajustes individuais.
* Ao **desativar** um usuário que saiu, em vez de excluir, você preserva o histórico.
* Configure **modelos** e **provedores** antes de liberar recursos aos usuários, para evitar erros no chat.
* Use o **gerador de senha** ao criar contas e oriente o usuário a trocá‑la no primeiro acesso.

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Por que não vejo a seção &#x22;Plataforma&#x22;?">
    Ela é exclusiva do perfil **Master**. Veja [Perfil Master](/admin/perfil-master).
  </Accordion>

  <Accordion title="Adicionei um usuário, mas não consigo (limite atingido).">
    O número de contas é limitado pelo **plano** da empresa. Verifique as informações de licença ou contate o responsável pela plataforma.
  </Accordion>

  <Accordion title="Habilitei a busca na web, mas o usuário não vê o recurso.">
    Confirme se a **permissão** correspondente está ativada para o perfil/empresa (em **Permissões**, no perfil Master) além da configuração técnica.
  </Accordion>
</AccordionGroup>

## Limitações conhecidas

* A visibilidade das seções/itens depende das **permissões de painel administrativo** definidas para a empresa.
* A seção **Plataforma** e ações como **migrar usuário entre empresas** são exclusivas do perfil **Master**.
* A criação de usuários respeita o limite de **licenças** do plano.
* Várias configurações técnicas (modelos, provedores, pipelines) exigem conhecimento de integração e credenciais válidas dos provedores.