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
Go to the Agents page
- 1. In the left sidebar, click Agents.
- 2. You'll see an empty list (or your existing agents).
- 3. Click the blue Create Agent button (top-right corner).
๐ Fill out the creation form:
Agent name:
Choose a name that clearly describes its function.
Description:
Explain what the agent does and what you'll use it for.
Agent status:
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.
Open the configuration
- 1. On your new agent's card, click Configure.
- 2. The configuration page will open.
- 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.
๐ก 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. In the agent configuration page, click the Knowledge tab.
- 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:
How to upload:
- 1. Drag files into the drop area or click Upload.
- 2. Wait for them to be processed (a progress bar will appear).
- 3. When processing finishes, you'll see your documents listed.
โ Result: Your agent can now answer specific questions based on your information.
Open the test chat
- 1. Go back to the Agents page (sidebar).
- 2. On your agent's card, click Chat.
- 3. A chat window will open.
๐ฌ Recommended tests:
1. Basic question:
Check that the agent introduces itself correctly and explains its role.
2. Question about your information:
If you uploaded this information, it should answer correctly. If not, it should say it doesn't have that information.
3. Off-topic question:
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.
Go to the API tab
- 1. In the agent configuration page, click the API tab.
- 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.