Skip to main content
Write instructions around a clear business outcome. The platform also supplies agent identity, enabled context, language configuration, and agent guidelines, so keep those settings consistent with your prompt. Prior calls are available only when their context is configured.

A useful structure

Keep frequently changing facts in [[Section name]] blocks. Type @ to insert an attached tool’s exact name. Keep long reference documents in a knowledge base and state when to search it. Instructions support up to 28,000 characters.

Example: showroom appointments

The following fictional example assumes you have created the two named tools. Replace the business facts and insert your actual tool names.
A prompt instruction alone is not a duplicate-prevention mechanism for your endpoint. Important external operations should also handle repeated requests correctly.

Test in stages

  1. Publish and run web tests with populated and missing variables. Inspect tool arguments and results in the transcript.
  2. Call your own phone to check recognition, pauses, interruptions, dates, and numbers under realistic audio conditions.
  3. Start with a small set of real calls, review analysis and tags, and expand after the outcomes are acceptable.
Include wrong numbers, refusals, unavailable appointments, tool failures, silence, and requests outside scope. Change one source of confusion at a time. Version notes make it easier to identify which change affected behavior. For substantially different jobs, consider a short triage agent that hands off to specialists. Test that design against your scenarios rather than assuming more agents always improve results.

Frequently asked questions

Either can be used. Configure spoken languages in General and test the instructions in the intended language.
No. Give explicit sources and fallback behavior, inspect tool outcomes, and evaluate representative calls.
Tests use the published version. Save and publish the new prompt.
Editable sections belong to each prompt; there is no shared section library in the editor.

See also