Sobre o projeto
O que é a Oficina Digital
Uma oficina de conserto de computadores de mentirinha, onde a inteligência artificial ajuda a organizar os chamados. Você aprende montando cada peça.
O caminho de um chamado
- 1O cliente abre o chamado no site.
Ele escreve o nome, o contato, o aparelho e o defeito. - 2A API guarda o chamado.
É um programa no seu computador que recebe o pedido e dá um número. - 3A IA faz um laudo.
Ela diz a prioridade, a causa provável e os próximos passos. - 4O técnico recebe no Telegram.
Ele vê o aviso no celular e usa comandos:/abertos,/ver 1,/andamento 1,/concluir 1. - 5O cliente acompanha no site.
Ele digita o número e vê o status e o laudo.
Para que serve
Para você aprender IA e automação com um caso de oficina. Você não baixa o projeto pronto: cria a sua pasta, abre no Antigravity e constrói o site, a API e o resto, pedindo ao Gemini. Só no final leva a pasta para o GitHub. São seis ferramentas, cada uma com um nome de trabalho:
| Ferramenta | Na oficina |
|---|---|
| Antigravity e Gemini | Ajudante de código (assistente de IA) |
| NotebookLM | Assistente que lê em voz alta |
| Obsidian e Graphify | Quadro de Fichas e Ligações |
| CrewAI | Dupla de especialistas |
| Telegram | Rádio do Técnico |
| GitHub | Arquivo Digital Central (no final) |
Como a IA faz o laudo
O projeto tem três jeitos de fazer a triagem. O padrão é o mais simples:
| Jeito | O que faz |
|---|---|
| Simples (padrão) | Procura palavras-chave no relato. Não usa IA. |
| Grafo de Conhecimento | Consulta uma memória de casos da oficina: aparelho → sintoma → causa → peça. Com a chave do Gemini, a IA refina a resposta. Sem a chave, usa regras locais. |
| CrewAI | Dois agentes de IA: um atendente e um técnico. Roda no Google Colab, separado da API. É opcional. |
O que ele faz
- Recebe chamados e guarda o histórico.
- Gera um laudo de apoio na hora.
- Avisa o técnico no celular.
- Mostra como a IA, o grafo e o bot se conectam.
O que ele não faz
- Não é diagnóstico de verdade. O laudo é um ponto de partida para estudar. Sempre confira na bancada.
- O grafo é pequeno: só 7 casos de exemplo, escritos no código.
- Ele não aprende. Um chamado novo não entra na memória, e ela volta ao início quando a API reinicia.
- Sem a chave do Gemini, a resposta vem de regras simples.
- O código criado pelo Gemini pode errar e ficar diferente do de outros alunos. Teste sempre e confira com a Especificação.
- O bot do Telegram só funciona com o seu computador ligado.
- Não está pronto para clientes reais: não tem login nem proteção de dados.
Por onde começar
Manual do Aluno Tutorial passo a passo Ver o grafo da oficina Painel de chamados