> ## 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.

# Perfil Master - Plataforma

> Gerencie a plataforma como um todo: empresas, permissões, anúncios e cache globais, migração de usuários e clonagem de agentes.

<Warning>
  **Acesso exclusivo do perfil Master.** Administradores comuns e usuários não visualizam estas funcionalidades.
</Warning>

## O que é

O perfil **Master** gerencia a **plataforma como um todo**, acima do nível de uma única empresa. Em relação a um administrador comum, o Master conta com quatro recursos adicionais:

1. **Seção Plataforma** no Painel Administrativo — cadastrar/configurar **Empresas**, definir **Permissões**, publicar **Anúncios globais** e gerenciar o **Cache global**.
2. **Trocar empresa** — escolher, pelo **menu lateral**, qual empresa ele está visualizando/operando no momento.
3. **Migrar usuário entre empresas** — na página de **Usuários**.
4. **Clonar agente entre empresas** — na página de **Agentes**.

## Como acessar

* **Plataforma:** menu do usuário → **Painel Admin** → seção **Plataforma** (visível apenas para o Master), com **Empresas**, **Permissões**, **Anúncios globais** e **Cache global**.
* **Trocar empresa:** no **menu lateral** (menu do usuário), opção **Trocar empresa**.
* **Migrar usuário** e **clonar agente** entre empresas: ações disponíveis dentro das próprias páginas de **Usuários** e **Agentes**.

## Trocar empresa (definir a empresa em foco)

Como o Master atua sobre várias empresas, ele precisa indicar **sobre qual empresa** quer trabalhar. Isso é feito pela opção **Trocar empresa** no **menu lateral** (clicando no seu nome/avatar).

<Steps>
  <Step title="Abra o menu do usuário e clique em Trocar empresa" />

  <Step title="Selecione a empresa desejada" />

  <Step title="Confirme a empresa em foco">
    A partir daí, o Symphony passa a refletir **a empresa em foco**. O nome da empresa selecionada aparece como referência no próprio menu.
  </Step>
</Steps>

<Warning>
  Sempre confira **qual empresa está em foco** antes de criar usuários ou alterar configurações, para não aplicar mudanças no tenant errado.
</Warning>

## Empresas — cadastro e gestão

O cadastro, a edição e a ativação/desativação de empresas ficam em **Plataforma → Empresas**. Cada empresa tem seu próprio **domínio de acesso**, limite de **licenças** e provedor de **autenticação (SSO)**. É a partir do cadastro de uma empresa que novos clientes passam a ter um endereço próprio e usuários no Symphony.

A página **Empresas** mostra a lista de empresas cadastradas, com um campo de **busca** (por nome ou domínio) e o botão **Nova empresa**.

### Criar uma empresa

<Steps>
  <Step title="Clique em Nova empresa" />

  <Step title="Preencha as abas Geral, Licença e SSO / AD">
    Veja os campos de cada aba abaixo.
  </Step>

  <Step title="Clique em Criar empresa" />
</Steps>

<Tabs>
  <Tab title="Geral">
    | Campo               | Obrigatório | Descrição                                                                                                                                            |
    | ------------------- | :---------: | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **Nome da empresa** |     Sim     | Nome de exibição da empresa. Deve ter entre **3 e 60 caracteres**.                                                                                   |
    | **Domínio**         |     Sim     | Identificador único de acesso. Aceita apenas **letras minúsculas, números e hífens**. Define o endereço de acesso: `symphony.fcamara.com/<domínio>`. |

    Abaixo do campo **Domínio**, a tela mostra uma prévia do endereço final que os usuários usarão para acessar a empresa.
  </Tab>

  <Tab title="Licença">
    | Campo                                | Descrição                                                                                                                         |
    | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------- |
    | **Máximo de licenças (usuários)**    | Número máximo de usuários ativos permitidos. **Deixe em branco para não aplicar limite** (empresa sem teto de usuários).          |
    | **Mensagem de limite personalizada** | Texto exibido aos usuários quando o limite de licenças é atingido. **Suporta formatação HTML** e mostra uma **pré‑visualização**. |
  </Tab>

  <Tab title="SSO / AD">
    Escolha o **provedor de autenticação** da empresa:

    * **Login padrão** — usuários entram com **e‑mail e senha** cadastrados; nenhum provedor externo é necessário.
    * **Microsoft AD** — exige: **Directory (Tenant) ID**, **Application (Client) ID**, **Client secret** e **Redirect URI**.
    * **Google Workspace** — exige: **Client ID**, **Client secret**, **Hosted domain (hd)** (restringe o login ao domínio informado) e **Redirect URI**.

    <Note>
      Os dados de SSO (IDs, segredos e URIs) são obtidos no portal do respectivo provedor (Azure Portal ou Google Cloud Console). A própria tela traz dicas de onde encontrar cada valor.
    </Note>
  </Tab>
</Tabs>

### Editar uma empresa

Na lista, use a ação de **editar** na empresa desejada. A mesma janela (Geral, Licença, SSO / AD) é aberta com os dados atuais. Ao concluir, clique em **Salvar alterações**.

### Ativar / Desativar uma empresa

Cada empresa pode ser **ativada** ou **desativada** pela lista. Ao desativar, é exibida uma confirmação:

* **Desativar:** todos os usuários da empresa **perdem o acesso imediatamente**. A ação é **reversível** — basta reativar a empresa depois.
* **Ativar:** os usuários **recuperam o acesso imediatamente**.

<Warning>
  **Sempre deve existir pelo menos uma empresa ativa.** Ao tentar desativar a última empresa ativa, o sistema bloqueia a ação com um aviso.
</Warning>

## Permissões

A página **Permissões** define, **por empresa**, o que cada **perfil** (Administrador e Usuário) pode fazer. As permissões são organizadas em três grandes grupos (com interruptores para cada item):

* **Chat** — envio de arquivos, edição/exclusão de mensagens, voz (STT/TTS), múltiplos modelos, interpretar código, busca na web, geração de imagem, conversas arquivadas, anexar conhecimento/prompt/ferramenta, chat temporário etc.
* **Workspace** — acesso a Agentes, Conhecimento, Prompts e Ferramentas.
* **Painel administrativo** — acesso às seções de gestão e configurações.

<Note>
  São essas permissões que determinam **quais recursos e telas** cada usuário enxerga no Symphony.
</Note>

## Anúncios globais

Permite publicar **avisos/banners** que aparecem para os usuários **de todas as empresas, independentemente do tenant** (por exemplo, comunicados de manutenção ou novidades da plataforma). É o que diferencia o anúncio **global** dos banners de uma empresa específica: o global alcança todos os usuários da plataforma de uma só vez.

Cada anúncio permite definir **tipo**, **período de exibição** e a **possibilidade de dispensa** pelo usuário.

## Cache global

Ferramenta de gestão do **cache** da plataforma, usada para manutenção e atualização de dados em escala global.

## Migrar usuário entre empresas

Na página **Usuários** (Painel Admin → Gestão → Usuários), o Master pode **mover um usuário de uma empresa para outra**. A ação fica disponível na linha do usuário (ícone de migração) e só aparece quando **existe outra empresa ativa** para a qual migrar.

<Steps>
  <Step title="Localize o usuário na lista" />

  <Step title="Clique na ação de migrar para empresa" />

  <Step title="Escolha a empresa de destino e confirme" />
</Steps>

## Clonar agente entre empresas

Na página **Agentes** (menu lateral → Agentes), o Master pode **clonar um agente para outra empresa**, reaproveitando uma configuração já pronta em outro tenant. A opção **Clonar para empresa** fica no menu de ações do agente e só aparece para o Master quando **há outra empresa ativa** como destino.

<Steps>
  <Step title="No menu de ações do agente, escolha Clonar para empresa" />

  <Step title="Selecione a empresa de destino e confirme" />

  <Step title="Uma cópia do agente é criada na empresa escolhida" />
</Steps>

## Boas práticas

* Escolha um **domínio** curto, claro e estável — ele faz parte do endereço de acesso e não deve mudar com frequência.
* Defina o **máximo de licenças** de acordo com o contrato/plano da empresa; deixe em branco apenas se a empresa puder ficar **sem limite** de usuários.
* Configure o **SSO** sempre que a empresa usar Microsoft ou Google — melhora a segurança e a experiência de login.
* Antes de **desativar** uma empresa, comunique os usuários, pois o acesso é cortado imediatamente.
* Ajuste as **permissões** com cuidado: elas afetam diretamente a experiência de todos os usuários da empresa.
* Use **anúncios globais** para comunicar manutenções e novidades com antecedência.
* Antes de criar usuários ou alterar configurações, **confira a empresa em foco** (opção **Trocar empresa**) para não agir no tenant errado.

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Qual a diferença entre Master e Administrador?">
    O **Administrador** gerencia **uma** empresa. O **Master** gerencia a **plataforma** e **todas** as empresas, incluindo o cadastro de empresas, permissões e recursos globais.
  </Accordion>

  <Accordion title="O domínio aceita maiúsculas ou espaços?">
    Não. Apenas **letras minúsculas, números e hífens**.
  </Accordion>

  <Accordion title="Posso deixar o limite de licenças em branco?">
    Sim. Em branco, a empresa fica **sem limite** de usuários.
  </Accordion>

  <Accordion title="Desativar uma empresa apaga os dados?">
    Não. A desativação apenas **bloqueia o acesso** dos usuários e é **reversível** pela reativação.
  </Accordion>

  <Accordion title="Onde os usuários acessam a empresa criada?">
    No endereço `symphony.fcamara.com/<domínio>` (a prévia aparece ao digitar o domínio).
  </Accordion>

  <Accordion title="Configurei o SSO mas o login não funciona.">
    Revise os dados (IDs, segredo e Redirect URI) no portal do provedor (Azure/Google) e confirme se a **URI de redirecionamento** cadastrada lá é idêntica à informada aqui.
  </Accordion>

  <Accordion title="Alterei uma permissão e o usuário ainda não vê a mudança.">
    As permissões valem por empresa e perfil; peça ao usuário para recarregar a sessão (Ctrl/⌘ + Shift + R). Confirme também se o recurso depende de configuração técnica adicional (ex.: provedor de imagem/áudio).
  </Accordion>
</AccordionGroup>

## Limitações conhecidas

* Todas as funcionalidades desta seção são **exclusivas do perfil Master**.
* O **nome** da empresa deve ter entre 3 e 60 caracteres; o **domínio** aceita apenas minúsculas, números e hífens.
* **Pelo menos uma empresa** precisa permanecer ativa — não é possível desativar todas.
* O funcionamento do **SSO** depende de credenciais válidas configuradas no provedor externo (Microsoft/Google).
* Mudanças de **permissões** impactam imediatamente o que os usuários daquela empresa podem acessar.