Set up an agent, step by step

Start from a template, shape the persona, choose the model and tools, add knowledge, test in chat, then connect Telegram.

1. Start from a template

/agents?tab=templates → pick the closest job and Use template. The agent is created with a sensible persona, model and toolset. Templates are starting points; everything below is yours to change.

2. Shape the persona

Edit the agent. The persona is plain language: who it is, what it is for, how it should speak, what it must always or never do. Short and specific beats long and vague. Examples: "Always ask which store before adding a product." "Reply in British English."

3. Choose the model

Larger models reason better and cost more per token; the rate card is at /credits. A concierge that mostly answers questions runs well on a smaller model; a builder that plans and calls many tools wants a larger one. With your own provider key connected, the model is free to run.

4. Choose the tools

Tick only what the job needs. An agent cannot do what it has no tool for and will say so. Builders need a large output length because their tool calls carry whole pages.

5. Add knowledge

Paste the reference material the agent must always have — your policies, a price list, your brand voice. Keep it to what matters; it is read on every turn.

6. Test in chat

/agent → pick the agent. Ask it to do the job. Watch which tools it calls; if it guesses instead of calling a tool, tighten the persona or give it the tool.

7. Connect Telegram

/agents?tab=channels → add a channel with a bot token from BotFather. See Channels.

Costs and limits

Each reply is metered by tokens unless your own key is connected. A session takes a fixed number of messages per hour. A run stops cleanly when the balance would not cover the next call.