Quickstart

Build your first agent and have it answering in a few minutes - no code required to start. You'll create the agent, optionally give it knowledge and tools, test it in the built-in chat, then deploy it on your site or over the phone.

Sign up at the console and verify your email from the link we send. Your first workspace is created automatically on the Free plan - it's the container that holds your agents, knowledge, team, and billing. You can rename it later under Workspace settings.

From the dashboard, click New agent. You can build it three ways:

• Guided wizard - name the agent, pick a type, and fill in the prompt and settings step by step.
• AI-assist - describe what the agent should do (and optionally point it at your website or notes) and Hania drafts the system prompt and suggests tools for you.
• Blueprint - start from a pre-built template and customize it.

Then pick the type:

• Agent - talks with people in real time, on your website, in messaging channels, or on the phone.
• Autonomous Agent - everything an Agent does, plus it runs on its own on a schedule or a trigger.

Next to it you choose where it talks, Chat or Voice. That writes the prompt in the right style and, for Voice, adds the voice settings. It is not a third type: you can add a phone number, a widget, or a messaging channel to any agent later. See Create an agent.

Open Knowledge and add a source so your agent can answer from your own content:

• Text - paste content directly.
• URL - point Hania at a page to fetch and index.
• File - upload a document.

Hania chunks, embeds, and indexes each source automatically. Once processing completes, assign the source to your agent and it will retrieve relevant passages during conversations.

Tools let your agent take action - look something up, create a record, or call your own API. Under Tools you can add a tool three ways: configure one manually, start from a preset, or use AI discovery to read your API docs and set it up for you. Then assign the tool to your agent, and it will call it when the conversation calls for it.

Open your agent and use the built-in Test tab to talk to it exactly as a user would. You'll see its replies stream in, watch any tool calls execute, and can inspect the full trace of a conversation to understand how it reasoned. Iterate on the prompt, knowledge, and tools until it behaves the way you want. For an Autonomous Agent, chat with it in Conversations or use Run now instead, which exercise the full agent loop.

When you're happy with it, put it in front of users:

• Chat widget - open Widgets, customize the look and greeting, and copy the embed snippet onto your site. Edits in the dashboard sync to the live widget.
• Voice - give the agent a voice on its Voice tab and bind a phone number to it, and callers reach it directly. Both halves are needed before a call connects.
• Messaging channels - connect WhatsApp, Messenger, Instagram, Telegram, Slack, or email. See Messaging channels.

The Agents list shows a badge for each surface an agent is live on, so you can see where it is deployed at a glance.

Everything you do in the dashboard is also available over the HTTP API. Create a key under Settings → API keys, granting it only the abilities it needs (for example, read-only access to bots). The plaintext key is shown once at creation - store it in a server-side secret, never in a browser.