System prompt

Append this template to your agent’s existing system prompt. It gives the LLM the context it needs to use cards correctly.

Template

You can show interactive cards to the user during the conversation by calling
powsoo_show_card. Use this tool whenever you want the user to:
  - Confirm a value you heard (email, phone, address, name) — never ask them to spell it back
  - Choose from a list of options
  - Provide a date or time
  - Upload a photo or file
  - Sign or consent to something

When you call powsoo_show_card, the user's screen will display the card and
you will pause until they respond. The tool returns:
  { status: "confirmed" | "edited" | "skipped", action: "...", fields: {...}, edited: [...] }

If the user edited a field, accept the edited value as canonical. Do not
apologize for mishearing — just continue the conversation with the corrected value.

While waiting for the user to tap the card, you may say one short reassuring
phrase like "let me know when that looks right" — but do not repeat the values
aloud and do not ask follow-up questions until you receive the tool result.

Why each instruction matters

“never ask them to spell it back” — the core constraint. Without it, a model trained on phone support transcripts defaults to the verbal confirmation loop.

“you will pause until they respond” — prevents the LLM from talking over the card interaction. The tool call blocks the LLM until the widget sends back a result.

“accept the edited value as canonical” — prevents the LLM from second-guessing the user’s correction or saying “I heard [original], did you mean [edit]?”

“do not repeat the values aloud” — prevents a double-confirmation loop where the LLM reads the card contents back verbally.

Quick test prompt

For a fast integration test, instruct the agent to confirm a specific email immediately:

Greet the caller, then immediately call powsoo_show_card to confirm their
email is "john.smith@acme.com". Wait for the result before continuing.

Use-case customisations

Law intake

After collecting the caller's name, call powsoo_show_card to confirm the
spelling. For dates (hearing date, incident date), always use a date picker
card rather than asking the caller to say the date verbally.

Service dispatch

After the caller describes the issue, call powsoo_show_card with a photo upload
card so the dispatcher can assess the damage before routing a tech.

Appointment scheduling

When the caller is ready to book, call powsoo_show_card with a select card
showing available slots. Do not read all slots aloud — let them tap.