Context | SignalWire

A Context represents a distinct conversation mode — like “sales”, “support”, or “billing” — within a ContextBuilder. Each context holds an ordered sequence of Step objects and configures its own prompt, system prompt, fillers, and navigation rules.

You obtain a Context by calling add_context() on a ContextBuilder or by calling get_context() to retrieve one that already exists.

Properties

name

strRequired

Unique context name. When using a single context inside a ContextBuilder, this must be "default".

Methods

add_bullets

Add a POM section with bullet points to the context prompt.

add_enter_filler

Add enter fillers for a specific language.

add_exit_filler

Add exit fillers for a specific language.

add_section

Add a POM section to the context prompt.

add_step

Add a new step to this context.

add_system_bullets

Add a POM section with bullets to the system prompt.

add_system_section

Add a POM section to the system prompt.

get_step

Get an existing step by name.

move_step

Move an existing step to a specific position in the step order.

remove_step

Remove a step from this context.

set_consolidate

Set whether to consolidate conversation history when entering this context.

set_enter_fillers

Set all enter fillers at once.

set_exit_fillers

Set all exit fillers at once.

set_full_reset

Set whether to completely replace the system prompt when entering this context.

set_history

Set the default history visibility mode for every step in this context.

set_initial_step

Set which step the context starts on when entered.

set_isolated

Set whether to truncate conversation history when entering this context.

set_post_prompt

Override the post-prompt text while this context is active.

set_prompt

Set the context’s prompt text directly.

set_system_prompt

Set a new system prompt that takes effect when this context is entered.

set_user_prompt

Inject a user message when entering this context.

set_valid_contexts

Set which contexts the agent can navigate to from this context.

set_valid_steps

Set which steps can be navigated to from any step in this context.

Example

from signalwire import AgentBase
agent = AgentBase(name="support-agent", route="/support")
contexts = agent.define_contexts()
main = contexts.add_context("default")
main.add_step("menu").set_text("Ask whether the caller needs sales or support.")
support = contexts.add_context("support")
# System prompt for this context
support.set_system_prompt("You are a patient technical support engineer.")
support.set_consolidate(True)
# Fillers for smooth transitions
support.add_enter_filler("en-US", [
    "Let me connect you with support...",
    "Transferring you now..."
])
support.add_exit_filler("en-US", [
    "Thank you for contacting support.",
    "Glad I could help."
])
# Navigation
support.set_valid_contexts(["default"])
# Steps
support.add_step("diagnose",
    task="Understand the customer's issue and gather relevant details.",
    criteria="Issue is clearly identified",
    functions=["lookup_account", "check_status"],
    valid_steps=["resolve"]
)
support.add_step("resolve",
    task="Resolve the issue or escalate to a specialist.",
    functions=["create_ticket", "transfer_call"],
    valid_steps=["farewell"]
)
support.add_step("farewell") \
    .set_text("Thank the caller and end the conversation.") \
    .set_functions("none") \
    .set_end(True)
agent.serve()