Luigit
repositories / pi-ext

pi-ext

bugabingas pi extensions

owned by admin

extensions/ask/README.md

Raw
Rendered preview
ask

ask

When requirements are unclear, give Pi a way to ask you focused questions instead of guessing.

ask lets Pi present up to four multiple-choice questions, one at a time, while it is working.

ask demo: the agent asks a structured question, the human picks an option and adds a note, the answer comes back verbatim

Use it in Pi

Nothing to invoke.

Ask Pi to clarify uncertainty as it works, for example: Ask me about any choices that affect the implementation.

Pi can use its ask_user_question tool to offer choices, accept a free-text answer, and continue with your decision.

Choose an option or choose Other (free text) to write your own answer.

You can add a note in the full-screen Pi interface.

Canceling a question stops that agent turn so Pi waits for new direction.

Interactive Pi sessions can show these questions.

Print and JSON modes receive an unavailable result unless a separate connected question provider handles the request.

During a native voice call

Questions remain in the ordinary Pi interface. Native voice does not claim questions, submit spoken answers or approve options on your behalf. Answer in Pi; the original executor tool continues in the same session.

Install through Installation.

<img src="assets/banner.svg" alt="ask" height="70">

# ask

When requirements are unclear, give Pi a way to ask you focused questions instead of guessing.

`ask` lets Pi present up to four multiple-choice questions, one at a time, while it is working.

![ask demo: the agent asks a structured question, the human picks an option and adds a note, the answer comes back verbatim](assets/demo.gif)

## Use it in Pi

Nothing to invoke.

Ask Pi to clarify uncertainty as it works, for example: `Ask me about any choices that affect the implementation.`

Pi can use its `ask_user_question` tool to offer choices, accept a free-text answer, and continue with your decision.

Choose an option or choose `Other (free text)` to write your own answer.

You can add a note in the full-screen Pi interface.

Canceling a question stops that agent turn so Pi waits for new direction.

Interactive Pi sessions can show these questions.

Print and JSON modes receive an unavailable result unless a separate connected question provider handles the request.

## During a native voice call

Questions remain in the ordinary Pi interface.
Native voice does not claim questions, submit spoken answers or approve options on your behalf.
Answer in Pi; the original executor tool continues in the same session.

Install through [Installation](../../README.md#install).

<!-- config:start -->
<!-- config:end -->