Prompt Expansion
Expand short prompts into detailed, actionable prompts
The --expand-prompt flag expands short prompts into detailed, actionable prompts using the PromptExpanderAgent.
Quick Start
praisonai "write a movie script in 3 lines" --expand-prompt
Usage
Basic Expansion
praisonai "write a movie script in 3 lines" --expand-promptExpected Output:
✨ Expanding prompt...
╭─ Original Prompt ────────────────────────────────────────────────────────────╮
│ write a movie script in 3 lines │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Expanded Prompt ────────────────────────────────────────────────────────────╮
│ Write a compelling 3-line movie script that includes: │
│ 1. A hook that establishes the setting and protagonist │
│ 2. A conflict or turning point that creates tension │
│ 3. A resolution or cliffhanger that leaves an impact │
│ │
│ Format: Each line should be a complete scene description with dialogue │
│ if appropriate. Use present tense and vivid imagery. │
╰──────────────────────────────────────────────────────────────────────────────╯With Verbose Output
praisonai "blog about AI" --expand-prompt -vWith Tools for Context
# Tools file
praisonai "latest AI trends" --expand-prompt --expand-tools tools.py
# Built-in SDK tool
praisonai "draft a coding plan" --expand-prompt --expand-tools "internet_search"
# praisonai-tools / entry-point plugin
praisonai "draft a coding plan" --expand-prompt --expand-tools "duckduckgo_search"Combine with Query Rewrite
praisonai "AI news" --query-rewrite --expand-promptKey Difference
| Flag | Purpose | Best For |
|---|---|---|
--query-rewrite | Optimizes queries for search/retrieval (RAG) | Search, RAG, retrieval |
--expand-prompt | Expands prompts for detailed task execution | Content creation, coding |
Expansion Strategies
| Strategy | Description |
|---|---|
| BASIC | Simple expansion with context |
| DETAILED | Comprehensive expansion with structure |
| STRUCTURED | Adds formatting and organization |
| CREATIVE | Adds creative elements and suggestions |
| AUTO | Automatically selects best strategy |
Examples
Content Creation
praisonai "blog about AI" --expand-promptExpanded to: “Write a comprehensive blog post about Artificial Intelligence that includes: an engaging introduction, key concepts explained for beginners, current trends and applications, future predictions, and a conclusion with actionable takeaways. Use headers, bullet points, and examples.”
Code Generation
praisonai "REST API" --expand-promptExpanded to: “Create a REST API with the following specifications: endpoints for CRUD operations, proper HTTP methods (GET, POST, PUT, DELETE), error handling with appropriate status codes, input validation, authentication middleware, and documentation comments.”
Research Task
praisonai "quantum computing" --expand-promptExpanded to: “Research quantum computing covering: fundamental principles (qubits, superposition, entanglement), current hardware implementations, major players and their approaches, practical applications, challenges and limitations, and future outlook.”
Choosing the expander’s model
The CLI’s --expand-prompt step honours the standard cascade — CLI flag wins, env vars next, gpt-4o-mini fallback last:
# Expander uses claude-3-5-sonnet-latest, matching the main agent
praisonai "write a movie script in 3 lines" --expand-prompt --llm claude-3-5-sonnet-latestTo keep a cheap expander regardless of the main model, pin it explicitly with OPENAI_MODEL_NAME=gpt-4o-mini while --llm drives the main agent — but the recommended pattern is running the expander and main agent on the same model.
Programmatic Usage
The model= kwarg on PromptExpanderAgent is unchanged — the cascade above applies only to the CLI path.
from praisonaiagents import PromptExpanderAgent, ExpandStrategy
# Basic usage
agent = PromptExpanderAgent()
result = agent.expand("write a movie script in 3 lines")
print(result.expanded_prompt)
# With specific strategy
result = agent.expand("blog about AI", strategy=ExpandStrategy.DETAILED)
# Available strategies: BASIC, DETAILED, STRUCTURED, CREATIVE, AUTOHow It Works
- Analyze: PromptExpanderAgent analyzes the short prompt
- Strategy: Selects appropriate expansion strategy
- Expand: Generates detailed, actionable prompt
- Execute: Uses expanded prompt for the task
Best Practices
| Do | Don’t |
|---|---|
| Use for vague or short prompts | Use for already detailed prompts |
Combine with --query-rewrite for research | Use alone for simple lookups |
Use --expand-tools for context | Skip context for complex topics |