> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatmode.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Guia de Início Rápido

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](https://chatmode.com.br) 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](/pt-br/features/api-keys) 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

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

## 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!):*

   ```jsx theme={"system"}
   <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

* [Personalize seu agente](/pt-br/features/agents) com configurações avançadas
* [Configure múltiplos ambientes](/pt-br/features/environments) para diferentes plataformas
* [Aprimore o conhecimento do seu agente](/pt-br/features/trainings) com treinamento adicional
* [Monitore conversas](/pt-br/features/conversations) e analise o desempenho
