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.
Log inSign up
Support
GuidesReference
GuidesReference
    • Core
      • Overview
    • Agents
      • Overview
      • AgentBase
      • AgentServer
      • Configuration
      • ContextBuilder
      • DataMap
      • FunctionResult
      • Helper Functions & Utilities
      • LiveWire
        • Agent
        • AgentSession
          • generateReply
          • interrupt
          • say
          • start
          • updateAgent
        • Infrastructure
        • Plugins
        • runApp
        • RunContext
        • Signals
        • tool / FunctionTool
      • PomBuilder
      • Prefabs
      • SkillBase
      • SkillManager
      • SkillRegistry
      • Skills
      • SwaigFunction
      • SwmlBuilder
      • SWMLService
    • RELAY
      • Overview
      • Actions
      • Call
      • Constants
      • Events
      • Message
      • RelayClient
      • RelayError
    • REST Client
      • Overview
      • Addresses
      • Calling
      • ChatResource
      • Compat
      • Datasphere
      • Fabric
      • ImportedNumbersResource
      • Logs
      • LookupResource
      • MFA
      • Number Groups
      • Phone Numbers
      • Project
      • PubSubResource
      • Queues
      • Recordings
      • Registry
      • RestClient
      • RestError
      • Short Codes
      • SIP Profile
      • Verified Callers
      • Video
LogoLogoSignalWire Docs
Log inSign up
Support
On this page
  • Signature
  • Parameters
  • Returns
  • Example
AgentsLiveWireAgentSession

say

|View as Markdown|Open in Claude|
Was this page helpful?
Edit this page
Previous

start

Next
Built with

Queue text to be spoken by the agent. Internally, this appends a prompt section to the underlying SignalWire AgentBase so the AI speaks the provided text.

Calls to say() made before start({ agent }) are buffered on an internal queue and replayed in order when the session starts (matches the Python SDK’s always-queue semantics). You do not need to await start before queuing greetings.

Signature

1say(text: string): void

Parameters

text
stringRequired

The text for the agent to speak.

Returns

void

Example

1const session = new AgentSession();
2await session.start({ agent });
3
4session.say('Your appointment is confirmed for tomorrow at 3 PM.');