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.

Começar a aula interativaLer as notas da aula

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.

Arquivos da oficina

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

Start hereArquivos da oficina

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

Arquivos desta etapa

Start hereArquivos da oficina

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.

Arquivos desta etapa

Start hereArquivos da oficina

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.

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

Esta lição foi útil?

Deixe uma curtida ou compartilhe com alguém que possa aproveitar.

Continue aprendendo

Explore as outras lições