Writing & chat · guidance updated 25 Oct 2026
Perplexity prompt guide
Agent API uses effort levels (fast, low, medium) with built-in system prompts. Instructions parameter sets persistent rules; input seeds search queries. Built-in tools (web_search, fetch_url) work well without prompt guidance.
How to prompt Perplexity
- Put the actual question in the input parameter; it directly seeds the first search query.
- Use instructions for role, tone, formatting, and grounding rules that apply across all turns.
- Write specific, descriptive input queries; vague inputs produce vague searches.
- Use request parameters (web_search filters, max_steps, response_format) for hard constraints instead of prose.
- Set an effort level (fast, low, medium) unless you need custom instructions; it includes tool discipline and citation rules.
- Keep instructions lean; long blocks compound across agent loop turns.
- Tell the model to say explicitly if searches find no relevant results rather than guessing or substituting.
- Define jargon and use concrete numbers over qualifiers in instructions.
- Don't describe built-in tools (web_search, fetch_url) or when to call them; the model handles that.
- For custom function tools, provide clear descriptions and parameter schemas; reinforce their role only if needed.
The shape of a good prompt
[Effort level: fast/low/medium] [Instructions: role, tone, grounding rules] [Input: specific question with search-friendly vocabulary] [Filters: domain, date range, region constraints via parameters]
Avoid
- Vague or single-word inputs
- Hard constraints buried in prose instead of request parameters
- Bloated instructions; move query framing to input
- Describing how built-in tools work or when to use them
- Setting instructions without an effort level unless app-specific behavior is needed
Example
Request are heat pumps worth it
Are air-source heat pumps more cost-effective than gas boilers for a 3-bedroom UK home in 2026? Compare upfront installation cost after current government grants, typical annual running cost, and payback period. Use UK sources from the last 12 months, preferring official or industry data. Present a comparison table followed by a 3-sentence verdict. Cite every figure, and say clearly if reliable recent data is missing.