โ† Back to documentation

Getting started

Your first setup: from zero to a working agent in 15 minutes.

Welcome to your first AI agent

This guide walks you step by step from creating your account to having a fully functional agent answering questions. You don't need any technical experience, just follow the instructions.

โฑ๏ธ Estimated time: 10โ€“15 minutes

1
Create your first agent
Basic setup and name

Go to the Agents page

  1. 1. In the left sidebar, click Agents.
  2. 2. You'll see an empty list (or your existing agents).
  3. 3. Click the blue Create Agent button (top-right corner).

๐Ÿ“ Fill out the creation form:

Agent name:

Example: Sales Assistant

Choose a name that clearly describes its function.

Description:

Helps customers find products, answers questions about prices and availability, and guides them through the purchase process.

Explain what the agent does and what you'll use it for.

Agent status:

It will be created as Active by default.

Later you can pause it from the agents list or from the configuration page.

โœ… Result: Your agent will appear in the list with a green Active badge.

2
Configure its personality
Define how your agent speaks and behaves

Open the configuration

  1. 1. On your new agent's card, click Configure.
  2. 2. The configuration page will open.
  3. 3. By default you'll be on the Core Model tab.

๐ŸŽญ Write the System Prompt:

This is your agent's "instruction manual". It defines its personality, tone and boundaries.

Example System Prompt:

You are a friendly and professional sales assistant.

Your goal is to help customers find the perfect product for their needs.

How you should speak:

  • Use a warm and positive tone.
  • Be clear and direct.
  • Use emojis occasionally ๐Ÿ˜Š.
  • Ask questions to better understand customer needs.

Important boundaries:

  • If you don't know something, admit it honestly.
  • Don't invent prices or information.
  • If the question is very complex, offer to escalate to a human.

โš™๏ธ Model settings:

Model:

Gemini Pro (recommended to start).

Temperature:

0.7 (a balance between creativity and precision).

Max tokens:

500 (medium-length answers).

Top P:

0.9 (leave as default).

โœ… Result: Your agent now has a defined personality and is ready to chat.

3
Add knowledge (Optional)
Teach it information specific to your business

๐Ÿ’ก This step is optional but highly recommended. If you skip it, your agent will use general knowledge. For specific answers about your products/services, you need to upload information.

Go to the Knowledge tab

  1. 1. In the agent configuration page, click the Knowledge tab.
  2. 2. You'll find an area to upload documents.

๐Ÿ“„ What to upload (examples):

Product catalog

List with names, features, prices.

Frequently asked questions (FAQ)

Answers to the most common questions.

Company policies

Shipping, returns, warranties, opening hours.

Accepted formats:

.PDF.TXT.MD.DOCX

How to upload:

  1. 1. Drag files into the drop area or click Upload.
  2. 2. Wait for them to be processed (a progress bar will appear).
  3. 3. When processing finishes, you'll see your documents listed.

โœ… Result: Your agent can now answer specific questions based on your information.

4
Test your agent
Make sure everything works correctly

Open the test chat

  1. 1. Go back to the Agents page (sidebar).
  2. 2. On your agent's card, click Chat.
  3. 3. A chat window will open.

๐Ÿ’ฌ Recommended tests:

1. Basic question:

You: "Hi, how can you help me?"

Check that the agent introduces itself correctly and explains its role.

2. Question about your information:

You: "What are your opening hours?"

If you uploaded this information, it should answer correctly. If not, it should say it doesn't have that information.

3. Off-topic question:

You: "What's the weather like today?"

It should say it can't help with that and stay within its role.

๐Ÿ’ก If something doesn't work as expected, go back to the configuration and adjust the System Prompt.

โœ… Result: You know your agent works correctly and is ready to be used.

5
Generate your API key
To connect the agent to your website

Go to the API tab

  1. 1. In the agent configuration page, click the API tab.
  2. 2. Click Generate key.

๐Ÿ”‘ Key configuration:

Name:

Example: "Main website".

Lifetime:

Select "Permanent" (to start with).

โš ๏ธ VERY IMPORTANT:

The key will be shown ONLY ONCE. Copy it immediately and store it in a safe place. It will look like this: agnt_sk_xxxxxxxxxx.

What to do with the key?

You have two options:

Option A: Hire a developer

Give them the key and the endpoint (you'll find it in the same API tab). They will know how to integrate it into your site.

Option B: Use it later

Store the key and use it when you're ready to integrate. For now, your agent is already working and you can test it from the dashboard.

โœ… Result: You have everything you need to integrate the agent into your website.

Congratulations! ๐ŸŽ‰

You've completed the basic setup of your first agent. It's now ready to help your customers.