> ## 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

> Set up your first AI agent application in less than 2 minutes

## Overview

This guide will help you set up Evo AI and create your first functional agent in just a few minutes. You will learn to:

1. **Register** on the online platform
2. **Confirm your account** via email
3. **Configure API Keys** from AI providers
4. **Create your first LLM agent**
5. **Test the chat** with your agent

<Note>
  **Online Platform**: This guide uses the online version of Evo AI at [app.evo-ai.co](https://app.evo-ai.co/login).
  For local installation, check our [installation guide](/installation).
</Note>

## Step 1: Platform Registration

### Creating Your Account

<AccordionGroup>
  <Accordion icon="user-plus" title="Access registration page">
    1. Go to [app.evo-ai.co/login](https://app.evo-ai.co/login)
    2. Click on the **"Register"** tab at the top of the screen
    3. You will see the Evolution API registration form

    <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="Evo AI Registration Screen" width="1391" height="1355" data-path="images/prints/quickstarter01_register.png" />
  </Accordion>

  <Accordion icon="pen" title="Fill registration data">
    Fill in all mandatory fields:

    * **Name**: Your full name
    * **Email**: Valid email (will be used for verification)
    * **Password**: Secure password (minimum 8 characters)
    * **Confirm Password**: Confirm your password

    <Warning>
      Make sure to use a valid email, as you will receive a confirmation link.
    </Warning>
  </Accordion>

  <Accordion icon="shield-check" title="reCAPTCHA protection">
    * The platform has **reCAPTCHA** protection for security
    * Complete the reCAPTCHA verification when requested
    * By using the service, you agree to the **Terms of Service** and **Privacy Policy**
    * The site is protected by Google reCAPTCHA
  </Accordion>
</AccordionGroup>

## Step 2: Email Confirmation

### Account Verification

<AccordionGroup>
  <Accordion icon="envelope" title="Check confirmation email">
    1. After registration, check your inbox
    2. Look for a confirmation email from Evolution API
    3. Click on the verification link in the email
    4. Your account will be activated automatically
  </Accordion>

  <Accordion icon="recycle" title="Didn't receive the email?">
    If you don't receive the confirmation email:

    1. Go back to [app.evo-ai.co/login](https://app.evo-ai.co/login)
    2. Click on the **"Login"** tab
    3. Try to log in with your **email** and **password**
    4. If the account is not verified, click on **"Resend Verification"**
    5. A new email will be sent

    <Tip>
      Also check your spam or junk folder.
    </Tip>
  </Accordion>
</AccordionGroup>

## Step 3: First Login

### Accessing the Platform

<AccordionGroup>
  <Accordion icon="key" title="Log in">
    1. Go to [app.evo-ai.co/login](https://app.evo-ai.co/login)
    2. Click on the **"Login"** tab
    3. Enter your **email** and **password**
    4. Complete the **reCAPTCHA** verification if requested
    5. Click **"Enter"**
    6. You will be redirected to the main dashboard

    <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="Evo AI Login Screen" width="1350" height="1153" data-path="images/prints/quickstarter02_login.png" />
  </Accordion>
</AccordionGroup>

## Step 4: Configuring API Keys

### Adding AI Providers

<AccordionGroup>
  <Accordion icon="key" title="Access API Keys configuration">
    1. After logging in, you will be on the **agents screen**
    2. Click on **"API Keys"** in the side menu
    3. You will see the list of available providers

    <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="Clicking on API Keys" width="1356" height="756" data-path="images/prints/quickstarter03_click_apikey.png" />
  </Accordion>

  <Accordion icon="list" title="View available providers">
    In the API Keys screen you will see all supported providers:

    <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="API Keys Screen with Providers" width="1258" height="852" data-path="images/prints/quickstarter04_apikey_screen.png" />
  </Accordion>

  <Accordion icon="plus" title="Register your first API Key">
    **Available providers:**

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

    **To add an API Key:**

    1. Select the desired provider
    2. Paste your API Key in the corresponding field
    3. Click **"Save"** or **"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="Registering API Key" width="1263" height="886" data-path="images/prints/quickstarter05_apikey_register.png" />

    <Info>
      **Security**: All API Keys are saved **end-to-end encrypted** for maximum security.
    </Info>
  </Accordion>

  <Accordion icon="lightbulb" title="How to get API Keys">
    **OpenAI:**

    * Go to [platform.openai.com](https://platform.openai.com)
    * Go to "API Keys" and create a new key

    **Google Gemini:**

    * Go to [ai.google.dev](https://ai.google.dev)
    * Get your free API key

    **Anthropic:**

    * Go to [console.anthropic.com](https://console.anthropic.com)
    * Create an account and generate your API key

    **Groq:**

    * Go to [console.groq.com](https://console.groq.com)
    * Register and get free access

    **Cohere:**

    * Go to [dashboard.cohere.ai](https://dashboard.cohere.ai)
    * Create an account and generate your key
  </Accordion>
</AccordionGroup>

## Step 5: Creating Your First Agent

### LLM Agent Configuration

<AccordionGroup>
  <Accordion icon="robot" title="Start agent creation">
    1. On the main screen, click **"New Agent"**
    2. You will be directed to the creation form

    <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="Clicking on New Agent" width="1646" height="955" data-path="images/prints/quickstarter06_click_new_agent.png" />
  </Accordion>

  <Accordion icon="gear" title="Fill agent form">
    Fill in all form fields:

    **Type:** Select **"LLM Agent"**

    **Name:** Name of your agent

    ```
    Example: Sales Assistant
    ```

    **Description:** Clear description of the purpose

    ```
    Example: Agent specialized in customer service and sales
    ```

    **Role:** Role that the agent will play

    ```
    Example: Specialized sales consultant
    ```

    **Goal:** Main objective of the agent

    ```
    Example: Help customers find suitable products and close sales
    ```

    **API Key:** Select one of the already registered API Keys

    **Model:** Choose the AI model

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

    **Instructions:** Detailed instructions for the agent

    ```
    Example:
    You are a professional and friendly sales assistant.
    Always be polite, ask relevant questions to understand
    customer needs and offer personalized solutions.
    Keep a conversational tone and help customers make
    informed decisions.
    ```

    <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="Agent Creation Form" width="1262" height="1380" data-path="images/prints/quickstarter07_form_agent.png" />
  </Accordion>

  <Accordion icon="check" title="Save the agent">
    1. Review all configurations
    2. Click **"Save"** or **"Create Agent"**
    3. Wait for creation confirmation
    4. Your agent will be available in the agents list
  </Accordion>
</AccordionGroup>

## Step 6: Testing the Chat

### First Conversation with Your Agent

<AccordionGroup>
  <Accordion icon="comments" title="Access the chat">
    1. Go to the **chat screen** in the main menu
    2. Click **"New Chat"** to start a new conversation

    <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="Starting New Chat" width="1034" height="675" data-path="images/prints/quickstarter08_new_chat.png" />
  </Accordion>

  <Accordion icon="user-robot" title="Select the agent">
    1. Select the agent you just created
    2. The chat interface will load with the chosen agent

    <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="Selecting Agent for Chat" width="929" height="1080" data-path="images/prints/quickstarter09_select_agent_chat.png" />
  </Accordion>

  <Accordion icon="message" title="Start conversation">
    1. Type a test message in the text box

    ```
    Example: Hello! I need help choosing a product for my company.
    ```

    2. Press **Enter** or click the send button
    3. Wait for the agent's response
    4. Continue the conversation naturally

    <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="Chatting with the Agent" width="2306" height="865" data-path="images/prints/quickstarter10_chat.png" />
  </Accordion>

  <Accordion icon="heart" title="Chat freely!">
    Now you can:

    * **Ask questions** about any topic related to the agent's role
    * **Test different scenarios** to validate responses
    * **Evaluate the quality** of interactions
    * **Adjust settings** if necessary

    <Tip>
      Try different types of questions to test your agent's versatility!
    </Tip>
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="A2A Protocol" icon="network-wired" href="/a2a-protocol">
    Integrate agents using the Agent 2 Agent protocol for external communication
  </Card>

  <Card title="Share Agents" icon="share" href="/configurations/share-agent">
    Configure shared agents for team collaboration
  </Card>

  <Card title="Agent Types" icon="users" href="/agents/index">
    Explore different agent types: LLM, Sequential, Parallel, Loop, Workflow and Task
  </Card>

  <Card title="Advanced Settings" icon="gear" href="/configurations/index">
    Configure credentials, custom tools and MCP servers
  </Card>
</CardGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion icon="triangle-exclamation" title="Common issues">
    **I don't receive confirmation email:**

    * Check spam/junk folder
    * Use "Resend Verification" on the login screen
    * Wait a few minutes before trying again

    **Error adding API Key:**

    * Check if the API Key is correct
    * Confirm there are available credits in the provider account
    * Test the API Key directly on the provider's website

    **Agent doesn't respond:**

    * Check if the API Key is working
    * Confirm the selected model is available
    * Check if there are sufficient quotas/credits

    **reCAPTCHA error:**

    * Clear browser cache and cookies
    * Try using another browser
    * Check your internet connection
  </Accordion>
</AccordionGroup>

***

🎉 **Congratulations!** You have successfully created your first agent in Evo AI and can now start chatting with it. Explore the advanced features to create even more powerful experiences!
