Skip to main content
Este guia mostra, tela a tela, como ativar o login único (SSO) da sua empresa e cadastrar os modelos de IA no console da Strattum. Com ele, a pessoa responsável pela infraestrutura conclui a configuração sozinha, sem depender de uma chamada com a nossa equipe.

​
O que você vai fazer

São duas partes, nesta ordem. A Parte 1 começa com o login inicial. A Parte 2 pode ser feita por qualquer administrador, inclusive a pessoa que você convidar na Parte 1.

Parte 1 · Acesso e login único (SSO)

1.1 Fazer o primeiro login com o administrador inicial
1.2 Configurar o SSO e o auto-cadastro
1.3 Convidar o administrador da plataforma

Parte 2 · Modelos de IA

2.1 Cadastrar a chave do provedor de IA
2.2 Escolher o modelo de cada função interna
2.3 Montar o catálogo do Strattum Chat (opcional)
2.4 Salvar a configuração
Segurança. A senha inicial, o Client Secret e as chaves de API são digitados por você, direto no console. Esses valores ficam no ambiente da sua empresa e a equipe da Strattum não precisa deles. Não envie nenhum deles por e-mail, chat ou chamado.

​
Antes de começar

Separe estes itens antes do primeiro login. A última coluna indica o passo em que cada um é usado.

​
Onde ficam as telas

Todas as telas deste guia ficam em Configurações, no endereço /settings da sua instância. No menu lateral das Configurações, você vai usar três itens:
  • ① Login único (SSO), na seção Instalação. Usado no passo 1.2.
  • ② Usuários, na seção Workspace. Usado nos passos 1.2 e 1.3.
  • ③ Modelos de IA, na seção Instalação. Usado em toda a Parte 2.
Menu lateral das Configurações com os itens Usuários, Modelos de IA e Login único (SSO) destacados

Figura 1. Menu de Configurações com os itens usados neste guia.

​
Parte 1 · Acesso e login único (SSO)

Você entra com o administrador inicial, conecta o provedor de identidade da sua empresa e convida quem vai administrar a plataforma.

​
1.1 Faça o primeiro login com o administrador inicial

Onde: Tela de login da sua instância Use este acesso só no primeiro login. Ele existe para você configurar o SSO e convidar o administrador da sua empresa. Exemplo: se você acessa a plataforma em empresa.strattum.ai, o login é zitadel-admin@strattum.auth.empresa.strattum.ai.
Se a tela pedir uma nova senha nesse primeiro acesso, crie uma senha forte e guarde no cofre de senhas da sua empresa.

​
1.2 Configure o login único (SSO)

Onde: Configurações › Instalação › Login único (SSO) Tenha em mãos o aplicativo de SSO criado no seu provedor de identidade.
  1. Selecione o provedor de identidade da sua empresa.
  2. Preencha o ID do cliente (Client ID) e o segredo (Client Secret) do aplicativo criado no provedor.
  3. Copie a URL de callback mostrada na tela e cadastre essa URL no aplicativo do provedor, no campo de URLs de redirecionamento (redirect URIs).
  4. Valide a configuração na própria tela.
A URL de callback precisa ser idêntica no console e no provedor. Um caractere diferente, como uma barra a mais no fim, faz o login pelo SSO falhar.

​
Auto-cadastro via SSO (opcional)

Com o SSO validado, abra Configurações › Workspace › Usuários e decida a posição da chave Permitir auto-cadastro via SSO ①. Se você prefere liberar cada acesso por convite, deixe a chave desligada.
Página Meus Usuários com a chave Permitir auto-cadastro via SSO e o botão Convidar Usuário destacados

Figura 2. Página Usuários: chave Permitir auto-cadastro via SSO ① e botão Convidar Usuário ②.

​
1.3 Convide o administrador da plataforma

Onde: Configurações › Workspace › Usuários
  1. Clique em Convidar Usuário ②, no canto superior direito da página (Figura 2).
  2. Na janela Adicionar Usuário, preencha os campos (Figura 3):
  3. Clique em Adicionar ②.
Janela Adicionar Usuário com os campos Nome, E-mail e Função, e o botão Adicionar

Figura 3. Janela Adicionar Usuário: campo Função com Administrador selecionado ① e botão Adicionar ②.

Parte 1 concluída. O SSO está ativo e o administrador da sua empresa já tem a função atribuída. A partir de agora, essa pessoa entra pelo SSO, e o login inicial do passo 1.1 deixa de ser usado no dia a dia.

​
Parte 2 · Modelos de IA

A plataforma usa os modelos de IA do provedor que a sua empresa escolher. As chaves são da sua empresa, e o consumo é faturado direto na sua conta com o provedor. Onde: Configurações › Instalação › Modelos de IA

​
2.1 Cadastre a chave do provedor de IA

  1. Em Provedores, localize o provedor da sua chave. Se ele não estiver na lista, clique em Adicionar outro provedor ① e escolha o provedor.
  2. Cole a chave no campo API Key ②.
  3. Clique em Testar credencial ③.
Para usar mais de um provedor, repita os passos para cada um. Você pode combinar provedores, por exemplo Anthropic para o chat e OpenAI para os embeddings.
Bloco Provedores com o provedor OpenAI, o campo API Key, o botão Testar credencial e o botão Adicionar outro provedor

Figura 4. Bloco Provedores: Adicionar outro provedor ①, campo API Key ② e Testar credencial ③.

Depois de salva, a chave não aparece mais na tela: o campo mostra Chave salva. Para trocar, digite a nova chave no mesmo campo. Até lá, a chave salva continua valendo.

​
2.2 Escolha o modelo de cada função interna

Em Modelos da plataforma, o console lista sete funções internas. Cada uma traz uma descrição e a linha Usado por, com os serviços que dependem dela.
  1. Escolha o modelo no seletor da função ①. O prefixo do nome indica o provedor e a chave usados: openai/gpt-4o-mini usa a chave da OpenAI.
  2. Clique em Validar com uma chamada mínima ②. Na função de embeddings, o botão se chama Validar embedding.
  3. Repita nas sete funções.
Bloco Modelos da plataforma com as funções Generativo e Extração de entidades, o seletor de modelo e o botão Validar com uma chamada mínima

Figura 5. Modelos da plataforma: seletor de modelo ① e validação ②.

​
Funções que pedem atenção

Escolha o modelo de embedding antes de indexar documentos no Knowledge. Cada troca posterior exige reindexar todo o conteúdo.
Função Embeddings Knowledge RAG com o seletor de modelo, o botão Validar embedding e a opção do Memory Graph

Figura 6. Função de embeddings: seletor ①, Validar embedding ② e, logo abaixo, a opção do Memory Graph.

Na maioria dos casos, deixe desmarcada a opção Usar um modelo de embedding diferente para o Memory Graph. Por padrão, o Memory usa o mesmo modelo do Knowledge. Separar os dois é raro, e cada troca exige reindexar as entidades.

​
2.3 Monte o catálogo do Strattum Chat (opcional)

O catálogo define os modelos que os usuários podem escolher no seletor do Strattum Chat. Ele é independente dos modelos da plataforma e pode misturar provedores.
  1. Em Adicionar modelos ao catálogo, busque o modelo e adicione ①.
  2. Preencha o Nome de exibição ②, que é como o modelo aparece no seletor (obrigatório, até 40 caracteres). A Descrição é opcional (até 100 caracteres) e aparece numa linha abaixo do nome.
  3. Clique em Testar o catálogo ③. O console envia uma chamada mínima para cada modelo e confere nomes e funções.
  4. Em Modelo padrão ④, escolha o modelo que já vem selecionado em toda conversa nova. O usuário pode trocar no seletor quando quiser.
  5. Em Modelo que gera títulos ⑤, escolha o modelo que escreve o título de cada conversa no histórico. Um modelo rápido e barato basta.
Bloco Modelos do Strattum Chat com a busca de modelos, o nome de exibição, o botão Testar o catálogo, o modelo padrão e o modelo que gera títulos

Figura 7. Modelos do Strattum Chat: busca ①, nome de exibição ②, teste do catálogo ③, modelo padrão ④ e modelo que gera títulos ⑤.

​
2.4 Salve a configuração

  1. Clique em Salvar configuração ①, no canto superior direito da página.
Cabeçalho da página Modelos de IA com o selo Configurado e os botões Salvar configuração e Remover configuração

Figura 8. Cabeçalho da página Modelos de IA: Salvar configuração ① e, em vermelho, Remover configuração.

Cuidado com o botão vermelho Remover configuração, ao lado de Salvar: ele remove a configuração desta página.

​
Como confirmar que deu certo

  • A pessoa convidada entra no console pelo SSO, com o e-mail corporativo dela.
  • Em Usuários, ela aparece com a função Administrador.
  • Testar credencial, a validação de cada função e Testar o catálogo terminam sem erro.
  • A página Modelos de IA mostra o selo Configurado ao lado do título (Figura 8).
  • No menu de Configurações, Modelos de IA e Login único (SSO) aparecem com o ponto verde (Figura 1).

​
Se algo não funcionar

Se o problema continuar, fale com o FDE da Strattum que acompanha a sua implantação e envie um print da tela com o erro. Antes de enviar, confira que nenhuma senha ou chave aparece no print.

​
Próximo passo

Com o acesso e os modelos configurados, conecte as fontes de dados da sua empresa em Conectores, no menu principal do console.