prompt_add_section

Add a new section to the prompt. Sections give the AI structured instructions that are easier to follow than a single block of text. Each section has a title and optional body text, bullet points, and subsections.

POM sections cannot be mixed with set_prompt_text() in the same agent. Use one approach or the other.

Parameters

title

strRequired

Section heading displayed to the AI.

body

str

Section body text.

bullets

list[str] | NoneDefaults to None

List of bullet point strings.

numbered

boolDefaults to False

Whether the section itself should be numbered.

numbered_bullets

boolDefaults to False

Whether bullet points should be numbered instead of bulleted.

subsections

list[dict[str, Any]] | NoneDefaults to None

List of subsection dictionaries, each with title, body, and optional bullets.

Returns

AgentBase — Returns self for method chaining.

Example

from signalwire import AgentBase
agent = AgentBase(name="support", route="/support")
agent.prompt_add_section("Role",
    body="You are a customer support agent for Acme Corp.")
agent.prompt_add_section("Guidelines", bullets=[
    "Always greet the caller by name if available",
    "Never share internal pricing details",
    "Escalate to a human if the caller asks"
])
agent.serve()