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

# Manual SaaS - Cadastro de novo cliente

> Playbook completo para provisionar uma nova empresa (tenant) no Symphony de ponta a ponta.

<Warning>
  **Acesso exclusivo do perfil Master.** Este é um guia operacional para **provisionar uma nova empresa (tenant)** no Symphony de ponta a ponta: criação, permissões, grupos, conexões, modelos, documentos, recursos e agentes.
</Warning>

## Pré-requisitos

* Possuir **acesso master** ao Symphony.

## Passo 1 — Acessar o Painel Administrativo

<Steps>
  <Step title="Localize seu nome">
    No menu lateral esquerdo, na parte inferior da tela.
  </Step>

  <Step title="Clique sobre o seu nome" />

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

## Passo 2 — Criar a empresa

<Steps>
  <Step title="Acesse Plataforma → Empresas" />

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

  <Step title="Preencha os campos obrigatórios">
    | # | Campo                      | Orientação                                                           |
    | - | -------------------------- | -------------------------------------------------------------------- |
    | 1 | **Nome da empresa**        | Use o nome **oficial** da empresa. Evite abreviações desnecessárias. |
    | 2 | **Quantidade de licenças** | Defina conforme o **contrato** firmado com o cliente.                |
    | 3 | **Domínio**                | Use o padrão `/nomedaempresa`.                                       |
  </Step>
</Steps>

### Configuração de SSO

Caso a empresa utilize autenticação corporativa, configure o **SSO — Single Sign-On**. Valide:

* **URLs** de login/logout;
* **Certificados** (se necessário);
* **Parâmetros** exigidos pelo provedor de identidade.

<Warning>
  Erros na configuração de SSO podem **impedir o acesso** dos usuários ao ambiente.
</Warning>

## Passo 3 — Permissões (ajustes avançados)

Após criar a empresa, é necessário **trocar para a visão da empresa criada**:

<Steps>
  <Step title="Clique sobre o seu nome no menu lateral" />

  <Step title="Selecione a empresa recém-criada (Trocar empresa)" />

  <Step title="Acesse Painel Admin → Plataforma → Permissões" />
</Steps>

### Configuração padrão recomendada

**Em Admin e Usuário → Chat:** mantenha **desativadas apenas** estas opções:

* **Servidores de ferramentas diretos**
* **Forçar chat temporário**

<Note>
  As demais opções de Chat (upload de arquivo, excluir/editar mensagens, controles, STT, TTS, chamada de voz, múltiplos modelos, interpretador de código, busca na web, geração de imagem, chats arquivados, anexar conhecimento/prompt/ferramentas, chat temporário) permanecem **ativadas**.
</Note>

**Em Admin → Painel Admin:** limite as seções **visíveis/ativas** apenas para:

* **Usuários**
* **Grupos de usuários**
* **Modelos**
* **Configurações Gerais**
* **Interface**

<Tip>
  **Quando alterar as permissões?** Apenas se a empresa **solicitar acessos específicos** ou se houver necessidade de **restringir** funcionalidades. Na maioria dos casos, a **configuração padrão** já atende à operação inicial da empresa.
</Tip>

## Passo 4 — Estrutura de grupos de usuário

<Steps>
  <Step title="Acesse Gerenciamento → Grupos de usuários" />

  <Step title="Crie os grupos necessários conforme a estrutura da empresa" />
</Steps>

<Warning>
  Ao criar ou editar um grupo, marque a opção **BU — Unidade de Negócio**. Isso permite que o grupo:

  * apareça no **cadastro do usuário**;
  * possa ser **selecionado** ao criar/editar usuários;
  * seja usado para **segmentação** de acessos e permissões.
</Warning>

## Passo 5 — Configuração de conexões (APIs)

<Steps>
  <Step title="Acesse Conexão no Painel Admin" />

  <Step title="Configure as URLs das conexões conforme os provedores usados pela empresa" />

  <Step title="Adicione as chaves de API e os modelos necessários" />

  <Step title="Valide o funcionamento após inserir cada chave" />
</Steps>

**Exemplos de conexões:**

| # | Provedor      | URL base                                                  |
| - | ------------- | --------------------------------------------------------- |
| 1 | Google Gemini | `https://generativelanguage.googleapis.com/v1beta/openai` |
| 2 | Anthropic     | `https://api.anthropic.com/v1`                            |
| 3 | OpenAI        | `https://api.openai.com/v1`                               |
| 4 | Perplexity    | `https://api.perplexity.ai`                               |
| 5 | Azure OpenAI  | `https://<nome-do-recurso>.openai.azure.com/openai/v1`    |

<Warning>
  **Boas práticas:**

  * Nunca compartilhe chaves de API em ambientes públicos.
  * Valide se a chave possui as **permissões corretas**.
  * **Teste** a conexão após a configuração.
  * Registre internamente quais chaves foram usadas e para qual finalidade.
</Warning>

## Passo 6 — Configuração dos modelos base

<Steps>
  <Step title="Acesse a área de Modelos no Painel Admin" />

  <Step title="Configure cada modelo">
    * Adicione uma **descrição clara** (consulte o [Comparativo de Modelos LLMs](https://camara1.sharepoint.com/:x:/r/sites/nucleo.ia.dev/Documentos%20Compartilhados/Documentos/Comparativo%20de%20Modelos%20LLMs.xlsx?d=w3592eb1560a24a08a15aa169c603e1ae\&csf=1\&web=1\&e=GrCHe5)).
    * Configure os **parâmetros** necessários, se aplicável.
    * **Compartilhe** o modelo com os **grupos** correspondentes.
  </Step>
</Steps>

## Passo 7 — Configuração de documentos (Embedding)

<Steps>
  <Step title="Acesse a página de Documentos no Painel Admin" />

  <Step title="Defina o modelo de embedding (vetorização dos documentos)" />
</Steps>

**Impacto desta configuração:**

* Afeta diretamente a **qualidade das buscas internas**.
* Influencia o **desempenho de agentes** baseados em documentos.

<Warning>
  Se você atualizar ou alterar o modelo de embedding, será necessário **reimportar todos os documentos**.
</Warning>

## Passo 8 — Configuração de busca na web

<Steps>
  <Step title="Acesse Busca na web no Painel Admin" />

  <Step title="Defina o modelo/motor responsável pela pesquisa">
    Ex.: Google PSE, com chave de API e ID do motor.
  </Step>
</Steps>

**Uso esperado** — a busca web é utilizada para consultas externas, atualização de informações e enriquecimento de respostas com dados recentes.

## Passo 9 — Configuração de execução de código

<Steps>
  <Step title="Acesse Execução de código no Painel Admin" />

  <Step title="Defina o motor responsável pela execução de código">
    Ex.: `pyodide`.
  </Step>
</Steps>

## Passo 10 — Configuração de áudio

<Steps>
  <Step title="Acesse a página de Áudio no Painel Admin" />

  <Step title="Defina os modelos/motores de STT (fala-texto) e TTS (texto-fala)">
    Conforme a necessidade da empresa.
  </Step>
</Steps>

## Passo 11 — Configuração de imagens

<Steps>
  <Step title="Acesse a página de Imagem no Painel Admin" />

  <Step title="Defina o motor de geração de imagens e os recursos visuais disponíveis">
    Para os usuários, quando aplicável.
  </Step>
</Steps>

## Passo 12 — Configuração de agentes

<Info>
  Esta é uma etapa **estratégica** e deve ser realizada **em conjunto com o cliente**.
</Info>

### Levantamento com a empresa

Antes de configurar, entenda:

* Quais **agentes** serão utilizados?
* Qual o **objetivo** de cada agente?
* Quais **áreas** utilizarão os agentes?

<Tip>
  Consulte o catálogo completo na [Galeria de Agentes](https://symphony.fcamara.com/agents-gallery) para apoiar o levantamento com o cliente e escolher os agentes por área.
</Tip>

### Configuração dos agentes

<Steps>
  <Step title="Clone os agentes existentes do Symphony da FC">
    Veja [Clonar agente entre empresas](/admin/perfil-master#clonar-agente-entre-empresas).
  </Step>

  <Step title="Ajuste cada agente">
    * **Prompt**
    * **Permissões**
    * **Contextos**
    * **Grupos com acesso**
    * **Ferramentas** habilitadas, se aplicável.
  </Step>
</Steps>

<Note>
  **Agentes de Acesso Rápido (funcionalidade futura).** Quando disponível, permitirá configurar como **acesso rápido** os agentes mais usados pela empresa. Este recurso ainda **não está implementado**.
</Note>

## Checklist final

Antes de finalizar o cadastro da empresa, valide:

* [ ] Empresa criada corretamente
* [ ] Domínio configurado
* [ ] Quantidade de licenças conforme contrato
* [ ] SSO configurado e funcional, quando aplicável
* [ ] Grupo default criado
* [ ] Grupos de BU configurados
* [ ] APIs inseridas e funcionando
* [ ] Modelos base configurados e compartilhados com o grupo default
* [ ] Modelo de embedding definido
* [ ] Busca web configurada
* [ ] Execução de código configurada
* [ ] Geração de imagem configurada
* [ ] Agentes criados e testados
* [ ] Validação final realizada com o cliente ou responsável interno