Skip to main content

Agent Settings: teaching Lia about your firm

A walkthrough of the Agent Settings page, from firm context and the introduction to escalation rules and skill automations, and the two settings that matter most.

Written by Product Team

What this article helps with: The Agent Settings page: what each part of it changes, and which two settings do the most to make Lia sound like your firm.

Who this is for: Firm admins configuring Lia, and case managers who want to know where Lia's behavior comes from. Only Admins can change firm-wide settings.

When not to use this article: If you cannot see Agent Settings at all, that is an access question. Start with Getting started with Lia: access and permissions.


Key Terms

What do you mean when you say...

  • Lia Respond = the layer that is always working once a client is enrolled. It answers client texts, handles FAQs, and escalates to your team.

  • Firm context = what you tell Lia about your firm: terminology, business hours, background, preferences.

  • Escalation rule = a condition that makes Lia stop and hand the conversation to a person.

  • Phase = where a case sits in your project type. Lia reads the phase name, description, and FAQs.


Where the page lives, and who can change it

Agent Settings sits in the Lia section of your left-hand navigation. The subtitle on the page tells you its scope: "Firm-wide settings for every enrolled client. Pause or adjust individual clients from their case page."

Hold onto that distinction. Everything here applies to every enrolled client at once. Pausing or adjusting one person happens on that person's case page.

Only Admins can change firm-wide settings. Users and Team Users can open the page and read what is configured. If a save will not stick, check the role first.

Two controls sit in the top right. Live preview tests what you have built against a phone number. Describe a change is covered at the end of this article.


The Lia Respond card

The page opens on the Lia Respond card, showing an Active chip, a readiness count such as "2 of 2 ready", and Customize and Preview agent buttons.

Under that are four rows. This is your setup checklist:

  • Firm context, with a detail that covers instructions, background, and the FAQ count

  • Escalation rules, for example "4 active rules"

  • User Management, who at your firm can use Lia

  • Skill Automations, whether enrollment is Automatic or Manual Only, and which phases run which skills

FAQs are not their own row. They live inside Firm context, because they are firm knowledge Lia quotes. The introduction clients receive is not on this card either. That lives on the Care Coordination card, because a firm running only Lia Respond does not send that introduction.

Below the card is an Advanced Skills section holding the Care Coordination and Provider Liaison cards. Those have their own articles.


Firm context, the page that does the most work

Open Firm context and you land on a full page: "Terminology, business hours and background about your firm the agent can quote." The page opens by telling you why it matters: "Two things shape every answer Lia gives your clients: how you want Lia to sound, and the facts it can quote about your firm."

The Firm context page showing the agent name, how Lia should answer, about your firm, default case owner, the FAQ count, and the CMS toggle

Six sections, top to bottom.

What your clients call the agent

"This name signs every text your clients get, so pick something your firm is comfortable being introduced as." It ships as Lia. Change it if your firm would rather clients saw a different name on every message.

How Lia should answer

"Terminology, business hours, and anything else Lia should follow. These are instructions, so Lia obeys them." The placeholder shows the shape of a good entry: "We call Case Owners 'Patient Advocates', and our hours are Monday to Friday, 9am to 5pm EST."

Write it the way you would brief a new hire on the first day. If your firm says "client" and never "customer", say so. If your office hours are not the default assumption, say so. This box changes how Lia behaves, and it holds up to 5000 characters. A What belongs here? link sits beside the heading.

About your firm

"Background Lia can quote when a client asks who you are, what you do, or where you are. Reference only, it does not change how Lia behaves."

Read that last sentence carefully. Background is reference material Lia draws on when a client asks about the firm. Behavioral instructions go in the box above.

Paste your website address, press Read website, and Hona reads the site for you so you are not starting from a blank box. There is also a free-text area with a 6000 character limit. Read the site first, then cut what is stale.

Default case owner

"Who owns a client's case once they are enrolled. This is a team setting, not something Lia reads." The default is "None (use primary contact)".

This matters more than it looks, because the case owner is who escalations get assigned to. Set it to whichever role should be answering Lia's questions, and every future enrollment routes correctly on its own.

Answers to common questions

"Questions your clients ask over and over, with the answer you want Lia to give. These are written per phase, so each phase has its own set." The section shows the count across your phases, and Manage FAQs takes you to Company Settings → Project Types, where the writing actually happens. The FAQs section below covers them.

Context from your case management system

The boxes above are text you write once. This one is a live source: with Pull case context from CMS on, Lia also reads case details from your case management system as a case moves along. It applies to your whole firm, and it saves the moment you flip it rather than waiting for Save.

Everything else on this page needs Save at the bottom, and Cancel discards.


Firm Introduction and the Lia Respond rows

Customize on the Lia Respond card opens the identity settings, a set of rows that each have a Customize button and, in most cases, a toggle.

The Lia Respond identity rows: Firm Introduction, Firm context, Performance review, Provider recommendations, and Escalation rules
  • Firm Introduction. A toggle, off by default. "Send a personal text from your firm before the agent's first message, a warm hand-off on enrollment." While it is off, the row reads "Off, agent reaches out first." Turn it on for a note from your firm before Lia says anything.

  • Firm context. Always on, no toggle. "Terminology and business hours the agent follows, plus background about your firm it can quote." The same page described above, reachable from a second place. The FAQ count is folded into this row.

  • Performance review. A toggle, on. "Scheduled summaries of Lia activity for case owners."

  • Provider recommendations. A toggle. "Let the agent recommend new providers to clients who need care, it finds nearby providers and helps them get scheduled." This capability is enabled per firm by Hona first. Once it is on, you configure the behavior here.

  • Escalation rules. Always on, no toggle. Opens the rules editor. "Client and provider rules that tell the agents when to alert your team."

The introduction Lia sends on enrollment is not in this list. It lives on the Care Coordination card as Introduction, because it only sends when that skill is on.


FAQs, and where they actually live

FAQs are the answers Lia can give on its own. You write them on each phase under Company Settings → Project Types, which is where the Manage FAQs button inside Firm context takes you, and the Firm context row shows the count across those phases.

Lia reads FAQs for the client's case type across every phase, not only the phase the case is in now. An FAQ written on a later phase still reaches a client who is earlier in their case. Keep them current, because they feed Lia directly.

Project Types also carries an option to pause Engage notifications for enrolled clients, so your drips do not double-message someone Lia is already talking to.


Escalations

The Escalation rules page is described in-product as "Client and provider rules that tell the agents when to alert your team." It has three tabs: Rules, Follow-up policies, and Provider recommendations.

The Escalation rules page showing the Rules tab and rule cards with priority labels, rule type, and assignment

Under Rules you get Escalation Rules, the line "Define when the AI should alert your team for human intervention", a Restore client defaults link, and an + Add Escalation Rule button.

How a rule reads

Each rule is a card, written as a sentence so you can check it at a glance. A card carries:

  • A priority label, such as HIGH PRIORITY

  • A type chip, either Client rule or Provider rule

  • The sentence "Escalate when the client [condition]", or "Escalate when the provider [condition]"

  • An assignment: either "Assigns to: Case Owner" or "Assigns to: Role: [role]"

  • Edit and delete icons

So a rule is three decisions: what triggers it, how urgent it is, and who deals with it. Assigning to Case Owner keeps escalations with the person who knows the client. Assigning to a role sends them to whoever holds it, which suits work several people could pick up. Restore client defaults puts the shipped rules back.


Skill Automations

The Skill Automations row opens the page where you control how clients are enrolled and unenrolled. Two radio options: Automatic, "Enroll and unenroll clients as their case moves through phases", and Manual Only, "Staff enroll and unenroll each client by hand."

Below is Which phases enroll cases, and which skills run, a grid per project type with each phase as a row and one column per skill: Lia Respond, Care coordination, and Intake (soon). If clients are not enrolling on their own, this grid is the first thing to check. Enrolling clients on Lia covers it in full.


Describe a change

In the top right of Agent Settings there is a Describe a change button with a ⌘K shortcut. In-product description: "Edit settings by describing them. Describe the change you want and I'll show you exactly what updates before anything is saved."

It is a faster route when you know what you want but not which screen it is on, and nothing saves without you seeing the change first.


The two settings worth your time first

If you only do two things on this page, do these.

  1. Fill in firm context properly. Instructions and background. Not a paragraph, a real briefing.

  2. Add FAQs to your phases. Every question your team answers ten times a week is a question Lia can answer instead. Write them on the phases under Project Types. Lia reads them across the whole case type, so they still help a client who is in an earlier phase.

These two carry the most weight because of what happens when they are thin. Lia escalates when it cannot answer something with confidence. A firm with thin context and few FAQs gets exactly that: a stream of escalations for questions your team would have answered in one line, and replies that are correct but generic. Those escalations are Lia being careful, and a signal that it has not been told enough yet.

A good habit: when an escalation arrives that a written FAQ would have covered, add the FAQ then and there.


Where to go next


Conclusion

Agent Settings is where your firm's way of working gets written down for Lia. Spend an hour on firm context and FAQs at the start and you will spend far less time on escalations later. If you have questions, chat with our support team or email [email protected].

Did this answer your question?