Você pode criar um chatbot Agentkit para o seu site sem escrever uma aplicação. Adicione páginas ou arquivos aprovados, escolha como o agente deve responder, teste-o no Playground e depois copie as duas tags de script geradas para a área de código do seu site. O último passo é um teste na página publicada. Um balão de chat que aparece no editor não comprova que os visitantes conseguem usá-lo.
Você precisa de uma conta Agentkit, de conteúdo que tenha permissão para usar e de autorização para adicionar código personalizado ao seu site. Se o plano do seu site ou a sua função não permitir publicar scripts, um iframe inline pode ser uma opção onde embeds são permitidos. Verifique as regras do seu site antes de começar.
1. Comece com uma pergunta e a sua resposta aprovada
Escolha três perguntas que os visitantes realmente fazem. Inclua uma pergunta rotineira, uma cuja resposta dependa de uma política atual e uma que as suas fontes não respondam. Anote a resposta aprovada ou o canal de contato humano para cada uma. Esse pequeno gabarito de respostas dá a você algo concreto para verificar depois.
Por exemplo, uma loja pode perguntar: "Quando posso devolver um item em promoção?" Use a política de devolução atual como fonte da resposta. Se a política não cobrir itens em promoção, a resposta aceitável é dizer que não é possível confirmar a regra e encaminhar o visitante à loja. O exemplo é um padrão de teste, não uma afirmação sobre a política de qualquer loja.
2. Crie o agente e adicione fontes
Crie uma conta, abra o painel e escolha Add AI agent. O assistente de configuração conduz você por Link, Sources, Design e AI. Você pode informar a URL do seu site ou adicionar fontes manualmente. Em Sources, selecione as poucas páginas que contêm as suas respostas aprovadas. Adicione um arquivo, trecho de texto ou par de perguntas e respostas apenas quando ele fornecer uma resposta que essas páginas não têm. O guia de fontes explica os tipos de fonte disponíveis.
Revise o que o rastreador incluiu. Uma URL de site não garante que cada página seja utilizável, atual ou aprovada. Evite adicionar versões duplicadas ou conflitantes de uma política. Depois que uma política mudar, atualize a fonte afetada e teste novamente a pergunta correspondente. O retreinamento automático pago atualiza as URLs de site já indexadas; ele não descobre todas as páginas novas nem substitui arquivos enviados por você. O guia de fontes de site explica esse limite.
3. Defina o design e as regras de resposta
Em Design, defina um nome reconhecível, uma cor e uma mensagem de abertura. Diga aos visitantes o que o agente pode responder. Em AI, escolha entre os modelos atualmente oferecidos na sua conta e escreva instruções curtas sobre escopo e incerteza. Nomes de modelos e acesso por plano mudam, então use o seletor do seu espaço de trabalho em vez de uma lista estática em um artigo.
Uma instrução útil é: "Responda a perguntas sobre a nossa política de devolução publicada usando as fontes fornecidas. Se faltar um detalhe ou as fontes forem conflitantes, diga que não é possível confirmar e encaminhe o visitante para [canal de suporte]." Substitua o canal entre colchetes por um que a sua equipe realmente acompanhe. As instruções orientam o comportamento; elas não tornam verdadeiro um material de origem ausente ou contraditório.
Conclua o assistente e abra o Playground. Faça as suas três perguntas e depois uma pergunta de acompanhamento que altere um detalhe importante. Compare cada resposta com o seu gabarito escrito. Corrija a fonte ou as instruções e repita o teste se uma resposta estiver errada. Se o agente oferecer captura de leads ou uma ação, teste o destino real antes de ativá-la para os visitantes; uma promessa feita na conversa, por si só, não é uma transferência concluída.
4. Instale o código do widget gerado
Abra a página Channels → Website embed do agente, selecione Chat widget e ative o canal. Copie o código completo gerado para o seu agente. Ele contém uma tag curta de inicialização da fila de comandos seguida de uma tag de carregamento assíncrona com o ID do seu agente e a URL do widget configurada. Cole as duas tags juntas no campo de código do rodapé do seu site ou no modelo HTML compartilhado, antes de </body>. Publique o site. Não copie um ID ou uma URL de script de um artigo de exemplo.
Se quiser um painel de chat dentro de uma seção da página em vez de um balão flutuante, ative Iframe na mesma página Website embed e use o código de iframe gerado. Para o posicionamento em cada plataforma, siga o guia atual do widget JavaScript, React e Next.js, WordPress, Webflow ou Framer. Adicione o código do widget uma vez por página renderizada.
5. Verifique a página pública
Abra a URL publicada em uma nova janela do navegador, inclusive em um celular. Mantenha este breve registro de aceitação:
| Verificação | Resultado esperado | Se falhar |
|---|---|---|
| Código-fonte da página | As duas tags de widget geradas aparecem uma vez | Verifique a permissão de inserção de código, a etapa de publicação e o cache do site. |
| O chat abre | O balão abre e aceita uma mensagem | Verifique se Chat widget está ativado e se o script carrega. |
| Pergunta conhecida | A resposta concorda com a fonte aprovada | Corrija a fonte ou as instruções e teste novamente. |
| Pergunta desconhecida | O agente evita inventar uma política e oferece o canal de contato real | Adicione um canal de escalonamento explícito e teste novamente. |
| Transferência para humano | O link de contato, formulário ou ação chega ao destino pretendido | Corrija o destino antes do lançamento. |
Se o widget aparecer no Playground mas não no domínio público, verifique as restrições de domínio e também o código gerado. Se o balão abrir mas não conseguir responder, verifique o processamento das fontes e a sua cota de mensagens. Registre a URL do teste, a pergunta, a resposta observada e a data para poder repetir a mesma verificação após uma atualização de fonte.
Um lançamento sem código ainda exige responsabilidade pelas fontes e revisão das respostas. Comece com um conjunto restrito de perguntas, publique e inspecione conversas reais em busca de lacunas. Se quiser experimentar este fluxo de trabalho, crie uma conta Agentkit e teste o widget publicado antes de direcionar visitantes para ele.
