Get started

Hania Assistant

Every workspace comes with an assistant you can talk to. Tell it what you want in plain words and it does the work in your account: building an agent, connecting a tool, adding knowledge, running a test, or tracking down why something isn't behaving.

It is the fastest way to get something done in Hania, and a good way to learn the product. If you would rather do a job by hand, every screen it touches is still there for you to use.

Where to find it

Open Assistant at the top of the dashboard sidebar. That starts a fresh conversation with it. You can also pick it when you start a new conversation, and you will see it in your Agents list marked Built-in.

The assistant is part of your workspace and only ever sees your workspace. It doesn't count towards the agent limit on your plan.

What you can ask for

Anything you would otherwise click through the dashboard to do:

Build an agent. Describe the job in a sentence or two and it creates the agent, writes the prompt, and picks sensible settings. Ask it to change the tone, tighten the rules, or switch a voice and it edits what it already made.
Connect a tool. Ask for the integration you want and it sets it up, asks you for the credential when one is needed, then tests the connection so you know it works before you rely on it.
Work out an unfamiliar service. If you name a service Hania has no ready-made integration for, it can read that service's documentation, try the calls, and set up a working tool from what it learns.
Add knowledge. Point it at a page or paste in the text you want an agent to answer from.
Put an agent to work. Get it live on your website, on a phone number, or on a messaging channel.
Test and fix. Ask it to try an agent and report back, look at a conversation that went wrong, or explain why a tool call failed, then apply the fix.
Check your account. Your plan, your balance, what you have used, how many agents you have, what ran recently.
Tidy up. Turn something off, remove an agent you no longer use, rename things so the list makes sense again.

How to ask well

Plain language is enough. Two habits make the results better:

Say what you want, not how to do it. "Make a support agent for my Shopify store that can look up orders" gives it everything it needs.
Be clear about scope. A wide request gets wide work. If you only want one thing done, say so: "just create the Airtable connection, don't touch anything else."

A single request can take the assistant several steps. It works through them and then reports back once, so a short wait with no reply is normal on bigger jobs. You can watch what it is doing as it goes, and open any step to see the details.

Changing your mind mid-job is fine. Press Stop to halt what it is doing, then tell it what you want instead.

When it asks permission

The assistant stops and asks before anything that costs money or cannot be undone. Buying a phone number or deleting an agent, for example. You get a card showing exactly what it intends to do, and three ways to answer:

Approve and it carries on.
Approve with edits if the details are nearly right; correct them first and it uses your version.
Decline, with a reason if you want to give one. The reason matters. Tell it "I don't have access to that account" and it will suggest another way round instead of guessing.

If you have stepped away, the request waits for you in the Review queue under Operate, along with anything else that needs a decision. Requests there stay open for 72 hours.

When it needs a credential

Some tools need an API key or a token before they can do anything. The assistant asks for it with a secure form rather than in the conversation, so the value goes straight into encrypted storage and is never part of the chat transcript. Once it is saved, the assistant tests the connection and tells you whether it worked.

Nobody can read a stored credential back afterwards, including the assistant. If a key stops working or you rotate it, the assistant will ask for the new one the same way.

Give each tool the narrowest credential that will do the job, a read-only key where reading is all you need. That limit holds at the service itself, which is stronger than any setting in Hania.

What it will not do

It doesn't act on its own. There is no schedule and nothing to trigger. It works when you talk to it and then stops. For work that should happen on a timetable, build a scheduled agent and let the assistant set it up for you.
Your customers can never reach it. It cannot be put on your website, a phone number, or a messaging channel. Those are for the agents you build.
It cannot be deleted or duplicated. It is a fixed part of every workspace, and nothing outside your workspace can be given a way to talk to it.

Things worth asking

"Set up a receptionist for my clinic that books appointments and answers questions about opening hours."
"Connect my Google Calendar and check it works."
"My WhatsApp agent stopped replying yesterday afternoon. What happened?"
"Add the returns policy on my website to the support agent's knowledge."
"Which of my agents cost the most last month?"
"Test the sales agent as if I were a customer asking about pricing, and tell me how it did."