PomBuilder | SignalWire

PomBuilder provides a fluent interface for creating structured prompts using the Prompt Object Model (POM). POM organizes prompt content into titled sections, subsections, and bullet lists — producing consistent, well-structured prompts that the AI can follow reliably.

Use PomBuilder when you need fine-grained control over prompt structure beyond what set_prompt_text() and prompt_add_section() on AgentBase provide. The builder can render to Markdown or XML format.

PomBuilder requires the signalwire-pom package. Install it with: pip install signalwire-pom

Methods

add_section

Add a new top-level section to the POM.

add_subsection

Add a subsection to an existing section.

add_to_section

Add content to an existing section.

from_sections

Create a PomBuilder from a list of section dictionaries.

get_section

Get a section by title for direct manipulation.

has_section

Check if a section with a given title exists.

render

Render the POM as Markdown or XML.

to_dict

Convert the POM to a list of section dictionaries.

to_json

Convert the POM to a JSON string.

Examples

Building a structured prompt

from signalwire.core.pom_builder import PomBuilder
pom = PomBuilder()
pom.add_section(
    "Role",
    body="You are a customer service representative for Acme Corp."
)
pom.add_section(
    "Guidelines",
    bullets=[
        "Always greet the customer by name when available",
        "Be concise and professional",
        "Never make promises about timelines you cannot keep"
    ]
)
pom.add_section(
    "Product Knowledge",
    body="You have access to the product catalog.",
    subsections=[
        {
            "title": "Pricing",
            "body": "Always quote current prices from the catalog."
        },
        {
            "title": "Returns",
            "body": "30-day return policy for all items."
        }
    ]
)
# Render as Markdown for use in a prompt
prompt_text = pom.render_markdown()
print(prompt_text)

Incremental construction

from signalwire.core.pom_builder import PomBuilder
pom = PomBuilder()
# Start with a basic section
pom.add_section("Capabilities", body="You can help with the following:")
# Add bullets incrementally as skills are loaded
pom.add_to_section("Capabilities", bullet="Weather lookups")
pom.add_to_section("Capabilities", bullet="Calendar scheduling")
pom.add_to_section("Capabilities", bullets=[
    "Order tracking",
    "Account management"
])
# Add a subsection
pom.add_subsection(
    "Capabilities",
    "Limitations",
    body="You cannot process payments directly."
)
print(pom.render_markdown())

Reconstructing from data

from signalwire.core.pom_builder import PomBuilder
# Rebuild a PomBuilder from serialized data
sections = [
    {"title": "Role", "body": "You are a helpful assistant."},
    {"title": "Rules", "bullets": ["Be concise", "Be accurate"]}
]
pom = PomBuilder.from_sections(sections)
xml_prompt = pom.render_xml()
print(xml_prompt)