Skip to main content
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.

​
Pré-requisitos

  • Possuir acesso master ao Symphony.

​
Passo 1 — Acessar o Painel Administrativo

1

Localize seu nome

No menu lateral esquerdo, na parte inferior da tela.
2

Clique sobre o seu nome

3

Selecione Painel Admin

​
Passo 2 — Criar a empresa

1

Acesse Plataforma → Empresas

2

Clique em Nova empresa

3

Preencha os campos obrigatórios

​
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.
Erros na configuração de SSO podem impedir o acesso dos usuários ao ambiente.

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

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

Clique sobre o seu nome no menu lateral

2

Selecione a empresa recém-criada (Trocar empresa)

3

Acesse Painel Admin → Plataforma → Permissões

​
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
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.
Em Admin → Painel Admin: limite as seções visíveis/ativas apenas para:
  • Usuários
  • Grupos de usuários
  • Modelos
  • Configurações Gerais
  • Interface
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.

​
Passo 4 — Estrutura de grupos de usuário

1

Acesse Gerenciamento → Grupos de usuários

2

Crie os grupos necessários conforme a estrutura da empresa

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.

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

1

Acesse Conexão no Painel Admin

2

Configure as URLs das conexões conforme os provedores usados pela empresa

3

Adicione as chaves de API e os modelos necessários

4

Valide o funcionamento após inserir cada chave

Exemplos de conexões:
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.

​
Passo 6 — Configuração dos modelos base

1

Acesse a área de Modelos no Painel Admin

2

Configure cada modelo

  • Adicione uma descrição clara (consulte o Comparativo de Modelos LLMs).
  • Configure os parâmetros necessários, se aplicável.
  • Compartilhe o modelo com os grupos correspondentes.

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

1

Acesse a página de Documentos no Painel Admin

2

Defina o modelo de embedding (vetorização dos documentos)

Impacto desta configuração:
  • Afeta diretamente a qualidade das buscas internas.
  • Influencia o desempenho de agentes baseados em documentos.
Se você atualizar ou alterar o modelo de embedding, será necessário reimportar todos os documentos.

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

1

Acesse Busca na web no Painel Admin

2

Defina o modelo/motor responsável pela pesquisa

Ex.: Google PSE, com chave de API e ID do motor.
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

1

Acesse Execução de código no Painel Admin

2

Defina o motor responsável pela execução de código

Ex.: pyodide.

​
Passo 10 — Configuração de áudio

1

Acesse a página de Áudio no Painel Admin

2

Defina os modelos/motores de STT (fala-texto) e TTS (texto-fala)

Conforme a necessidade da empresa.

​
Passo 11 — Configuração de imagens

1

Acesse a página de Imagem no Painel Admin

2

Defina o motor de geração de imagens e os recursos visuais disponíveis

Para os usuários, quando aplicável.

​
Passo 12 — Configuração de agentes

Esta é uma etapa estratégica e deve ser realizada em conjunto com o cliente.

​
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?
Consulte o catálogo completo na Galeria de Agentes para apoiar o levantamento com o cliente e escolher os agentes por área.

​
Configuração dos agentes

1

Clone os agentes existentes do Symphony da FC

Veja Clonar agente entre empresas.
2

Ajuste cada agente

  • Prompt
  • Permissões
  • Contextos
  • Grupos com acesso
  • Ferramentas habilitadas, se aplicável.
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.

​
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