Isaque Victor cursos gratuitosNesta aula
Ninguém da recepção vai abrir um terminal. E não deveria precisar.
A aula 4 te deu um modelo rodando, mas numa janela preta que só você vai usar. Para a IA local virar ferramenta de equipe, ela precisa de uma tela parecida com a que as pessoas já conhecem dos assistentes de nuvem: caixa de texto, histórico, botão de enviar. É isso que o Open WebUI faz. Ele roda na mesma máquina do Ollama (ou numa máquina da rede) e a equipe acessa pelo navegador. Nesta aula você entende o conceito, instala em linhas gerais, cria as contas e define as regras de acesso desde o primeiro dia.
- Ao final, você vai saber o que o Open WebUI faz e como ele se encaixa com o Ollama.
- Vai conhecer o caminho de instalação em linhas gerais e o que precisa ser configurado no primeiro acesso.
- Vai sair com um entregável: a equipe usando a IA local pelo navegador, com contas individuais e um modelo padrão definido.
Como as peças se encaixam
Pense em três camadas. Embaixo, o modelo: o arquivo com os pesos. No meio, o Ollama: o programa que carrega o modelo e recebe pedidos no endereço localhost:11434. Em cima, o Open WebUI: uma aplicação web que mostra uma tela de chat no navegador e, a cada mensagem, fala com o Ollama por trás. A pessoa da equipe só vê a camada de cima.
O Open WebUI é um projeto de código aberto e gratuito. Ele foi feito para lembrar a experiência dos assistentes de nuvem, e isso é uma vantagem de adoção: a equipe não precisa aprender uma tela nova, só um endereço novo. O que muda por trás é tudo: as conversas ficam gravadas na máquina da empresa, o modelo roda na máquina da empresa, e o endereço é interno.
O que ele traz além do chat
- Contas individuais, com um administrador que aprova cadastros e define permissões.
- Histórico por pessoa, para retomar conversas, e que o administrador pode governar.
- Escolha de modelo na própria tela, entre os que o Ollama tem instalados, com um modelo padrão que você define.
- Documentos e base de conhecimento: é possível anexar arquivos na conversa e montar coleções de documentos para o modelo consultar. É a porta para a aula 7.
- Instruções fixas por modelo ou por usuário, o equivalente às "instruções personalizadas" dos assistentes de nuvem.
Exemplo real
Num escritório contábil de doze pessoas, a IA local ficou dois meses parada porque só o sócio sabia usar o terminal. Quando o Open WebUI entrou, a equipe de departamento pessoal passou a usar no primeiro dia, sem treinamento, porque a tela era igual à que já usavam em casa. A diferença que eles precisaram entender foi uma só: "aqui pode colar a folha, porque não sai da sala".
Instalação em linhas gerais
Vou descrever o caminho, não cada tecla, porque o procedimento exato muda com as versões e a página oficial do Open WebUI é a fonte que vale. O que não muda é a lógica.
Onde instalar
Na mesma máquina em que o Ollama já está rodando é o mais simples: o Open WebUI encontra o serviço do Ollama em localhost:11434 sozinho. Para uma equipe, essa máquina deveria ser um computador que fica ligado no horário de trabalho, com a memória dimensionada na aula 3, e não o notebook de alguém que leva para casa.
Dois caminhos comuns
Contêiner (Docker)
É o jeito mais documentado. Você instala o Docker, roda o comando de uma linha que a página oficial mostra, e o Open WebUI sobe num endereço local com uma porta. Vantagem: isolado, fácil de atualizar. Peça ajuda a quem cuida da rede se nunca usou Docker.
Instalação Python
Para quem já tem Python na máquina, a documentação oferece instalação por pacote. Funciona bem para teste de uma pessoa; para a equipe, o contêiner costuma dar menos dor de cabeça.
Em qualquer caminho, o resultado é um endereço no navegador, algo como http://localhost:PORTA na máquina em que instalou, ou http://ENDEREÇO-DA-MÁQUINA:PORTA para os outros computadores da rede. A porta exata aparece na documentação e no comando que você rodou.
O primeiro acesso
- Abra o endereço no navegador. A primeira tela pede para criar uma conta. Essa primeira conta vira a de administrador. Quem cria precisa ser a pessoa responsável pela IA local, com uma senha forte guardada num gerenciador de senhas.
- Confira se os modelos do Ollama aparecem na lista de modelos. Se não aparecerem, o Open WebUI não está encontrando o serviço do Ollama; a documentação tem a configuração da conexão.
- Faça uma pergunta de teste. Se a resposta vier, a corrente está fechada: navegador, Open WebUI, Ollama, modelo.
Cuidado
Não deixe a primeira conta para "depois". Se a máquina fica acessível na rede e ninguém criou a conta de administrador, a primeira pessoa que abrir o endereço vira administradora. Crie a conta no mesmo minuto em que a instalação terminar.
Regras de acesso desde o primeiro dia
Ferramenta nova sem regra vira bagunça em uma semana. Estas são as regras que eu configuro antes de convidar a primeira pessoa.
| Regra | Por quê |
|---|---|
| Uma conta por pessoa, nunca compartilhada | Trilha de auditoria: quem perguntou o quê. Sem isso, a aula 11 não tem como existir. |
| Cadastro novo precisa de aprovação do administrador | Evita que alguém de fora da equipe, ou um ex-funcionário, entre por conta própria. |
| Acesso só pela rede interna | O endereço do Open WebUI não deve ser alcançável da internet. Quem trabalha de casa entra por VPN (aula 10). |
| Modelo padrão definido pelo administrador | A equipe não precisa escolher entre cinco modelos. Você escolhe o vencedor da aula 6 e deixa os outros escondidos ou restritos. |
| Instruções fixas com as regras da empresa | "Responda em português, sem emoji, não invente dados, diga quando não souber." Vale para todo mundo, sem depender de cada pessoa lembrar. |
| Senha forte e gerenciador de senhas para o administrador | A conta de administrador vê tudo. Se ela cair, cai o histórico da empresa inteira. |
Instruções fixas: o texto que eu uso como ponto de partida
Esse texto não resolve tudo, mas corta os erros mais comuns: resposta em inglês, invenção de dado e excesso de confiança. Ajuste ao seu negócio. Uma clínica acrescenta "não faça diagnóstico"; uma imobiliária acrescenta "não estime valor de imóvel".
Colocando a equipe para usar
A adoção não vem da instalação; vem do primeiro caso de uso que resolve um problema real. Escolha uma tarefa da tabela da aula 1, das que ficaram em "local", e apresente a ferramenta com ela. "A partir de hoje, o resumo dos laudos é feito aqui" é mais forte do que "temos uma IA nova".
Combine três coisas com a equipe na primeira conversa: o que pode colar (agora pode ser dado interno, porque não sai da rede), o que continua proibido (senha, dado de terceiros sem necessidade, qualquer coisa que a política da empresa vede) e a quem perguntar quando a IA errar. Escreva as três numa página e deixe visível. A aula 11 transforma essa página numa política de verdade.
Dica
Peça para duas pessoas repetirem, pelo navegador, as cinco perguntas de teste da aula 4. Se a resposta pela interface for igual à do terminal, ótimo. Se for diferente, provavelmente as instruções fixas estão agindo, e você acabou de ver o efeito delas na prática.
Prática · 10 min
Coloque a equipe usando pelo navegador
- Com o Open WebUI instalado conforme a página oficial, abra o endereço no navegador e crie a conta de administrador com senha forte, guardada no gerenciador de senhas.
- Confirme que os modelos do Ollama aparecem na lista e faça uma pergunta de teste.
- Defina o modelo padrão e cole as instruções fixas desta aula, adaptadas ao seu negócio.
- Ative a aprovação de cadastro pelo administrador e convide duas pessoas da equipe. Aprove as contas delas.
- Peça que cada uma faça as cinco perguntas de teste da aula 4 pelo navegador e anote a nota que deram.
- Escreva a página de três regras (o que pode colar, o que continua proibido, a quem perguntar) e compartilhe com as duas pessoas.
Resumo da aula
- Três camadas: modelo, Ollama (localhost:11434) e Open WebUI (a tela no navegador). A equipe só vê a de cima.
- Conversas e histórico ficam na máquina da empresa; o navegador é só a janela.
- Instalação pela página oficial: contêiner é o caminho mais documentado para equipe.
- A primeira conta vira administradora: crie na hora, com senha forte.
- Regras do dia 1: conta por pessoa, cadastro aprovado, rede interna, modelo padrão, instruções fixas.
- Adoção vem de um caso de uso real, não da instalação.
Quiz da aula
Quatro perguntas para fixar. A melhor nota fica guardada para o certificado.