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

# Quickstart

> Configure sua primeira aplicação de agentes IA em menos de 2 minutos

## Visão Geral

Este guia irá te ajudar a configurar o Evo AI e criar seu primeiro agente funcional em poucos minutos. Você aprenderá a:

1. **Fazer o registro** na plataforma online
2. **Confirmar sua conta** via email
3. **Configurar API Keys** dos provedores de IA
4. **Criar seu primeiro agente** LLM
5. **Testar o chat** com seu agente

<Note>
  **Plataforma Online**: Este guia utiliza a versão online do Evo AI em [app.evo-ai.co](https://app.evo-ai.co/login).
  Para instalação local, consulte nosso [guia de instalação](/installation).
</Note>

## Passo 1: Registro na Plataforma

### Criando sua Conta

<AccordionGroup>
  <Accordion icon="user-plus" title="Acessar página de registro">
    1. Acesse [app.evo-ai.co/login](https://app.evo-ai.co/login)
    2. Clique na aba **"Register"** na parte superior da tela
    3. Você verá o formulário de cadastro da Evolution API

    <img src="https://mintcdn.com/evoai/aegF-STVJ9LMQ4Va/images/prints/quickstarter01_register.png?fit=max&auto=format&n=aegF-STVJ9LMQ4Va&q=85&s=4ca36b46578bc3fc45b1112abb1218da" alt="Tela de Registro do Evo AI" width="1391" height="1355" data-path="images/prints/quickstarter01_register.png" />
  </Accordion>

  <Accordion icon="pen" title="Preencher dados do registro">
    Preencha todos os campos obrigatórios:

    * **Name**: Seu nome completo
    * **Email**: Email válido (será usado para verificação)
    * **Password**: Senha segura (mínimo 8 caracteres)
    * **Confirm Password**: Confirme sua senha

    <Warning>
      Certifique-se de usar um email válido, pois você receberá um link de confirmação.
    </Warning>
  </Accordion>

  <Accordion icon="shield-check" title="Proteção reCAPTCHA">
    * A plataforma possui proteção **reCAPTCHA** para segurança
    * Complete a verificação reCAPTCHA quando solicitado
    * Ao usar o serviço, você concorda com os **Termos de Serviço** e **Política de Privacidade**
    * O site é protegido pelo reCAPTCHA do Google
  </Accordion>
</AccordionGroup>

## Passo 2: Confirmação de Email

### Verificação da Conta

<AccordionGroup>
  <Accordion icon="envelope" title="Verificar email de confirmação">
    1. Após o registro, verifique sua caixa de entrada
    2. Procure por um email de confirmação da Evolution API
    3. Clique no link de verificação no email
    4. Sua conta será ativada automaticamente
  </Accordion>

  <Accordion icon="recycle" title="Não recebeu o email?">
    Se não receber o email de confirmação:

    1. Volte para [app.evo-ai.co/login](https://app.evo-ai.co/login)
    2. Clique na aba **"Login"**
    3. Tente fazer login com seu **email** e **senha**
    4. Se a conta não estiver verificada, clique em **"Resend Verification"**
    5. Um novo email será enviado

    <Tip>
      Verifique também sua pasta de spam ou lixo eletrônico.
    </Tip>
  </Accordion>
</AccordionGroup>

## Passo 3: Primeiro Login

### Acessando a Plataforma

<AccordionGroup>
  <Accordion icon="key" title="Fazer login">
    1. Acesse [app.evo-ai.co/login](https://app.evo-ai.co/login)
    2. Clique na aba **"Login"**
    3. Digite seu **email** e **senha**
    4. Complete a verificação **reCAPTCHA** se solicitado
    5. Clique em **"Enter"**
    6. Você será redirecionado para o dashboard principal

    <img src="https://mintcdn.com/evoai/aegF-STVJ9LMQ4Va/images/prints/quickstarter02_login.png?fit=max&auto=format&n=aegF-STVJ9LMQ4Va&q=85&s=eabb861c8879f12f953e5398be9f8d2e" alt="Tela de Login do Evo AI" width="1350" height="1153" data-path="images/prints/quickstarter02_login.png" />
  </Accordion>
</AccordionGroup>

## Passo 4: Configurando API Keys

### Adicionando Provedores de IA

<AccordionGroup>
  <Accordion icon="key" title="Acessar configuração de API Keys">
    1. Após o login, você estará na **tela de agentes**
    2. Clique em **"API Keys"** no menu lateral
    3. Você verá a lista de provedores disponíveis

    <img src="https://mintcdn.com/evoai/aegF-STVJ9LMQ4Va/images/prints/quickstarter03_click_apikey.png?fit=max&auto=format&n=aegF-STVJ9LMQ4Va&q=85&s=b287b11e1eb91cdc925e1cbd72649a1e" alt="Clicando em API Keys" width="1356" height="756" data-path="images/prints/quickstarter03_click_apikey.png" />
  </Accordion>

  <Accordion icon="list" title="Visualizar provedores disponíveis">
    Na tela de API Keys você verá todos os provedores suportados:

    <img src="https://mintcdn.com/evoai/aegF-STVJ9LMQ4Va/images/prints/quickstarter04_apikey_screen.png?fit=max&auto=format&n=aegF-STVJ9LMQ4Va&q=85&s=4d0d046090d7811425c8dd4b381d44bb" alt="Tela de API Keys com Provedores" width="1258" height="852" data-path="images/prints/quickstarter04_apikey_screen.png" />
  </Accordion>

  <Accordion icon="plus" title="Cadastrar sua primeira API Key">
    **Provedores disponíveis:**

    * **OpenAI** (GPT-4, GPT-3.5-turbo)
    * **Gemini** (Google AI)
    * **Anthropic** (Claude)
    * **Groq** (Llama, Mixtral)
    * **Cohere** (Command, Embed)

    **Para adicionar uma API Key:**

    1. Selecione o provedor desejado
    2. Cole sua API Key no campo correspondente
    3. Clique em **"Salvar"** ou **"Add"**

    <img src="https://mintcdn.com/evoai/aegF-STVJ9LMQ4Va/images/prints/quickstarter05_apikey_register.png?fit=max&auto=format&n=aegF-STVJ9LMQ4Va&q=85&s=ba8a61bb2e3f6bbae5daacd2545b6231" alt="Cadastrando API Key" width="1263" height="886" data-path="images/prints/quickstarter05_apikey_register.png" />

    <Info>
      **Segurança**: Todas as API Keys são salvas **criptografadas de ponta a ponta** para máxima segurança.
    </Info>
  </Accordion>

  <Accordion icon="lightbulb" title="Como obter API Keys">
    **OpenAI:**

    * Acesse [platform.openai.com](https://platform.openai.com)
    * Vá em "API Keys" e crie uma nova chave

    **Google Gemini:**

    * Acesse [ai.google.dev](https://ai.google.dev)
    * Obtenha sua API key gratuita

    **Anthropic:**

    * Acesse [console.anthropic.com](https://console.anthropic.com)
    * Crie uma conta e gere sua API key

    **Groq:**

    * Acesse [console.groq.com](https://console.groq.com)
    * Registre-se e obtenha acesso gratuito

    **Cohere:**

    * Acesse [dashboard.cohere.ai](https://dashboard.cohere.ai)
    * Crie uma conta e gere sua chave
  </Accordion>
</AccordionGroup>

## Passo 5: Criando Seu Primeiro Agente

### Configuração do Agente LLM

<AccordionGroup>
  <Accordion icon="robot" title="Iniciar criação do agente">
    1. Na tela principal, clique em **"New Agent"**
    2. Você será direcionado para o formulário de criação

    <img src="https://mintcdn.com/evoai/aegF-STVJ9LMQ4Va/images/prints/quickstarter06_click_new_agent.png?fit=max&auto=format&n=aegF-STVJ9LMQ4Va&q=85&s=24634ce8f50c8fb964a7f9837282423b" alt="Clicando em New Agent" width="1646" height="955" data-path="images/prints/quickstarter06_click_new_agent.png" />
  </Accordion>

  <Accordion icon="gear" title="Preencher formulário do agente">
    Preencha todos os campos do formulário:

    **Type:** Selecione **"LLM Agent"**

    **Name:** Nome do seu agente

    ```
    Exemplo: Assistente de Vendas
    ```

    **Description:** Descrição clara do propósito

    ```
    Exemplo: Agente especializado em atendimento ao cliente e vendas
    ```

    **Role:** Papel que o agente desempenhará

    ```
    Exemplo: Consultor de vendas especializado
    ```

    **Goal:** Objetivo principal do agente

    ```
    Exemplo: Ajudar clientes a encontrar produtos adequados e fechar vendas
    ```

    **API Key:** Selecione uma das API Keys já cadastradas

    **Model:** Escolha o modelo de IA

    ```
    Exemplos:
    - OpenAI: gpt-4, gpt-3.5-turbo
    - Gemini: gemini-pro
    - Anthropic: claude-3-sonnet
    - Groq: llama2-70b-chat
    ```

    **Instructions:** Instruções detalhadas para o agente

    ```
    Exemplo:
    Você é um assistente de vendas profissional e amigável. 
    Sempre seja educado, faça perguntas relevantes para entender 
    as necessidades do cliente e ofereça soluções personalizadas. 
    Mantenha um tom conversacional e ajude o cliente a tomar 
    decisões informadas.
    ```

    <img src="https://mintcdn.com/evoai/aegF-STVJ9LMQ4Va/images/prints/quickstarter07_form_agent.png?fit=max&auto=format&n=aegF-STVJ9LMQ4Va&q=85&s=9fe2575a4244c13bcac1077e21a7dc09" alt="Formulário de Criação do Agente" width="1262" height="1380" data-path="images/prints/quickstarter07_form_agent.png" />
  </Accordion>

  <Accordion icon="check" title="Salvar o agente">
    1. Revise todas as configurações
    2. Clique em **"Save"** ou **"Criar Agente"**
    3. Aguarde a confirmação de criação
    4. Seu agente estará disponível na lista de agentes
  </Accordion>
</AccordionGroup>

## Passo 6: Testando o Chat

### Primeira Conversa com seu Agente

<AccordionGroup>
  <Accordion icon="comments" title="Acessar o chat">
    1. Vá para a **tela de chat** no menu principal
    2. Clique em **"New Chat"** para iniciar uma nova conversa

    <img src="https://mintcdn.com/evoai/aegF-STVJ9LMQ4Va/images/prints/quickstarter08_new_chat.png?fit=max&auto=format&n=aegF-STVJ9LMQ4Va&q=85&s=e83d081a0fe99b42a70e23514fb56bf1" alt="Iniciando Novo Chat" width="1034" height="675" data-path="images/prints/quickstarter08_new_chat.png" />
  </Accordion>

  <Accordion icon="user-robot" title="Selecionar o agente">
    1. Selecione o agente que você acabou de criar
    2. A interface de chat será carregada com o agente escolhido

    <img src="https://mintcdn.com/evoai/aegF-STVJ9LMQ4Va/images/prints/quickstarter09_select_agent_chat.png?fit=max&auto=format&n=aegF-STVJ9LMQ4Va&q=85&s=c0cbf92ffd4dd65205bf9c42e7180150" alt="Selecionando Agente para Chat" width="929" height="1080" data-path="images/prints/quickstarter09_select_agent_chat.png" />
  </Accordion>

  <Accordion icon="message" title="Iniciar conversa">
    1. Digite uma mensagem de teste na caixa de texto

    ```
    Exemplo: Olá! Preciso de ajuda para escolher um produto para minha empresa.
    ```

    2. Pressione **Enter** ou clique no botão de enviar
    3. Aguarde a resposta do agente
    4. Continue a conversa naturalmente

    <img src="https://mintcdn.com/evoai/aegF-STVJ9LMQ4Va/images/prints/quickstarter10_chat.png?fit=max&auto=format&n=aegF-STVJ9LMQ4Va&q=85&s=39660d98807b7bf4fd60e240f0b7ba72" alt="Conversando com o Agente" width="2306" height="865" data-path="images/prints/quickstarter10_chat.png" />
  </Accordion>

  <Accordion icon="heart" title="Converse à vontade!">
    Agora você pode:

    * **Fazer perguntas** sobre qualquer tópico relacionado ao papel do agente
    * **Testar diferentes cenários** para validar as respostas
    * **Avaliar a qualidade** das interações
    * **Ajustar as configurações** se necessário

    <Tip>
      Experimente diferentes tipos de perguntas para testar a versatilidade do seu agente!
    </Tip>
  </Accordion>
</AccordionGroup>

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Protocolo A2A" icon="network-wired" href="/a2a-protocol">
    Integre agentes usando o protocolo Agent 2 Agent para comunicação externa
  </Card>

  <Card title="Compartilhar Agentes" icon="share" href="/configurations/share-agent">
    Configure agentes compartilhados para colaboração em equipe
  </Card>

  <Card title="Tipos de Agentes" icon="users" href="/agents/index">
    Explore diferentes tipos de agentes: LLM, Sequential, Parallel, Loop, Workflow e Task
  </Card>

  <Card title="Configurações Avançadas" icon="gear" href="/configurations/index">
    Configure credenciais, ferramentas personalizadas e servidores MCP
  </Card>
</CardGroup>

## Solução de Problemas

<AccordionGroup>
  <Accordion icon="triangle-exclamation" title="Problemas comuns">
    **Não recebo email de confirmação:**

    * Verifique pasta de spam/lixo eletrônico
    * Use "Resend Verification" na tela de login
    * Aguarde alguns minutos antes de tentar novamente

    **Erro ao adicionar API Key:**

    * Verifique se a API Key está correta
    * Confirme se há créditos disponíveis na conta do provedor
    * Teste a API Key diretamente no site do provedor

    **Agente não responde:**

    * Verifique se a API Key está funcionando
    * Confirme se o modelo selecionado está disponível
    * Verifique se há quota/créditos suficientes

    **Erro de reCAPTCHA:**

    * Limpe cache e cookies do navegador
    * Tente usar outro navegador
    * Verifique sua conexão com a internet
  </Accordion>
</AccordionGroup>

***

🎉 **Parabéns!** Você criou com sucesso seu primeiro agente no Evo AI e já pode começar a conversar com ele. Explore as funcionalidades avançadas para criar experiências ainda mais poderosas!