
Minilição · Português
Como fazer um chatbot responder com base no seu conteúdo
Use o projeto de café pronto: acrescente informações com um assistente de programação e confira respostas e fontes.
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.
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.
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.
O que você vai aprender
- 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.
Etapa 1
Construa um chatbot que conheça o café
O resultado: uma caixa de perguntas que responde pelas notas e abre sua fonte.
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
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
Etapa 2
Execute o projeto com seu assistente de programação
Baixe tudo, configure valores privados e abra o endereço indicado pelo servidor.
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.Google AI Studio: criar e gerenciar chaves API · Netlify: desenvolvimento local e vinculação do projeto
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.
Converse com o tutor sobre sua resposta
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.
- Separa aplicação e resposta real de um preview de arquivo.
- Registra fonte ou não execução sem expor segredos.
Arquivos desta etapa
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
Etapa 3
Confira a resposta abrindo sua fonte
Antes de editar, teste um fato conhecido, um ausente e uma instrução contraditória.
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.
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.
Converse com o tutor sobre sua resposta
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.
- Rejeita a abertura dominical mesmo com link real.
- Pede verificar fidelidade à nota, não aparência.
Arquivos desta etapa
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
Etapa 4
Adicione uma regra e teste a mudança
Adicione com o assistente uma regra sobre cães em um arquivo, sincronize e confira novamente.
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.
Sua tarefa prática
Materiais para começar
Os arquivos e conteúdos de teste estão incluídos. A verificação real exige sua própria conta, caixa de entrada ou domínio conforme os pré-requisitos. É possível inspecionar localmente; marque etapas reais não executadas como não testadas.
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.
Converse com o tutor sobre sua resposta
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.
- Mantém a regra precisa e uma fonte que a contém.
- Separa observação, previsão, ausência de correspondência e falhas.
Arquivos desta etapa
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
- 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
Esta lição foi útil?
Deixe uma curtida ou compartilhe com alguém que possa aproveitar.
Continue aprendendo
- Como criar seu primeiro site pessoal
- Como publicar seu site pelo GitHub
- Como conectar um domínio próprio ao seu site
- Como configurar e-mail no seu próprio domínio
- Como tornar seu site utilizável em celulares
- Como acelerar o carregamento das imagens do seu site
- Como receber os comentários do seu site na sua caixa de entrada
- Como adicionar assinaturas por e-mail ao seu site
- Como enviar e-mails automáticos pelo seu site
- Como salvar envios de formulário em um banco de dados
- Como permitir que as pessoas entrem no seu site
- Como manter uma página privada
- Como permitir que usuários editem as informações do perfil
- Como permitir que usuários enviem imagens
- Como manter chaves de API fora do frontend
- Como mostrar dados de uma API externa no seu site
- Como adicionar um chatbot de IA ao seu site
- Como adicionar um blog ao seu site
- Como adicionar busca ao seu site
- Como adicionar outro idioma ao seu site
- Como ajudar o Google a encontrar seu site
- Como corrigir a prévia do seu site ao compartilhar um link
- Como medir visitas e ações úteis no seu site
- Como permitir que visitantes agendem um horário
- Como aceitar um pagamento no seu site
- Como visualizar mudanças do site antes de publicar
- Como desfazer uma implantação com falha do seu site
- Como fazer backup e restaurar os dados do seu site
- Como encontrar e corrigir erros no seu site no ar