Build agents

System prompts & prompt builder

The system prompt is the heart of an agent — its instructions, persona, and guardrails. You can write it directly, or assemble it with the prompt builder and let Hania compose the final text.

The system prompt

Every bot has a system_prompt: the standing instructions the model follows on every turn. Good prompts are specific about the agent's job, its tone, what it should and shouldn't do, and how to use its tools and knowledge. The prompt is a field on the bot — set it in the editor or via the Bots API.

The prompt builder

Rather than maintain one long block of text, the prompt builder lets you organize the prompt into structured parts (role, instructions, guardrails, and so on). Hania assembles those parts into the final system_prompt for you. The builder's structured form is stored on the bot as prompt_builder; the assembled result is the system_prompt the model actually sees.

Preview before you save

You can preview the assembled prompt to see exactly what the model will receive before committing — useful when you're iterating on structure. Pair prompt changes with a quick round in the test chat to confirm the behavior shift.

Keep instructions and guardrails close together and concrete. If the agent needs to act, give it tools; if it needs facts, give it knowledge — the prompt should tell it when to use them.