Tutorial Completo
Passo a passo de ponta a ponta: Da inscrição a um Helper funcionando no seu site
Este tutorial irá guiá-lo por todo o processo de integração do AI Anywhere ao seu site. Ao final, você terá um Helper totalmente funcional que fornece assistência inteligente de texto aos seus usuários.
Duas maneiras de usar seu Assistente
Cada assistente está disponível de duas maneiras:
- Página de Ajuda (sem código): You get a shareable Helper Page link instantly. Open it from the dashboard by going to your Helper and clicking the "Helper Page" button (on the Helper's edit or detail page). Share the link with anyone; no snippet or integration required.
- Incorporar no seu site: Adicione um pequeno script e âncora ao seu site para que o botão do Assistente apareça ao lado das suas áreas de texto. Os usuários recebem assistência sem sair da sua página.
Este tutorial foca na opção de incorporação. Para usar a Página do Helper, crie um Helper no painel e clique em "Página do Helper" para abrir ou compartilhar o link.
Crie sua conta
Primeiro, você precisa se inscrever para uma conta AI Anywhere.
- Vá para a Página inicial do AI Anywhere
- Clique no "Comece Agora" botão no cabeçalho
- Inscreva-se usando sua conta social preferida (Google, GitHub, etc.)
- You'll be automatically logged into your dashboard
Crie seu primeiro assistente
Agora vamos criar um Helper que ajudará os usuários a escrever mensagens de formulário de contato.
- Ir para o painel "Assistentes"
- Dê ao seu Helper um nome descritivo, como
"Exemplo de Formulário de Contato" - Selecione o grupo ao qual este assistente pertence
- Clique no "Gerenciar Assistentes"
Configure seu assistente
Ao criar ou editar um Assistente, você configura:
- Resposta do Assistente: Enter a well-written example of what you want users to write. For a contact form, this might be a complete, professional message that includes all necessary information. The example should be complete with mock names, specific details, and realistic content (e.g., "Hello, I'm John Smith writing to inquire about your web development services. I'm particularly interested in building an e-commerce platform for my business. Could you please provide more information about your pricing and timeline? Thank you for your time.").
- Palavras-chave e/ou Regras: Adicione palavras-chave ou regras que são importantes para o seu caso de uso (por exemplo, "contato", "consulta", "pergunta", "suporte").
- Configurações do Tema do Botão Personalize a aparência do botão de Ajuda (cor, texto) para combinar com o design do seu site.
Obtenha seu código de integração
Aprenda a encontrar seletores CSS para áreas de texto, formulários e campos de entrada para integrar assistentes AI Anywhere no seu site.
- Nas configurações do seu Assistente, clique no "Gerar Trecho" botão
- Você verá dois trechos de código:
- Tag de script: Cole em seu site
- Span âncora: Contém seu token do Helper
- Copie ambos os trechos - você precisará deles na próxima etapa
Seu trecho de código consiste em duas partes:
<!-- Tag de script (vai em <head>) -->
<script src="https://ai-anywhere.ai/sdk/v1/loader.js" data-site="your-site-id"></script>
<!-- Exemplo: Botão de Ajuda aparece próximo à sua área de texto -->
<span data-helper-anchor data-helper-token="your-helper-token"></span>
<head> seção e é o mesmo para todas as páginas. O span âncora com seu token do Helper deve estar ao lado de cada área de texto onde você deseja que o Helper apareça.
Adicione o script ao seu HTML
Carregar o script do Assistente no seu
- Abra o arquivo HTML do seu site (ou modelo) e localize o
- Encontre o
<head>seção - seção. Cole seu trecho de código logo antes do fechamento
</head>da tag.
Veja como deve ser:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Entre em Contato Conosco:</title>
<!-- Incorporando o Script do Assistente -->
<script src="https://ai-anywhere.ai/sdk/v1/loader.js" data-site="your-site-id"></script>
</head>
<head> seção, após as meta tags, mas antes de outros scripts. Isso garante que o Helper carregue cedo.
Adicione a âncora do assistente ao seu formulário
Procure o botão de Ajuda próximo às áreas de texto na sua página
- Encontre seu formulário de contato (ou o formulário onde você deseja o Helper)
- Localize a área de texto onde os usuários digitarão sua mensagem
- Adicione o span âncora logo após a área de texto (ou em um local próximo)
Aqui está um exemplo completo mostrando ambas as partes:
<form id="contact-form">
<div>
<label for="name">Nome</label>
<input type="text" id="name" name="name" required>
</div>
<div>
<label for="email">Email:</label>
<input type="email" id="email" name="email" required>
</div>
<div>
<label for="message">Sua Mensagem:</label>
<textarea id="message" name="message" rows="6" required></textarea>
<!-- O botão do Assistente aparecerá ao lado deste elemento. -->
<span data-helper-anchor data-helper-token="your-helper-token"></span>
</div>
<button type="submit">Mensagem de Contato:</button>
</form>
Teste seu assistente
Agora vamos verificar se tudo está funcionando corretamente.
- Salvar Assistente
- Abra o seu site\
- Navegue até a página com seu formulário de contato
- Procure o botão de Ajuda próximo às áreas de texto na sua página
O Que Armazenamos
- Exemplo: Botão de Ajuda aparece próximo à sua área de texto
- O botão tem o estilo correto (cor, texto, tamanho) que você configurou
- Quando você clica no botão, a interface do Helper é aberta
- Quando você digita texto e clica no botão do Helper, ele fornece sugestões
Solução de Problemas
O botão de Ajuda não\
- Check your browser's developer console (F12) for any JavaScript errors
- Certifique-se de que a tag do script está na
<head>seção - Certifique-se de que o span âncora esteja presente e contenha o token correto do Helper
- Atualize a página forçadamente (Ctrl+Shift+R ou Cmd+Shift+R) para limpar os arquivos em cache.
- Verifique se o ID do seu site e o token do Helper estão corretos
Personalize seu assistente (opcional)
Defina o rótulo como "Assistente" ou personalize-o para combinar com sua marca.
O que você pode personalizar
- Personalizar aparências Altere a cor e o texto do botão de Ajuda.
- Resposta do Assistente: Cole um texto de exemplo de alta qualidade que mostre o que você deseja que os usuários alcancem.
- Palavras-chave: Adicione ou remova palavras-chave para melhorar a precisão das sugestões
- Total de Assistentes: Crie Helpers adicionais para diferentes formulários ou áreas de texto
Personalizar
- Ir para o painel
- Selecione "Assistentes", em seguida, selecione o Assistente específico que deseja editar
- Clique no "Editar" botão
- Salvar Alterações
- Salvar alterações
Implantar em produção
Depois de testar tudo localmente, é hora de implantar no seu site de produção.
Lista de Verificação Pré-Implantação
- Testou o Helper no seu ambiente local/de teste
- Você deve ver o botão Assistente aparecer ao lado de qualquer
- Teste com um navegador diferente:
- Testado em dispositivos móveis
- Verificou que as sugestões do Helper são úteis e precisas
Implantações atrasadas
- Envie seus arquivos HTML atualizados para o seu servidor web
- Certifique-se de que a tag do script está na
<head>Adicione um âncora onde você deseja o botão de ajuda - Verifique se os spans âncora estão colocados corretamente ao lado das suas áreas de texto
- Teste o Helper no seu site ao vivo
- Monitore para quaisquer problemas ou erros
- A mesma tag de script (com o ID do seu site) pode ser usada em todas as páginas
- Cada área de texto pode ter seu próprio Helper com um token diferente
- Inicialize múltiplos Assistentes com diferentes configurações para diferentes campos de formulário.
Guia de Configuração
Você integrou com sucesso o AI Anywhere no seu site! Seu Helper está agora ativo e pronto para ajudar seus usuários.
O que vem a seguir?
- Saiba mais sobre Vamos detalhar cada opção de configuração:
- Explore Tematização & Personalização Verificar se as escolhas de cores combinam com sua marca
- Verifique erros de digitação: Exemplos de Código para diferentes casos de uso
- Leia sobre Segurança & Privacidade Recursos
- Se você encontrar problemas, visite nosso Guia de solução de problemas