fabricatio-question

MIT

Interactive questioning extension for fabricatio agents. Generates LLM-driven selection prompts and presents them to users via terminal UI, enabling agents to gather structured feedback during planning and decision-making.

Installation

pip install fabricatio[question]
# or
uv pip install fabricatio[question]

For a full installation including all fabricatio components:

pip install fabricatio[full]

API

Capability: Questioning

Extends fabricatio_core.capabilities.propose.Propose. Mix into an agent to add interactive questioning.

Model: SelectionQuestion

A SketchedAble model representing an interactive selection prompt. Generated by the LLM from a user-provided topic.

Utilities

fabricatio_question.utils

Configuration

All options below are read through the fabricatio configuration chain (see the Configuration Guide). Set them under the [ext.question] table in fabricatio.toml, equivalently under [tool.fabricatio.ext.question] in pyproject.toml, or via FABRICATIO_EXT__QUESTION__<FIELD_UPPER> environment variables.

[ext.question]
selection_template = "built-in/selection"
selection_display_template = "built-in/selection_display"

Access at runtime: from fabricatio_question.config import question_config.

Usage

from fabricatio_question.capabilities.questioning import Questioning

class MyAgent(Questioning):
    ...

async def example():
    agent = MyAgent()

    # Single choice — returns a str
    choice: str = await agent.selection("Pick a database backend")

    # Multiple choices — returns list[str]
    picks: list[str] = await agent.selection("Select features to enable", k=3)

    # Get a formatted response string
    result: str = await agent.selection_string("Choose a deployment target")

from fabricatio_question.utils import ask_retain, ask_edit

# Let the user prune a candidate list
kept: list[str] = await ask_retain(["auth", "caching", "logging", "metrics"])

# Let the user edit a list of strings in-place
edited: list[str] = await ask_edit(["step 1", "step 2", "step 3"])

Dependencies

• fabricatio-core — core interfaces and capabilities
• questionary>=2.1.0 — interactive terminal prompts

License

MIT — see LICENSE