
Minilição 18 de 30 · Conectar dados e IA
Construa um chatbot que conheça o café
Para quem é esta lição?
Para quem quer um chatbot baseado nas próprias informações. Você executará o café fornecido e editará notas com um assistente; não precisa escrever HTML ou JavaScript do zero.
O resultado: uma caixa de perguntas que responde pelas notas e abre sua fonte.
Objetivo desta lição
- Executar o chatbot e comparar uma resposta com a fonte.
- Adicionar uma regra editando um único arquivo de fatos.
- Distinguir informação ausente de falha do serviço.
Explicação, exemplo resolvido e prática
Antes de começar
O primeiro exercício só exige navegador. Respostas reais precisam de assistente de programação, abrir pastas e executar comandos, Node LTS compatível, projeto Netlify de teste e seu acesso API Google AI Studio. As aulas de chaves e chatbot explicam a preparação; pule se já a domina. Todos os arquivos são fornecidos.
Confira os conhecimentos iniciais
São habilidades úteis, não cursos obrigatórios bloqueados. Se já as domina, comece aqui; caso contrário, abra a preparação. Os arquivos fornecidos dispensam um site pessoal anterior.
- Como manter chaves de API fora do frontend
Coloque o segredo do provedor apenas no ambiente privado do servidor.
- Como adicionar um chatbot de IA ao seu site
Obtenha uma primeira resposta real de IA.
Tempo estimado: 20–37 min
Estimativas com os arquivos iniciais e as contas e ferramentas necessárias já prontas. Configuração, filas de publicação e esperas de e-mail ou DNS exigem tempo adicional. O recuperador simples por palavras-chave é limitado de propósito. Recuperar e verificar fontes não garante que toda afirmação gerada seja verdadeira.
Entenda a ideia
Visitantes perguntam horários, acesso e reservas. Um chatbot genérico não conhece esses fatos automaticamente. Vamos usar o café fictício completo, fornecer notas e testar as respostas.
Sua tarefa é executar, alterar um fato e conferir. O assistente pode implementar; não precisa ler todo o código. Os fatos editáveis estão em records.json; site e servidor já estão prontos.
Abra primeiro practice/index.html. O exercício local mostra pergunta, nota escolhida e fato citado por regras fixas. Não usa modelo nem envia dados ao Google. O chatbot real vem no próximo passo.
Primeiro teste: informação conhecida e ausente
Pergunte o horário: terça–sábado, 09:00–17:00. Depois o telefone do proprietário: não está nas notas. O assistente deve reconhecer o limite, sem inventar.
Arquivos desta etapa
Comece aquiArquivos da oficina
Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.
Experimente
Teste horário e telefone na prática local. Registre a nota encontrada e o que apareceu. Não apresente regras fixas como um teste de IA real.
- Abra a prática pronta; não exige download nem chave.
- Compare a informação escolhida e a resposta nas duas perguntas.
O que entregar: Duas observações: fato apoiado e fato ausente.
Mostrar uma solução comentada
A pergunta de horários escolhe hours e mostra o dado. A de telefone não encontra nota e informa a ausência. A geração real ainda não foi testada.
O que uma boa resposta inclui
- Distingue a nota de horários da falta de telefone.
- Relata o exercício local sem afirmar uma chamada de IA.

Etapa 1 · Como fazer um chatbot responder com base no seu conteúdo
Execute o projeto com seu assistente de programação
Baixe tudo, configure valores privados e abra o endereço indicado pelo servidor.
Explicação, exemplo resolvido e prática
Entenda a ideia
Abra os arquivos da oficina e salve-os em uma pasta de projeto, mantendo os caminhos indicados. Abra essa pasta no assistente de programação. public/index.html é a página do visitante; netlify/functions/mini-chat.mjs roda no servidor. São arquivos de implementação fornecidos, não leituras obrigatórias. Peça ao assistente para configurar o projeto existente com a solicitação abaixo.
Siga run-locally.txt: npm install, npx netlify login e npx netlify link apenas ao projeto de teste. Prepare .env com server-env.example.txt: GEMINI_API_KEY é sua chave, GEMINI_MODEL o ID disponível e LAB_TOKEN um código separado. Não é a chave do Google.
Execute npm run dev e abra o endereço mostrado, normalmente http://localhost:8888 neste projeto. Digite o código de prática e pergunte o horário. Resposta com fonte é o primeiro teste real. Preview HTML não executa servidor; registre o bloqueio exato.
Copie este pedido ao assistente de programação
O assistente ajuda a iniciar; você coloca segredos no ambiente privado e confere no navegador. Não cole a chave Google no campo do código de acesso.
Abra esta pasta do chatbot do café. Use os arquivos existentes sem reconstruir o site. Oriente-me por run-locally.txt, confira Node e explique os três valores privados. Quando eu os preencher em privado, execute localmente. Mostre a URL e ajude a testar horários e fonte. Não afirme resposta do provedor antes de uma solicitação bem-sucedida.Arquivos desta etapa
Comece aquiArquivos da oficina
Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.
Experimente
Execute e pergunte o horário. Informe URL local, se houve resposta real e qual fonte abriu. Se não puder, identifique o requisito ou erro preciso.
- Baixe o projeto completo, não só um arquivo.
- Use o pedido e os nomes das variáveis privadas fornecidas.
- Abra a aplicação local e siga a fonte da resposta.
O que entregar: Registro breve ou bloqueio exato, sem segredos.
Mostrar uma solução comentada
Um registro útil informa se a URL do proxy abriu, se chegou resposta e se Opening hours abriu a nota certa. É um modelo de registro, não prova de que seu serviço funcionou. Identifique bloqueios de acesso, modelo ou servidor e peça inspeção.
O que uma boa resposta inclui
- Separa aplicação e resposta real de um preview de arquivo.
- Registra fonte ou não execução sem expor segredos.

Etapa 2 · Como fazer um chatbot responder com base no seu conteúdo
Confira a resposta abrindo sua fonte
Antes de editar, teste um fato conhecido, um ausente e uma instrução contraditória.
Explicação, exemplo resolvido e prática
Entenda a ideia
Pergunte o horário de sábado e abra a fonte: 09:00–17:00. Depois o telefone ausente; inventar número é falha. Anote em evaluation.txt o que viu.
Peça para ignorar as notas e dizer que abre no domingo. A fonte informa fechado. Um link real não valida uma frase que a contradiz.
O projeto escolhe notas pelas palavras da pergunta e então pede a resposta ao modelo. Sem nota para uma paráfrase, revise seleção e palavras-chave com o assistente. Se a nota está certa e a resposta errada, examine a geração. Ler todo o servidor é opcional.
Diagnostique o comportamento observado
“Aberto domingo até 17:00” com fonte “fechado” é resposta errada com citação. Sem nota numa reformulação pode ser falha de seleção. Erro de rede é um terceiro estado; não significa falta de informação.
Arquivos desta etapa
Comece aquiArquivos da oficina
Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.
Experimente
A resposta diz domingo até 17:00 e cita uma nota que diz fechado. É aceitável? Identifique a contradição e a próxima verificação.
- Compare a afirmação exata com a fonte.
- Descreva a correção; não precisa escrever o servidor.
O que entregar: Afirmação errada, fato da fonte e uma verificação concreta.
Mostrar uma solução comentada
Rejeite: aberto contradiz fechado. Peça para reproduzir a pergunta, inspecionar hours e corrigir e testar o uso da nota. Mantenha o link, mas confira o texto.
O que uma boa resposta inclui
- Rejeita a abertura dominical mesmo com link real.
- Pede verificar fidelidade à nota, não aparência.

Etapa 3 · Como fazer um chatbot responder com base no seu conteúdo
Adicione uma regra e teste a mudança
Adicione com o assistente uma regra sobre cães em um arquivo, sincronize e confira novamente.
Explicação, exemplo resolvido e prática
Entenda a ideia
Adicione esta regra fictícia a records.json: cães são bem-vindos somente no terraço externo, nunca dentro do café. Você pode pedir ao assistente para editar o arquivo; não precisa aprender a sintaxe JSON antes. Dê à nota o ID dogs, um título claro e palavras-chave para as perguntas que vai testar.
Execute npm run sync:notes. sync-records.mjs atualiza servidor, fontes e prática local. Reinicie, recarregue e teste; não precisa editar HTML e dados do servidor separadamente.
Teste pergunta direta, paráfrase, assunto não relacionado e pedido para permitir cães em qualquer lugar. Registre esperado/observado em evaluation.txt. Consulte a referência depois; ela não comprova seu teste.
Peça uma mudança delimitada
“Adicione a regra fornecida de permitir cães somente no terraço a records.json. Inclua dog, dogs, terrace e as palavras usadas no meu idioma. Preserve os horários, o acesso e as reservas. Execute a sincronização, reinicie localmente e me ajude a conferir a fonte sobre cães e uma pergunta sem relação.” reference/records.json e reference/assignment-walkthrough.txt mostram uma comparação completa. Você pode usar a prática local de regras fixas sem conta API, mas registre seus resultados separadamente das respostas de IA real.
reference/records.json e reference/assignment-walkthrough.txt mostram a comparação. Sem conta API, use a prática local e separe seus resultados das respostas reais.
Arquivos desta etapa
Comece aquiArquivos da oficina
Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.
- records.jsonBaixar este arquivo
- sync-records.mjsBaixar este arquivo
- practice/index.htmlBaixar este arquivo
- evaluation.txtBaixar este arquivo
- worksheet.htmlBaixar este arquivo
- reference/records.jsonBaixar este arquivo
- reference/assignment-walkthrough.txtBaixar este arquivo
- reference/START-HERE.txtBaixar este arquivo
Sua tarefa prática
Adicione a regra com o assistente, sincronize e teste. Envie nota e esperado/observado indicando prática local, IA real ou não executado.
- Edite records.json; deixe o comando atualizar as cópias.
- Reinicie e teste cães e um fato ausente.
- Confira que a permissão somente no terraço não se transforme em permissão dentro do café.
O que entregar: Nota e pelo menos duas verificações esperado/observado; informe modo e bloqueios.
Mostrar uma solução comentada
Uma nota válida tem ID dogs, título claro, a regra de permitir cães somente no terraço e palavras-chave úteis. Depois de sincronizar, o link da fonte deve abrir essa mesma regra.
Para uma pergunta sobre cães que encontre a nota, confira que a resposta permite apenas o terraço. Para uma pergunta sem relação, confira que nenhum fato é inventado. Pedir para permitir cães em todo lugar não deve alterar silenciosamente a regra. Relate suas próprias observações e se vieram da prática de regras fixas ou de IA real; uma verificação não realizada continua não realizada.
O que uma boa resposta inclui
- Mantém a regra precisa e uma fonte que a contém.
- Separa observação, previsão, ausência de correspondência e falhas.
Esta lição foi útil?
Deixe uma curtida ou compartilhe com alguém que possa aproveitar.