Your first agent
Name your agent, write its system prompt, choose the language mode and storage policy, and add the first knowledge base entries.
An agent is the character that talks to your visitors. Your workspace already has one; open Agent Settings and click it.
Identity
- Name — internal name, shown in the panel.
- Display name — the name visitors see in the chat header, for example "Maya".
- Domain — the domain this agent serves.
- Greeting — the first message in the chat window.
System prompt
The system prompt tells the agent who it is, what it helps with, how it should talk and what it must not do. It is the single most important setting. A good first version:
You are Maya, the customer support assistant for Acme Store.
You help visitors with questions about products, orders, shipping,
returns and payment methods. Be friendly, concise and specific.
If you do not know the answer, say so and offer to connect the
visitor with support@acmestore.com. Never invent order details.
Keep facts such as prices and policies out of the prompt; they belong in the knowledge base. Read writing a system prompt for examples by business type.
Language mode
- Auto (recommended) — the agent answers in the language the visitor writes in.
- Fixed — the agent always answers in one language, whatever the visitor writes.
Storage policy
Controls whether conversations are kept. Flexible (default) keeps them only for the session; Full stores them in Chat Logs, which you need for the AI tools; Strict stores nothing on the server. See storage policy and privacy.
Model
New agents run on Claude Haiku 5.5 using the platform key. You can switch models or connect your own key later under BYOK.
Add a few knowledge base entries
Open Knowledge Base, create a category (for example "Shipping"), assign it to your agent under Agent Access, and add 5–10 FAQ entries for the questions you answer most often. Titles should be real customer questions: "How long does shipping take?" rather than "Shipping". Details in knowledge base.
Test it
Open Test Widget in the panel to chat with your agent before it goes live. Ask the questions your customers ask and adjust the prompt and entries until the answers are right.
Next: get your embed code and put the agent on your site.