Um chat web interativo com múltiplos agentes inteligentes, incluindo um assistente padrão, QuizMaster, especialista em gatos e RPG Master. Permite trocar de agente, enviar mensagens e receber respostas geradas via API Gemini (Google Generative AI). O projeto é divertido, educativo e personalizável.
-
💬 Chat multi-agente: escolha entre diferentes agentes especializados.
-
🧩 Agentes incluídos:
- Default: assistente amigável e prestativo.
- QuizMaster: mestre de desafios, quizzes e curiosidades.
- CatExpert: especialista em comportamento, saúde e bem-estar felino.
- RPG Master: narrador de aventuras curtas de RPG com escolhas interativas.
-
📝 Histórico de conversa separado para cada agente.
-
🖊️ Markdown suportado: títulos, listas, códigos, links e blocos de citação.
-
⌨️ Envio de mensagens via Enter, nova linha com Shift+Enter.
-
⏱️ Indicador de digitação animado enquanto o agente responde.
-
🔑 Configuração de chave da API: insira a chave do Google Gemini e interaja.
-
🎨 Layout responsivo e intuitivo.
-
🛠️ Código modular, fácil de personalizar e adicionar novos agentes.
/project-root
│
├─ index.html # Interface principal do chat
├─ style.css # Estilos e layout
├─ script.js # Lógica de agentes, envio de mensagens e histórico
└─ README.md # Documentação do projeto
- Abra
index.htmlno navegador moderno (Chrome, Firefox ou Edge).
- Copie sua chave da API Gemini (deve começar com
AIza). - Cole no input da tela inicial e clique em Salvar chave.
- O input desaparece automaticamente ao validar a chave.
⚠️ Se a chave for inválida, a seção volta para você tentar novamente.
- Digite no campo de mensagem e pressione Enter para enviar.
- Use Shift+Enter para adicionar uma nova linha sem enviar.
- O histórico da conversa é separado por agente.
- Pelo select na interface: escolha outro agente e ele assume automaticamente.
- Pelo comando dentro do chat:
/agente nome_do_agenteExemplo:/agente rpggame
| Nome | Emojis | Função |
|---|---|---|
| Default | 🌟 | Assistente amigável, responde perguntas gerais de forma clara e organizada. |
| QuizMaster | 🎲 | Cria quizzes, perguntas rápidas e explicações divertidas sobre vários temas. |
| CatExpert | 🐱 | Especialista em gatos: comportamento, saúde, alimentação e cuidados. |
| RPG Master | 🗡️ | Cria aventuras curtas de RPG, com opções interativas e final definido em até 5 turnos. |
- Markdown enriquecido: títulos, listas, links, blocos de código e citações.
- Auto-resize do campo de input, limitado a 100px.
- Indicador de digitação animado enquanto o agente está gerando a resposta.
- Mensagens de sistema: exibe status, erros e notificações para o usuário.
- Fallback de erros: quando há problema com a API, o input da chave reaparece.
Você pode criar novos agentes adicionando objetos dentro do const agentes em script.js:
const agentes = {
meuAgente: [
{
role: 'user',
parts: [
{
text: 'Você é meuAgente, um assistente divertido que responde tudo com emojis.'
}
]
}
]
}- Para adicionar no select:
<option value="meuAgente">😎 Meu Agente</option>- Use
/agente meuAgentepara trocar via chat.
- A API utilizada é
gemini-2.0-flashda Google Generative AI. POSTpara:
https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=SUA_CHAVE
- Payload:
{
"contents": [...historicoDoAgente],
"generationConfig": {
"temperature": 0.7,
"maxOutputTokens": 2000
}
}- Resposta do assistente adicionada ao histórico do agente.
- Este projeto é educativo e divertido, ideal para testes de chat multi-agente.
- Não há persistência de dados além do runtime: se recarregar a página, o histórico reinicia.
- Não salvar a chave da API: o input desaparece apenas durante a sessão.
- Adicionar persistência local do histórico (LocalStorage ou IndexedDB).
- Criar suporte a imagens ou rich media nas respostas.
- Adicionar sistema de pontuação para o QuizMaster.
- Permitir múltiplas aventuras salvas para o RPG Master.
Este projeto é open-source e pode ser usado e modificado livremente segundo a licença. Veja o arquivo LICENSE para mais detalhes.
Made with ❤️ by Larissa Santos