- Replace the wording. Declare the same response name in your project
responses.yml. See Where the file lives. - Replace the skill. Add
skills/<skill id>/with the same id. The project skill replaces the bundled one. Keeprouting.engine_managed: true. Omitting the key keeps the bundled value. Setting it tofalsealso offers the skill on the normal menu; the engine still treats that skill id as the lifecycle skill. Training rejectsfalseonbuiltin_unsupported_request_handler.
builtin_. To override a bundled skill, use that bundled skill’s id exactly.
Each section shows the files that ship with the skill. Skill responses ship
with rephrase: true, so the model may paraphrase them. The packaged responses
in Other packaged responses do not, except
utter_hangup_goodbye.
Session start
builtin_session_start runs at the start of a session and does not speak. It
has no bundled greeting to override.
To make the agent speak first, replace this skill and have the channel send
/session_start. To let the user speak first, leave the bundled skill as it
is. See Start a conversation.
skills/builtin_session_start/skill.md
memory.yml and no responses.yml.
Completed
builtin_completed runs when a skill you wrote finishes or is cancelled and
nothing else is left on the stack. It does not run after another default skill.
It asks whether the user wants more help. If they do, the agent asks what they
need and can activate that skill. If they do not, this skill links to
Customer satisfaction.
skills/builtin_completed/skill.md
skills/builtin_completed/memory.yml
skills/builtin_completed/responses.yml
Continue interrupted
builtin_continue_interrupted runs after a digression, when a paused task can
be resumed. It asks whether to continue. If the user agrees, the paused skill
continues from the same step. Otherwise it is dropped. See
Interruptions.
When this skill activates, the engine writes interrupted_task_name with a
readable label for the paused skill (its name, or its name plus description).
If that label cannot be stored, the prompt uses “your previous request”. Keep
interrupted_task_name in memory.yml if you replace this skill.
skills/builtin_continue_interrupted/skill.md
skills/builtin_continue_interrupted/memory.yml
skills/builtin_continue_interrupted/responses.yml
Customer satisfaction
builtin_customer_satisfaction collects whether the user was satisfied or
unsatisfied, then thanks them. Completed links here when the user does not want
more help. It is not chosen by ordinary routing.
conversation.before_end in agent.yml
is a separate list of skill ids rendered into the routing prompt. An example
there uses this skill’s id. That list is not what starts the bundled skill.
skills/builtin_customer_satisfaction/skill.md
skills/builtin_customer_satisfaction/memory.yml
skills/builtin_customer_satisfaction/responses.yml
Unsupported request
builtin_unsupported_request_handler runs when the model calls cannot_help.
Routing never activates it.
The engine sets request_type to in_domain_out_of_scope or
out_of_domain_out_of_scope. Both are requests the agent will not handle. The
value picks the message.
skills/builtin_unsupported_request_handler/skill.md
skills/builtin_unsupported_request_handler/memory.yml
skills/builtin_unsupported_request_handler/responses.yml
Silence timeout
builtin_silence_timeout runs when the user has been silent for the configured
timeout. Voice activates that skill three times. The next timeout activates
builtin_silence_timeout_hangup, which says goodbye and hangs up. Any user
speech resets the counter. The retry count is not configurable. See
conversation.
skills/builtin_silence_timeout/skill.md
skills/builtin_silence_timeout_hangup/skill.md
skills/builtin_silence_timeout/responses.yml
skills/builtin_silence_timeout_hangup/responses.yml
memory.yml.
Other packaged responses
These names live in the packaged defaults, not in one of the skills above. Override them the same way: declare the name in your ownresponses.yml.
The packaged defaults do not enable rephrasing on any of these names.
rephrase on the turn-error names is ignored, except that
utter_model_call_error honours it when the turn reaches the iteration limit.
utter_could_not_finish is not rephrased.
utter_hangup_goodbye honours rephrase when you set it.