Read or change how the voice agent introduces itself
configure_agent_identityRead or change how the voice agent introduces itself on the user's calls: name, tone, opening line, answer to "who is calling?", introduction and the AI mention in the opening. Compliance: the recommended settings (default) say "Hello, this is Léa, 's virtual assistant. I'm calling about…" and answer yes when asked if it is an AI (EU AI Act art. 50); the agent never denies being an AI, whatever the settings.
Call it with no argument to read the current identity, a preview of what the agent will say, and the warning. Name and tone can be changed freely. Any other change is a deviation from the recommended settings: the first attempt returns the warning (error responsibility_acceptance_required) and changes nothing. Show the warning text to the user word for word; only if the user explicitly accepts, call again with the same changes plus accept_responsibility=true and warning_version. The acceptance is logged with a timestamp and the user becomes responsible for those settings. Refused whatever the acceptance: texts claiming the agent is human, or presenting it as police, government or a bank.
When to use: the user asks to rename the agent, change how it introduces itself or its tone. When not to use: a one-off greeting for a single call (put it in place_phone_call's task instead). Side effects: changes the settings for every new call of the account (calls already scheduled keep their identity). Idempotent.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tone | No | Tone of voice: 'warm' (recommended), 'neutral', 'formal' or 'upbeat'. Stays within the recommended settings. | |
| first_name | No | Name the voice agent gives (e.g. 'Lea'). Omit to keep the current one. Stays within the recommended settings. | |
| introduction | No | Custom answer when the callee asks who the agent is. Empty string = recommended. DEVIATION. | |
| opening_line | No | Custom opening line, spoken word for word when the callee answers, before the purpose of the call; may use {prenom} (agent name) and {operateur} (user's announced name). Write it in the language of the calls. Empty string = back to the recommended line. DEVIATION: needs the user's acceptance. | |
| warning_version | No | The warning.version the user accepted (from a previous call of this tool). | |
| reset_to_recommended | No | true: drop every deviation (keeps first_name and tone). | |
| accept_responsibility | No | Set true ONLY after you showed the user the warning text returned by this tool and the user explicitly accepted it in their own words. Never set it on your own initiative. | |
| ai_mention_in_opening | No | true (recommended): the opening line says the agent is a virtual assistant. false = DEVIATION. Either way the agent says yes if asked whether it is an AI. | |
| who_is_calling_answer | No | Custom answer when the callee asks who the agent is calling for. Empty string = recommended. DEVIATION. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| preview | No | ||
| warning | No | ||
| identity | No | ||
| next_step | No | ||
| deviations | No | ||
| fixed_rule | No | ||
| responsibility_accepted_at | No |