add_context | SignalWire

Create a new context and add it to the builder. Returns the Context object for method chaining.

Raises ValueError if the context name already exists or the maximum context limit (50) is exceeded.

A single-context agent must name its context "default" or validation will fail. Multi-context agents can use any names.

Parameters

name

strRequired

Unique context name. When using a single context, it must be named "default".

Returns

Context — The newly created context, ready for adding steps.

Examples

Single context

1 from signalwire import AgentBase
2 
3 agent = AgentBase(name="order-agent", route="/order")
4 
5 contexts = agent.define_contexts()
6 default = contexts.add_context("default")
7 default.add_step("greet").set_text("Greet the caller and ask how you can help.")
8 
9 agent.serve()

Multiple contexts

1 from signalwire import AgentBase
2 
3 agent = AgentBase(name="support-agent", route="/support")
4 
5 contexts = agent.define_contexts()
6 main = contexts.add_context("default")
7 sales = contexts.add_context("sales")
8 support = contexts.add_context("support")
9 
10 main.add_step("menu").set_text("Ask whether the caller needs sales or support.")
11 sales.add_step("qualify").set_text("Understand what product the caller wants.")
12 support.add_step("diagnose").set_text("Understand the customer's issue.")
13 
14 agent.serve()