Creating and editing agents
How to create an agent (what the AI says and collects) from a template in the dashboard, and edit its greeting, fields to collect, FAQ, voice and more.
An agent decides what the AI says when it answers, how it says it, and what it collects. Agents in the left menu lists the agents in the current environment. Creating and editing require the developer role or above.
For what each setting means and how to write it through the API, see Agents.
Create from a template#
- Under Agents, press + Create agent (when there are no agents yet, the templates are shown on the list page).
- Press Choose on the template closest to your use. To start without a template, press Start from scratch.
- Enter a Name. It's for your own management; callers don't hear it.
- Replace the placeholders listed in the notice at the top (such as "〇〇歯科") with your own names and details. Pressing a placeholder in the notice moves to that field. You can't create the agent while placeholders remain.
- Change other settings as needed and press Create.
| Template | What it collects, for example |
|---|---|
| Dental clinic appointments | Purpose, first visit or not, preferred date and time, name, phone number |
| Restaurant reservations | Preferred date and time, party size, name, phone number, seating and food requests |
| Inquiry intake | Purpose, company, name, callback number |
| Message taking | Who the message is for, the message, company, name, callback number |
| Auto service and tire shop bookings | Purpose, requested service, car model, preferred date and time, name, phone number |
The template content is Japanese phone handling, even in the English dashboard. Press Choose another template on the create page to switch templates.
After you create it, the agent's page opens. Try talking to it with Test in browser. To use the agent on calls, choose it for a tenant.
Edit#
- Press the agent's name in the Agents list.
- Change the settings.
- Press Save as v… at the bottom of the page.
Each save creates a new version. A call uses the latest version at the moment it starts (Agent versions). If you try to leave the page without saving, you're asked whether to discard your changes.
Settings#
The form is laid out in this order. Press the "?" next to a setting for an explanation.
| Section | Setting | Limits |
|---|---|---|
| Greeting and persona | Conversation language (Japanese, English, Chinese, Korean, Match the caller) | Japanese by default |
| Greeting (read out right after the call connects) | Required, up to 300 characters | |
| Persona (the AI's role and how it speaks) | Required, up to 1,000 characters | |
| Recording | Record conversations | Tell the caller in the greeting when you record |
| Conversation length | Maximum conversation length (5, 10, 15, 30 or 60 minutes) | 30 minutes by default |
| Fields to collect | Key, label, type (text or phone number), required | At least 1, up to 20 |
| When to transfer to staff | Conditions | Up to 20 |
| Closing lines | After collecting the fields | Required, up to 300 characters |
| When an FAQ answer resolved the call | Up to 300 characters | |
| FAQ | Questions and answers | Up to 50 |
| Speech recognition hints and voice | Industry, vocabulary | Vocabulary: up to 200 terms of up to 50 characters each |
| Voice (compare with Preview), speaking speed | ||
| Pronunciations | Text and reading (hiragana or katakana) | Up to 100 |
| Tools | APIs the AI calls during the call | Up to 10 (Agent tools) |
| Connections | Connections and actions used during the call | Those connected under Connections |
When every Required field to collect has been captured, the AI says the closing line and ends the call. When a transfer condition is met, the outcome becomes Transferred to staff. Transferring to a staff phone is done by your system based on this outcome (Phone).
Edit as JSON#
The JSON tab above the form lets you edit in the same format as the API's config (for developers). On save the server checks the format and lists anything to fix. Going back to the Form tab copies your JSON changes into the form; you can't go back while the JSON can't be parsed.
With the viewer role, every setting is read-only.
Delete an agent#
Requires the developer role or above. This can't be undone.
- Press Remove at the top of the agent page.
- Press Remove in the confirmation dialog.
An agent used by a tenant or a SIP credential can't be deleted. The confirmation dialog shows how many tenants and SIP credentials use it. Do both of the following, then delete it again.
- Tenants: under Tenants → Edit, choose another agent (see Tenants).
- SIP credentials: in SIP credentials in the same edit dialog, press Edit and change the agent, or delete the credential (see Phone numbers and SIP).
Existing call records are kept.