Primeiros passos

Do primeiro acesso à primeira resposta da IA, em cinco passos.

Comece em 5 passos

1. Entre e ajuste o workspace

No primeiro acesso você entra com o e-mail de administrador definido na instalação (veja Self-host). Em Configurações → Detalhes você dá nome ao workspace e escolhe a aparência. Em Configurações → Authentication você define como as pessoas entram: em Iniciar Sessão, ligue E-mail, Passkeys ou o login único (SSO). O endereço do Keycloak fica na seção Keycloak, logo abaixo.

2. Configure a IA

Em Configurações → IA → LLM, escolha o provedor (OpenAI, Google Gemini, OpenRouter, litellm ou Ollama), informe a chave quando o provedor pedir (Ollama não pede) e o modelo, e marque-o como ativo. Sem um provedor ativo, a conversa e os agentes não respondem.

Ollama no mesmo servidor, com a wiki no Docker? Use http://host.docker.internal:11434/v1 como endereço — dentro do container, localhost é o próprio container.

Para a IA encontrar documentos pelo sentido da pergunta, e não só pela palavra exata, existe a busca semântica. Ela precisa ser ligada no servidor, com um Qdrant (veja Self-host); depois, em Configurações → IA → Busca semântica, escolha o modelo e clique em Reindexar tudo.

3. Convide o time

Em Configurações → Membros, convide pessoas por e-mail e escolha o papel de cada uma. Em Configurações → Grupos você junta pessoas para dar acesso de uma vez só. O convite vale por 7 dias.

4. Crie as coleções e os documentos

Use Novo projeto na barra lateral para criar uma coleção para cada área ou projeto (ex.: Produto, RH, Operações). Dentro dela, crie documentos. O editor é em blocos: digite / para ver as opções. Se você já tem conteúdo em Markdown ou no Confluence, traga tudo de uma vez por Configurações → Importar.

5. Converse com a IA

Abra o Chat na barra lateral, ou o botão Chat com IA dentro de um documento. Pergunte sobre o conteúdo: a resposta cita os documentos de onde saiu. Quando a tarefa pede pesquisa e escrita, escolha um agente. Ele trabalha em segundo plano: grava na hora os documentos novos e devolve como proposta as mudanças em documentos que já existem — essas só entram depois que você aprova.

Próximos passos