For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Ask AIPlaygroundLoginFree API Key
HomeAPI ReferenceVoice AgentSpeech-to-TextText-to-SpeechIntelligenceSelf-Hosted Deployments
HomeAPI ReferenceVoice AgentSpeech-to-TextText-to-SpeechIntelligenceSelf-Hosted Deployments
  • Get Started
    • Overview
    • Build a Voice Agent
    • Feature Overview
    • Template Apps
  • Configure
    • Overview
    • STT Models
    • LLM Models
    • TTS Models
    • Media Inputs & Outputs
    • Prompting Voice Agents
    • Multilingual Voice Agents
    • Maintaining Context
    • Reusable Agent Configurations
  • Build
    • Multi-Agent Architecture
  • Connect
  • Controls
      • Overview
      • Settings
      • Update Speak
      • Update Think
      • Update Prompt
      • Inject Agent
      • Inject User
      • Agent Keep Alive
  • Optimize
    • Voice Agent TTS Controls
    • Message Flow
    • Audio & Playback
    • Audio Preprocessing & Barge-In
    • Adaptive Echo Cancellation
  • Resources
    • SDKs
    • UI Components
    • API Reference
LogoLogo
Ask AIPlaygroundLoginFree API Key
On this page
  • Purpose
  • Example Payloads
ControlsInputs: Client Messages

Update Prompt

Send a message to update the system prompt of the agent.
Was this page helpful?
Previous

Inject Agent

Send a message to immediately trigger an Agent statement.
Next
Built with
Voice Agent

The UpdatePrompt message is a JSON message that you can use to update the system prompt of the agent.

Purpose

The UpdatePrompt message is a JSON message that allows you to update the system prompt of the agent. UpdatePrompt will add to – not replace – the current prompt. This flexibility enables real-time adjustments to the agent’s behavior, ensuring a more dynamic and responsive interaction tailored to the evolving needs of the conversation.

Prompt length is limited to 25,000 characters for managed LLMs and unlimited for BYO LLMs.

Example Payloads

To send the UpdatePrompt message, you need to send the following JSON message to the server:

JSON
1{
2 "type": "UpdatePrompt",
3 "prompt": "" // The new system prompt
4}

Upon receiving the UpdatePrompt message, the server will process all remaining audio data and return a PromptUpdated message.

JSON
1{
2 "type": "PromptUpdated"
3}