Contexts

1
from signalwire_agents.core.contexts import ContextBuilder, Step

1
Step(name: str)  # Step name/identifier

1
def set_text(self, text: str) -> 'Step'

1
step = Step("greeting")
2
step.set_text("Welcome the caller and ask how you can help.")

1
def add_section(self, title: str, body: str) -> 'Step'

1
step = Step("collect_info")
2
step.add_section("Task", "Collect the caller's name and phone number.")
3
step.add_section("Guidelines", "Be polite and patient.")

1
def add_bullets(self, title: str, bullets: List[str]) -> 'Step'

1
step.add_bullets("Requirements", [
2
    "Get full legal name",
3
    "Verify phone number",
4
    "Confirm email address"
5
])

1
def set_step_criteria(self, criteria: str) -> 'Step'

1
step.set_step_criteria(
2
    "Step is complete when caller has provided their name and phone number."
3
)

1
def set_functions(self, functions: Union[str, List[str]]) -> 'Step'

1
## Disable all functions
2
step.set_functions("none")
3
4
## Allow specific functions
5
step.set_functions(["lookup_account", "verify_identity"])

1
def set_valid_steps(self, steps: List[str]) -> 'Step'

1
step.set_valid_steps(["confirmation", "error_handling"])

1
def set_valid_contexts(self, contexts: List[str]) -> 'Step'

1
step.set_valid_contexts(["support", "billing"])

1
def set_reset_system_prompt(self, system_prompt: str) -> 'Step'

1
def set_reset_user_prompt(self, user_prompt: str) -> 'Step'

1
def set_reset_consolidate(self, consolidate: bool) -> 'Step'

1
def set_reset_full_reset(self, full_reset: bool) -> 'Step'

1
ContextBuilder()

1
def add_context(
2
    self,
3
    name: str,           # Context name
4
    steps: List[Step]    # List of steps
5
) -> 'ContextBuilder'

1
builder = ContextBuilder()
2
builder.add_context("main", [
3
    Step("greeting").set_text("Greet the caller"),
4
    Step("collect").set_text("Collect information"),
5
    Step("confirm").set_text("Confirm details")
6
])

1
def set_default_context(self, name: str) -> 'ContextBuilder'

1
builder.set_default_context("main")

1
def build(self) -> Dict[str, Any]

1
from signalwire_agents import AgentBase
2
from signalwire_agents.core.contexts import ContextBuilder, Step
3
4
agent = AgentBase(name="workflow-agent")
5
6
## Create context builder
7
builder = ContextBuilder()
8
9
## Define steps for main context
10
greeting = (
11
    Step("greeting")
12
    .set_text("Welcome the caller and ask how you can help today.")
13
    .set_functions("none")
14
    .set_valid_steps(["collect_info"])
15
)
16
17
collect = (
18
    Step("collect_info")
19
    .add_section("Task", "Collect the caller's information.")
20
    .add_bullets("Required Information", [
21
        "Full name",
22
        "Account number",
23
        "Reason for calling"
24
    ])
25
    .set_step_criteria("Complete when all information is collected.")
26
    .set_functions(["lookup_account"])
27
    .set_valid_steps(["process", "error"])
28
)
29
30
process = (
31
    Step("process")
32
    .set_text("Process the caller's request based on collected information.")
33
    .set_valid_steps(["farewell"])
34
)
35
36
farewell = (
37
    Step("farewell")
38
    .set_text("Thank the caller and end the conversation.")
39
    .set_functions("none")
40
)
41
42
## Add context
43
builder.add_context("main", [greeting, collect, process, farewell])
44
builder.set_default_context("main")
45
46
## Apply to agent
47
agent.set_contexts(builder)

1
builder = ContextBuilder()
2
3
## Main menu context
4
main_steps = [
5
    Step("menu")
6
    .set_text("Present options: sales, support, or billing.")
7
    .set_valid_contexts(["sales", "support", "billing"])
8
]
9
builder.add_context("main", main_steps)
10
11
## Sales context
12
sales_steps = [
13
    Step("qualify")
14
    .set_text("Understand what product the caller is interested in.")
15
    .set_functions(["check_inventory", "get_pricing"])
16
    .set_valid_steps(["quote"]),
17
18
    Step("quote")
19
    .set_text("Provide pricing and availability.")
20
    .set_valid_steps(["close"]),
21
22
    Step("close")
23
    .set_text("Close the sale or schedule follow-up.")
24
    .set_valid_contexts(["main"])
25
]
26
builder.add_context("sales", sales_steps)
27
28
## Support context
29
support_steps = [
30
    Step("diagnose")
31
    .set_text("Understand the customer's issue.")
32
    .set_functions(["lookup_account", "check_status"])
33
    .set_valid_steps(["resolve"]),
34
35
    Step("resolve")
36
    .set_text("Resolve the issue or escalate.")
37
    .set_functions(["create_ticket", "transfer_call"])
38
    .set_valid_contexts(["main"])
39
]
40
builder.add_context("support", support_steps)
41
42
builder.set_default_context("main")