Para criar um agente de IA para o seu site, comece com uma única tarefa do visitante e um conjunto pequeno de respostas aprovadas. No Agentkit, adicione essas fontes, ajuste o chat, teste-o no Playground e depois copie o código de incorporação em Channels → Website embed. Publique apenas quando uma página real devolver as respostas que você espera. Você pode adicionar ações assim que o fluxo básico de perguntas e respostas funcionar.
Este guia cobre um chat de site baseado em conhecimento, com ações opcionais. Ele não promete que um agente consiga concluir uma reserva, emitir um reembolso ou alterar um pedido só porque consegue falar sobre essas tarefas.
1. Escolha a tarefa antes de escolher o modelo
Anote o pedido que você quer atender primeiro. Por exemplo: "Ajudar os visitantes a encontrar nossa política de envio e explicar quando um pedido tem direito a entrega gratuita." Indique a fonte da verdade e o caminho alternativo para as perguntas que o agente não consegue responder. Assim você terá um critério para avaliar o resultado depois.
Se você precisa de uma árvore de decisão fixa, sem respostas geradas, um chat com roteiro pode servir melhor. Se precisa de dados de uma conta específica ou de uma transação, planeje a integração e o seu limite de aprovação antes de convidar os visitantes a usá-la. Uma fonte de site, sozinha, não consegue consultar um pedido privado nem concluir uma compra.
2. Crie o agente e verifique as fontes
Crie uma conta no Agentkit e inicie um novo chatbot. O assistente de configuração aceita uma URL de site ou fontes manuais e depois mostra as páginas encontradas antes de passar pelo design e pelas configurações de IA. Os modelos e as cotas disponíveis dependem do seu plano atual, então use as opções mostradas na sua conta e consulte os preços atuais antes de orçar tráfego público.
Para uma URL de site, o assistente mostra as páginas encontradas, mas não permite remover páginas individuais nessa etapa. Depois da configuração e do treinamento, abra Sources → Website. Remova as páginas nas quais os visitantes não devem confiar, como ofertas expiradas ou versões antigas de políticas. Mantenha as páginas atuais de produto, políticas e ajuda. Se o rastreador deixar uma página de fora, adicione-a em Sources → Website depois da configuração. Em Sources você também pode adicionar arquivos, texto e entradas de perguntas e respostas. O guia da fonte de site explica os controles de rastreamento.
Comece com poucas páginas que você consiga verificar. Um rastreamento mais amplo só é útil quando as páginas são precisas e relevantes. Não coloque documentos privados nas fontes de um agente público só porque um controle de upload os aceita.
3. Defina a aparência e as instruções do chat
No assistente, escolha o design e as configurações de IA adequados à tarefa do visitante. Depois da criação, você pode voltar ao design e às instruções do agente. Uma mensagem de abertura útil diz o que o agente consegue responder: "Pergunte sobre entrega, devoluções ou cuidados com o produto." Perguntas sugeridas podem dar um ponto de partida aos visitantes, mas não afirme que elas melhoram a conversão sem medir isso no seu próprio site.
Dê ao agente um limite que ele consiga seguir. Para o exemplo do envio: "Use nossas informações publicadas sobre envio e devoluções. Se uma data de entrega depender de um pedido específico, diga que você não consegue ver esse pedido e encaminhe o visitante ao suporte." Inclua o caminho de suporte real. As instruções não substituem uma fonte correta nem um teste da resposta.
4. Teste as respostas antes de adicionar ações
Use o Playground para fazer perguntas sobre as páginas aprovadas. Registre a pergunta, a fonte e a resposta esperada. Esse pequeno conjunto de lançamento facilita a verificação de mudanças futuras.
| Pergunta de teste | Resultado esperado | Falha a corrigir |
|---|---|---|
| "Quando o envio é gratuito?" | Informa o limite atual da página de envio publicada. | Cita um limite antigo ou inventa um. |
| "Onde está o pedido 12345?" | Diz que não consegue ver um pedido privado sem uma consulta de pedidos conectada e indica o caminho de suporte. | Chuta uma data de entrega. |
| "Vocês podem abrir uma exceção na política de devolução?" | Explica a política publicada e encaminha exceções a uma pessoa. | Promete uma exceção. |
O número do pedido é um teste ilustrativo, não um registro real de cliente. Se uma resposta estiver errada, inspecione a fonte primeiro. Atualize a página desatualizada ou adicione uma entrada precisa de perguntas e respostas e depois repita a mesma pergunta. O guia de treinamento cobre a manutenção das fontes e a verificação das respostas.
5. Adicione uma única ação, e só quando ela tiver um resultado claro
As ações podem coletar um lead, mostrar um botão ou conectar um serviço compatível. Escolha uma ação que pertença à tarefa do visitante e depois teste no Playground tanto o caminho de sucesso quanto o de falha. Por exemplo, uma ação Collect Leads pode pedir um e-mail para que uma pessoa faça o acompanhamento. Um lead enviado é um pedido de contato, não prova de que uma venda ou um agendamento aconteceu. O guia de Collect Leads mostra a configuração.
Se a ação abrir um provedor de reservas, conclua uma reserva de teste nesse provedor e verifique a confirmação. Se ela precisar de dados de uma conta específica, confira as permissões e evite prometer um resultado até que a integração o devolva. Para um agente útil de perguntas e respostas, você pode deixar as ações desligadas.
6. Copie o código que a sua conta gera
Quando as respostas e as eventuais ações passarem nos testes, abra Channels → Website embed. Escolha Chat widget para um balão flutuante ou Iframe para um painel embutido. Ative o canal que você pretende usar. Os dois canais têm interruptores separados. O Agentkit informa que o iframe não oferece recursos avançados. Se você adicionou uma ação, teste-a no canal que vai publicar.
Para o widget, copie o código gerado completo. Ele contém um pequeno script de inicialização e um script assíncrono do widget com o ID do seu agente e o host configurado. Coloque as duas tags uma única vez no rodapé compartilhado ou no template HTML do seu site, antes de </body>, e depois publique. Para um painel embutido, copie o iframe gerado em vez disso e dê a ele altura suficiente no seu layout. Não use uma URL de widget, um caminho de iframe ou um pacote React copiados de um artigo antigo. O guia de incorporação cobre posicionamento e resolução de problemas. Quem tem site em WordPress pode seguir o guia do WordPress atual.
7. Verifique uma página pública e continue verificando
Abra a página publicada em uma janela nova do navegador. Confirme que o balão ou o painel aparece, abre, aceita uma mensagem e devolve uma resposta baseada em fonte para uma das suas perguntas de lançamento. Depois faça uma pergunta que ele deveria recusar ou encaminhar a uma pessoa. Registre o que aconteceu. Uma incorporação que funciona só prova que o chat carregou; não prova que todas as respostas são seguras.
Se o chat não aparecer, verifique se o canal correto está ativado e se a página publicada contém o código gerado completo ou o iframe. Um editor de site ou um cache pode remover ou atrasar scripts. Se ele carrega mas não consegue responder, verifique o status de treinamento das fontes e as configurações do agente. O guia de restrição de domínio explica um possível bloqueio da incorporação.
Depois do lançamento, revise conversas reais em busca de perguntas sem resposta que se repetem. Corrija a fonte e depois execute de novo a pergunta de lançamento afetada e uma verificação na página pública. Mantenha visível um caminho de contato normal para quando o agente não puder ajudar. Esse é o padrão prático para um agente de site: os visitantes obtêm uma resposta útil, percebem quando ele não a tem e chegam à próxima pessoa ou página.
