Comece a usar o Chatmode rapidamente seguindo estes passos para criar e implantar seu primeiro embed de agente de IA.

Pré-requisitos

Este guia ajudará você a começar a usar o Chatmode rapidamente. Siga estes passos para criar seu primeiro agente de IA e implantá-lo no ambiente escolhido.

Passo 1: Crie uma Conta

  1. Visite o site do Chatmode e clique no botão “Sign Up” (Inscrever-se).
  2. Crie uma conta usando seu e-mail ou faça login com Google ou GitHub.
  3. Complete suas informações de perfil e configure sua organização.

Passo 2: Crie Seu Primeiro Agente

  1. Certifique-se de ter adicionado uma Chave de API de provedor externo (ex: da OpenAI) em Configurações.
  2. No painel, navegue até a seção Agentes e clique em “Criar Agente”.
  3. Dê um nome ao seu agente.
  4. Selecione a Chave de API que você adicionou no passo 1.
  5. Escolha o Modelo disponível através dessa chave de API (ex: gpt-4-turbo).
  6. Configure as definições principais do seu agente:
    • Prompt: Defina a personalidade e a base de conhecimento do agente
    • Temperatura: Ajuste o nível de criatividade (menor para respostas mais determinísticas)
    • Tokens Máximos: Defina o comprimento máximo da resposta

Comece com uma temperatura entre 0.3-0.7 para um bom equilíbrio entre criatividade e precisão.

Passo 3: Treine Seu Agente (Opcional)

  1. Na seção Treinamentos, clique em “Novo Treinamento”.
  2. Faça upload de documentos (como texto) ou insira dados de texto relevantes para o seu negócio.
  3. Inicie o processo de treinamento para aprimorar o conhecimento do seu agente.

Passo 4: Configure um Ambiente

  1. Vá para a seção Ambientes e clique em “Criar Ambiente”.
  2. Escolha o tipo de ambiente EMBED.
  3. Conecte seu agente criado anteriormente ao ambiente.
  4. Configure definições específicas do ambiente (como Nome/Imagem de Exibição, Mensagem Inicial).
  5. Salve o ambiente.

Passo 5: Implante Seu Agente (Embed no Site)

  1. Navegue de volta para a seção Ambientes.

  2. Clique no ambiente EMBED que você acabou de configurar para abrir sua página de detalhes/edição.

  3. Encontre a seção Implementação ou Compartilhar (a localização exata pode variar ligeiramente na UI).

  4. Procure pelo snippet “Código da Bolha”.

  5. Clique no botão Copiar ao lado do Código da Bolha.

  6. Cole esta tag de script copiada no <head> ou <body> do HTML do seu site, idealmente antes da tag de fechamento </body>.

    Exemplo da estrutura do código que você copiará (NÃO copie este exemplo diretamente, use o da UI!):

    <script type="module">
      import Chatmode from "https://cdn.jsdelivr.net/npm/@chatmode/embed/+esm";
    
      Chatmode.initBubble({
        // Obrigatório - Copiado da UI
        environmentId: "SEU_ID_AMBIENTE",
        // Opcional - Copiado da UI se definido
        // iconKey: "SUA_CHAVE_ICONE",
        // updatedAt: TIMESTAMP,
        // Opcional - Pode ser adicionado/modificado manualmente
        theme: "automatic",
      });
    </script>
    
  7. O script adicionará automaticamente a bolha de chat flutuante, geralmente no canto inferior direito.

Passo 6: Teste Seu Agente

  1. Uma vez implantado, teste seu agente enviando mensagens e revisando as respostas.
  2. Analise o fluxo da conversa e faça ajustes na configuração do seu agente conforme necessário.

Próximos Passos