All pages

Docs

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.

View as Markdown

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#

  1. Under Agents, press + Create agent (when there are no agents yet, the templates are shown on the list page).
  2. Press Choose on the template closest to your use. To start without a template, press Start from scratch.
  3. Enter a Name. It's for your own management; callers don't hear it.
  4. 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.
  5. 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#

  1. Press the agent's name in the Agents list.
  2. Change the settings.
  3. 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.

  1. Press Remove at the top of the agent page.
  2. 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.