Core concepts

A quick tour of the building blocks you'll work with. Everything in Hania hangs off a workspace and centers on agents, the ones that talk to your users.

Workspace

The workspace is your top-level container. It holds your agents, knowledge, tools, team members, and billing, and keeps everything isolated from other workspaces. You can rename it and manage members from Workspace settings.

Agent

An agent is a system prompt, a model, optional knowledge and tools, and the places it is reachable. There are two types:

• 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, working through a goal and reporting back. Because no one is watching those runs, the work is checked against what its tools returned before the run counts as complete.

Voice is not a third type. Any agent takes calls once it has a voice configured and a phone number bound to it, and the same agent can answer your widget, your channels, and the phone at the same time. See Create an agent to build one, and the Bots API to manage them programmatically.

Conversation

A conversation is a session between an end user and an agent. It's a sequence of messages and can be text or voice. Each conversation carries an execution trace - the model turns and tool calls behind the replies, which you can inspect to understand and debug behavior.

Knowledge

Knowledge is source material your agent can search to ground its answers (retrieval-augmented generation). Add text, a URL, or upload files; Hania chunks, embeds, and indexes them automatically. See Knowledge.

Tool

A tool is a function the agent can call to take action: a built-in capability, a preset, or your own API. The agent decides when to call a tool based on the conversation. See Tools.

Memory

Memory is the set of long-term facts an agent forms about the people it talks to, carried across conversations. Memories are typed and scored, and you can review, correct, or delete them. See Memories.

Widget

The widget is the embeddable experience for an agent: a script you drop on your site, with its own customization and a public, domain-restricted key. It runs in one mode, taken from the agent: a voice call for a Voice agent, text chat for any other. See the widget.

Deployments

A deployment is a place customers can reach an agent: a phone number, the website widget, or a messaging channel. They are independent of the agent's type, and an agent can have several at once. A voice agent has two ways to take calls, the phone number and the widget, and only the first needs a number. The Agents list shows a badge for each one, so you can see at a glance where an agent is live. An agent with no badges is not reachable by customers yet.

Channels

A conversation happens on a channel. Hania supports web (the widget/test chat), voice (phone and in-app), sms, whatsapp, and api (your backend via the Chat API), plus agent runs and post_call follow-ups. You can filter conversations by channel.