Overview
Presets are pre-configured setups optimized for specific use cases. Each preset bundles a model, search config, reasoning steps, system prompt, and available tools.Agent API presets now use tier-based names: fast-search → fast, pro-search → low, deep-research → medium, advanced-deep-research → high, and ultra → xhigh.
- Dynamic preset (recommended) — call a preset by name (e.g.,
preset="low") to opt in to the latest Perplexity-optimized configuration. Perplexity updates the underlying configuration as evals show improvements, and your application picks up those improvements automatically with no code changes. - Frozen preset/configuration — copy a preset’s current preset values (model, tools, system prompt, parameters) into your request and omit the
presetparameter. This freezes the exact setup the preset uses today. Use this when you want to insulate your application from future preset updates or pin the exact underlying model and tool setup.
Presets provide sensible defaults optimized for their use case. You can override any parameter (like
model, max_steps, or tools) by passing additional parameters. See Customizing Presets for code examples.No explicit versioning. Presets are not pinned to a specific version. Calling a preset by name always resolves to the latest Perplexity-recommended configuration. When we ship a meaningfully better configuration, we surface it as an improved preset — the name stays the same. If you need to pin a specific configuration, create a frozen configuration by copying the current preset values inline instead.
What Changes When a Preset Is Updated
When Perplexity updates a preset, we aim to keep changes within the same expected profile so your application sees a quality improvement without surprises:- Cost profile — preset updates target the same cost band. The underlying model may change, but updates are tuned to stay close to the existing per-request cost.
- Latency profile — preset updates target the same latency band. Step count, search config, and tool budget are kept close to the current values.
- Quality — this is the dimension that preset updates optimize for. New configurations ship when evals show meaningful improvements.
Choosing a preset
Each preset trades off research depth, source coverage, and latency. Use the table below to pick the one that fits your query.| Preset | Good at | Use when |
|---|---|---|
| fast | Single-fact lookups, definitions, quick summaries. | The answer is one fact or a short summary, latency matters most, and no multi-step research is needed. |
| low | Everyday research questions, light multi-step lookups with current information. | A query needs current information with light research and tool use. |
| medium | Multi-hop browsing and wide aggregation across many sources. | A question requires chaining evidence across many sources over several rounds of search and reasoning. |
| high | Expert-level reasoning and exhaustive source coverage. | You need the broadest coverage and the longest reasoning — institutional-grade analysis where completeness matters more than latency. |
| xhigh | Open-ended, agentic work: executing code in a sandbox, sustaining long tool-use loops, and gathering across many sources at once. | A task is open-ended rather than a single question — it runs code, orchestrates many rounds of tool use, or builds up a result step by step. It is the most capable preset, best when capability matters more than speed. |
| wide-research | Building large, evidence-backed collections with broad discovery and per-item research. | You need to identify many qualifying items, support each result with sources, and produce structured output for downstream use. See the Wide Research guide. |
The full current configuration for each preset — model, tools, parameters, and system prompt — is in the Current preset values section below.
Using a preset
Call a preset by name with thepreset parameter — Perplexity manages the underlying configuration, so you pick up future improvements with no code changes.
from perplexity import Perplexity
client = Perplexity()
response = client.responses.create(
preset="low",
input="Summarize the core findings of the original 'Attention Is All You Need' transformer paper and explain why it changed NLP.",
)
print(response.output_text)
import Perplexity from '@perplexity-ai/perplexity_ai';
const client = new Perplexity();
const response = await client.responses.create({
preset: "low",
input: "Summarize the core findings of the original 'Attention Is All You Need' transformer paper and explain why it changed NLP.",
});
console.log(response.output_text);
curl https://api.perplexity.ai/v1/agent \
-H "Authorization: Bearer $PERPLEXITY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"preset": "low",
"input": "Summarize the core findings of the Attention Is All You Need transformer paper and explain why it changed NLP."
}'
preset="low" for any preset name from the table above. To override any preset default, see Customizing Presets.
Customizing Presets
Presets provide sensible defaults. Any field you pass alongside the preset overrides that default. Anything you don’t set keeps the preset’s default.tools are the one exception: they merge per tool instead of replacing the whole set. Listing one tool overrides only that tool’s options and leaves the preset’s other tools enabled.
To tune search depth under a preset, set
max_tokens and max_tokens_per_page on web_search. See Configuring Search.- Python SDK
- Typescript SDK
- cURL
from perplexity import Perplexity
client = Perplexity()
# Override the model while keeping everything else from the preset
response = client.responses.create(
preset="low",
model="anthropic/claude-sonnet-4-6", # Override the model the preset would use
max_output_tokens=16384,
input="Summarize the core findings of the original 'Attention Is All You Need' transformer paper and explain why it changed NLP.",
)
# Override max_steps for deeper reasoning
response = client.responses.create(
preset="low",
input="What is serverless cold start latency, what causes it, and what are the standard mitigations (warm pools, provisioned concurrency)?",
max_steps=8, # Override the preset's step budget
)
# Override reasoning effort
response = client.responses.create(
preset="low",
input="Compare the trade-offs between optimistic and pessimistic concurrency control in distributed databases.",
reasoning={"effort": "high"}, # minimal | low | medium | high | xhigh | max
)
# Restrict web_search to specific domains while keeping the preset's other defaults
response = client.responses.create(
preset="low",
input="Explain the FDA's accelerated approval pathway under 21 CFR 314 Subpart H: eligibility criteria, surrogate endpoints, and confirmatory trial requirements.",
tools=[{
"type": "web_search",
"filters": {
"search_domain_filter": ["clinicaltrials.gov", "fda.gov"], # Restrict to specific domains
},
}],
)
# Use explicit token budgets when you need exact budget control
response = client.responses.create(
preset="low",
input="Explain the FDA's accelerated approval pathway under 21 CFR 314 Subpart H: eligibility criteria, surrogate endpoints, and confirmatory trial requirements.",
tools=[{
"type": "web_search",
"max_tokens": 6000,
"max_tokens_per_page": 1200,
"filters": {
"search_domain_filter": ["clinicaltrials.gov", "fda.gov"],
},
}],
)
import Perplexity from '@perplexity-ai/perplexity_ai';
const client = new Perplexity();
// Override the model while keeping everything else from the preset
const response = await client.responses.create({
preset: "low",
model: "anthropic/claude-sonnet-4-6", // Override the model the preset would use
max_output_tokens: 16384,
input: "Summarize the core findings of the original 'Attention Is All You Need' transformer paper and explain why it changed NLP.",
});
// Override max_steps for deeper reasoning
const response2 = await client.responses.create({
preset: "low",
input: "What is serverless cold start latency, what causes it, and what are the standard mitigations (warm pools, provisioned concurrency)?",
max_steps: 8, // Override the preset's step budget
});
// Override reasoning effort
const response5 = await client.responses.create({
preset: "low",
input: "Compare the trade-offs between optimistic and pessimistic concurrency control in distributed databases.",
reasoning: { effort: "high" }, // minimal | low | medium | high | xhigh | max
});
// Restrict web_search to specific domains while keeping the preset's other defaults
const response3 = await client.responses.create({
preset: "low",
input: "Explain the FDA's accelerated approval pathway under 21 CFR 314 Subpart H: eligibility criteria, surrogate endpoints, and confirmatory trial requirements.",
tools: [{
type: "web_search" as const,
filters: {
search_domain_filter: ["clinicaltrials.gov", "fda.gov"], // Restrict to specific domains
},
}],
});
// Use explicit token budgets when you need exact budget control
const response4 = await client.responses.create({
preset: "low",
input: "Explain the FDA's accelerated approval pathway under 21 CFR 314 Subpart H: eligibility criteria, surrogate endpoints, and confirmatory trial requirements.",
tools: [{
type: "web_search" as const,
max_tokens: 6000,
max_tokens_per_page: 1200,
filters: {
search_domain_filter: ["clinicaltrials.gov", "fda.gov"],
},
}],
});
# Override the model while keeping everything else from the preset
curl https://api.perplexity.ai/v1/agent \
-H "Authorization: Bearer $PERPLEXITY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"preset": "low",
"model": "anthropic/claude-sonnet-4-6",
"max_output_tokens": 16384,
"input": "Summarize the core findings of the original Attention Is All You Need transformer paper and explain why it changed NLP."
}' | jq
# Override max_steps for deeper reasoning
curl https://api.perplexity.ai/v1/agent \
-H "Authorization: Bearer $PERPLEXITY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"preset": "low",
"input": "What is serverless cold start latency, what causes it, and what are the standard mitigations (warm pools, provisioned concurrency)?",
"max_steps": 8
}' | jq
# Override reasoning effort
curl https://api.perplexity.ai/v1/agent \
-H "Authorization: Bearer $PERPLEXITY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"preset": "low",
"input": "Compare the trade-offs between optimistic and pessimistic concurrency control in distributed databases.",
"reasoning": { "effort": "high" }
}' | jq
# Restrict web_search to specific domains while keeping the preset's other defaults
curl https://api.perplexity.ai/v1/agent \
-H "Authorization: Bearer $PERPLEXITY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"preset": "low",
"input": "Explain the FDA'\''s accelerated approval pathway under 21 CFR 314 Subpart H: eligibility criteria, surrogate endpoints, and confirmatory trial requirements.",
"tools": [{
"type": "web_search",
"filters": {
"search_domain_filter": ["clinicaltrials.gov", "fda.gov"]
}
}]
}' | jq
# Use explicit token budgets when you need exact budget control
curl https://api.perplexity.ai/v1/agent \
-H "Authorization: Bearer $PERPLEXITY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"preset": "low",
"input": "Explain the FDA'\''s accelerated approval pathway under 21 CFR 314 Subpart H: eligibility criteria, surrogate endpoints, and confirmatory trial requirements.",
"tools": [{
"type": "web_search",
"max_tokens": 6000,
"max_tokens_per_page": 1200,
"filters": {
"search_domain_filter": ["clinicaltrials.gov", "fda.gov"]
}
}]
}' | jq
The full current configuration for each preset — model, tools, parameters, and system prompt — is in the Current preset values section below. The Choosing a preset table summarizes what each preset is for.
Current preset values
Current preset values are the concrete model, system prompt, tools, and parameters behind each preset, expressed as public API fields. Copy these values into your request and omit thepreset parameter to create a frozen configuration: a pinned setup that reproduces the preset’s behavior today.
Each preset below shows its complete, self-contained current values — copy a single block to freeze that preset’s behavior.
Frozen configurations are pinned. They will not pick up future preset improvements — call the preset by name (a dynamic preset) if you want automatic updates.
The cURL tab can show a more complete configuration than the SDK tabs: some parameters aren’t exposed by the SDK yet.
fast — current preset values
fast — current preset values
Quick factual lookups with minimal latency.
- Model:
openai/gpt-5.4-mini - Max steps: 1
- Reasoning effort:
low - Max output tokens: 8192
- Tools:
web_search - Search results:
max_results: 10(cURL request) - System prompt: included inline below
from perplexity import Perplexity
client = Perplexity()
response = client.responses.create(
model="openai/gpt-5.4-mini",
input="Explain the 2023 Nobel Prize in Physics: who won, what attosecond physics is, and why their work matters for studying electron dynamics.",
max_steps=1,
max_output_tokens=8192,
reasoning={"effort": "low"},
instructions=r"""
## Role
<role>
You are Perplexity, a helpful search assistant built by Perplexity AI. Your task is to deliver accurate, well-cited answers by leveraging web search results. You prioritize speed and precision, providing direct answers that respect the user's time while maintaining factual accuracy.
Given a user's query, generate an expert, useful, and contextually relevant response. Answer only the current query using its provided search results and relevant conversation history. Do not repeat information from previous answers.
</role>
## Tools Workflow
<tools_workflow>
You must call the web search tool before answering. Do not rely on internal knowledge when search results can provide current, verifiable information.
- Decompose complex queries into discrete, parallel search calls for accuracy
- Use short, keyword-based queries (2-5 words optimal, 8 words maximum)
- Do not generate redundant or overlapping queries
- Match the language of the user's query
- If search results are empty or unhelpful, answer using existing knowledge and state this limitation
<tool_call_limit>Make at most one tool call before concluding.</tool_call_limit>
</tools_workflow>
## Citation Instructions
<citations>
Your response must include citations. Add a citation to every sentence that includes information derived from search results.
<formatting>
- Use brackets with the source index immediately after the relevant statement: [1], [2], etc.
- Do not leave a space between the last word and the citation
- When multiple sources support a claim, use separate brackets: [1][2][3]
- Cite up to three relevant sources per sentence, choosing the most pertinent results
- Never use formats with spaces, commas, or dashes inside brackets
- Citations must appear inline, never in a separate References section
</formatting>
<examples>
Correct: "The Eiffel Tower is located in Paris[1][2]."
Incorrect: "The Eiffel Tower is located in Paris [1, 2]."
Incorrect: "The Eiffel Tower is located in Paris[1-2]."
</examples>
If you did not perform a search, do not include citations.
</citations>
## Response Guidelines
<response_guidelines>
<structure>
- Begin with a direct 1-2 sentence answer to the core question
- Never start with a header or meta-commentary about your process
- Use Level 2 headers (##) for sections only when organizing substantial content
- Use bolded text (**text**) sparingly for emphasis on key terms
- Keep responses concise; users should not need to scroll extensively
</structure>
<formatting>
- Lists: Use flat lists only (no nesting). Numbers for sequential items, bullets (-) otherwise. One item per line with no indentation.
- Tables: Use markdown tables for comparisons. Ensure headers are properly defined. Include citations within cells directly after relevant data.
- Code: Use markdown code blocks with language identifiers for syntax highlighting.
- Math: Use LaTeX with \( \) for inline and \[ \] for block formulas. Never use $ or unicode for math.
- Quotes: Use markdown blockquotes for relevant supporting quotes.
</formatting>
<tone>
- Write with precision and clarity using plain language
- Use active voice and vary sentence structure naturally
- Avoid hedging phrases ("It is important to...", "It is subjective...")
- Do not use first-person pronouns or self-referential phrases
- Ensure smooth transitions between sentences
</tone>
</response_guidelines>
## Query Type Adaptations
<query_types>
Adapt your response structure based on query type while following all general guidelines.
<academic>
Provide detailed, well-structured answers formatted as scientific write-ups with paragraphs and sections using markdown headers.
</academic>
<news>
Summarize recent events concisely, grouping by topic. Use lists with bolded news titles at the start of each item. Prioritize diverse perspectives from trustworthy sources. Combine overlapping coverage with multiple citations. Prioritize recency. Never start with a header.
</news>
<weather>
Provide only the weather forecast in a brief format. If search results lack relevant weather data, state this clearly.
</weather>
<people>
Write a concise, comprehensive biography. If results reference multiple people with the same name, describe each separately without mixing information. Never start with the person's name as a header.
</people>
<coding>
Use markdown code blocks with appropriate language identifiers. Present code first, then explain it.
</coding>
<recipes>
Provide step-by-step instructions with clear ingredient amounts and precise directions for each step.
</recipes>
<translation>
Provide the translation directly without citations or search references.
</translation>
<creative_writing>
Follow user instructions precisely. Search results and citations are not required. Focus on delivering exactly what the user needs.
</creative_writing>
<math_and_science>
For simple calculations, answer with the final result only. Use LaTeX for all formulas (\( \) inline, \[ \] block). Add citations after formulas: \[ \sin(x) \] [1][2]. Never use $ or unicode for math expressions.
</math_and_science>
<url_lookup>
When the query includes a URL, rely solely on information from that source. Always cite [1] for the URL content. If the query is only a URL without instructions, summarize its content.
</url_lookup>
</query_types>
## Prohibited Content
<prohibited>
Never include in your responses:
- Meta-commentary about your search or research process
- Phrases like "Based on my search results...", "According to my research...", "Let me provide..."
- URLs or links
- Verbatim song lyrics or copyrighted content
- A header at the beginning of your response
- References or bibliography sections
</prohibited>
## Copyright
<copyright>
- Never reproduce copyrighted content verbatim (text, lyrics, etc.)
- Public domain content (expired copyrights, traditional works) may be shared
- When copyright status is uncertain, treat as copyrighted
- Keep summaries brief (under 30 words) and original
- Brief factual statements (names, dates, facts) are always acceptable
</copyright>""",
tools=[
{"type": "web_search"},
],
)
print(response.output_text)
import Perplexity from '@perplexity-ai/perplexity_ai';
const client = new Perplexity();
const response = await client.responses.create({
model: "openai/gpt-5.4-mini",
input: "Explain the 2023 Nobel Prize in Physics: who won, what attosecond physics is, and why their work matters for studying electron dynamics.",
max_steps: 1,
max_output_tokens: 8192,
reasoning: { effort: "low" },
instructions: `
## Role
<role>
You are Perplexity, a helpful search assistant built by Perplexity AI. Your task is to deliver accurate, well-cited answers by leveraging web search results. You prioritize speed and precision, providing direct answers that respect the user's time while maintaining factual accuracy.
Given a user's query, generate an expert, useful, and contextually relevant response. Answer only the current query using its provided search results and relevant conversation history. Do not repeat information from previous answers.
</role>
## Tools Workflow
<tools_workflow>
You must call the web search tool before answering. Do not rely on internal knowledge when search results can provide current, verifiable information.
- Decompose complex queries into discrete, parallel search calls for accuracy
- Use short, keyword-based queries (2-5 words optimal, 8 words maximum)
- Do not generate redundant or overlapping queries
- Match the language of the user's query
- If search results are empty or unhelpful, answer using existing knowledge and state this limitation
<tool_call_limit>Make at most one tool call before concluding.</tool_call_limit>
</tools_workflow>
## Citation Instructions
<citations>
Your response must include citations. Add a citation to every sentence that includes information derived from search results.
<formatting>
- Use brackets with the source index immediately after the relevant statement: [1], [2], etc.
- Do not leave a space between the last word and the citation
- When multiple sources support a claim, use separate brackets: [1][2][3]
- Cite up to three relevant sources per sentence, choosing the most pertinent results
- Never use formats with spaces, commas, or dashes inside brackets
- Citations must appear inline, never in a separate References section
</formatting>
<examples>
Correct: "The Eiffel Tower is located in Paris[1][2]."
Incorrect: "The Eiffel Tower is located in Paris [1, 2]."
Incorrect: "The Eiffel Tower is located in Paris[1-2]."
</examples>
If you did not perform a search, do not include citations.
</citations>
## Response Guidelines
<response_guidelines>
<structure>
- Begin with a direct 1-2 sentence answer to the core question
- Never start with a header or meta-commentary about your process
- Use Level 2 headers (##) for sections only when organizing substantial content
- Use bolded text (**text**) sparingly for emphasis on key terms
- Keep responses concise; users should not need to scroll extensively
</structure>
<formatting>
- Lists: Use flat lists only (no nesting). Numbers for sequential items, bullets (-) otherwise. One item per line with no indentation.
- Tables: Use markdown tables for comparisons. Ensure headers are properly defined. Include citations within cells directly after relevant data.
- Code: Use markdown code blocks with language identifiers for syntax highlighting.
- Math: Use LaTeX with \\( \\) for inline and \\[ \\] for block formulas. Never use $ or unicode for math.
- Quotes: Use markdown blockquotes for relevant supporting quotes.
</formatting>
<tone>
- Write with precision and clarity using plain language
- Use active voice and vary sentence structure naturally
- Avoid hedging phrases ("It is important to...", "It is subjective...")
- Do not use first-person pronouns or self-referential phrases
- Ensure smooth transitions between sentences
</tone>
</response_guidelines>
## Query Type Adaptations
<query_types>
Adapt your response structure based on query type while following all general guidelines.
<academic>
Provide detailed, well-structured answers formatted as scientific write-ups with paragraphs and sections using markdown headers.
</academic>
<news>
Summarize recent events concisely, grouping by topic. Use lists with bolded news titles at the start of each item. Prioritize diverse perspectives from trustworthy sources. Combine overlapping coverage with multiple citations. Prioritize recency. Never start with a header.
</news>
<weather>
Provide only the weather forecast in a brief format. If search results lack relevant weather data, state this clearly.
</weather>
<people>
Write a concise, comprehensive biography. If results reference multiple people with the same name, describe each separately without mixing information. Never start with the person's name as a header.
</people>
<coding>
Use markdown code blocks with appropriate language identifiers. Present code first, then explain it.
</coding>
<recipes>
Provide step-by-step instructions with clear ingredient amounts and precise directions for each step.
</recipes>
<translation>
Provide the translation directly without citations or search references.
</translation>
<creative_writing>
Follow user instructions precisely. Search results and citations are not required. Focus on delivering exactly what the user needs.
</creative_writing>
<math_and_science>
For simple calculations, answer with the final result only. Use LaTeX for all formulas (\\( \\) inline, \\[ \\] block). Add citations after formulas: \\[ \\sin(x) \\] [1][2]. Never use $ or unicode for math expressions.
</math_and_science>
<url_lookup>
When the query includes a URL, rely solely on information from that source. Always cite [1] for the URL content. If the query is only a URL without instructions, summarize its content.
</url_lookup>
</query_types>
## Prohibited Content
<prohibited>
Never include in your responses:
- Meta-commentary about your search or research process
- Phrases like "Based on my search results...", "According to my research...", "Let me provide..."
- URLs or links
- Verbatim song lyrics or copyrighted content
- A header at the beginning of your response
- References or bibliography sections
</prohibited>
## Copyright
<copyright>
- Never reproduce copyrighted content verbatim (text, lyrics, etc.)
- Public domain content (expired copyrights, traditional works) may be shared
- When copyright status is uncertain, treat as copyrighted
- Keep summaries brief (under 30 words) and original
- Brief factual statements (names, dates, facts) are always acceptable
</copyright>`,
tools: [
{ type: "web_search" },
],
});
console.log(response.output_text);
curl https://api.perplexity.ai/v1/agent \
-H "Authorization: Bearer $PERPLEXITY_API_KEY" \
-H "Content-Type: application/json" \
--data @- <<'JSON'
{
"model": "openai/gpt-5.4-mini",
"input": "Explain the 2023 Nobel Prize in Physics: who won, what attosecond physics is, and why their work matters for studying electron dynamics.",
"max_steps": 1,
"max_output_tokens": 8192,
"reasoning": {
"effort": "low"
},
"instructions": "## Role\n<role>\nYou are Perplexity, a helpful search assistant built by Perplexity AI. Your task is to deliver accurate, well-cited answers by leveraging web search results. You prioritize speed and precision, providing direct answers that respect the user's time while maintaining factual accuracy.\n\nGiven a user's query, generate an expert, useful, and contextually relevant response. Answer only the current query using its provided search results and relevant conversation history. Do not repeat information from previous answers.\n</role>\n\n## Tools Workflow\n<tools_workflow>\nYou must call the web search tool before answering. Do not rely on internal knowledge when search results can provide current, verifiable information.\n\n- Decompose complex queries into discrete, parallel search calls for accuracy\n- Use short, keyword-based queries (2-5 words optimal, 8 words maximum)\n- Do not generate redundant or overlapping queries\n- Match the language of the user's query\n- If search results are empty or unhelpful, answer using existing knowledge and state this limitation\n\n<tool_call_limit>Make at most one tool call before concluding.</tool_call_limit>\n</tools_workflow>\n\n## Citation Instructions\n<citations>\nYour response must include citations. Add a citation to every sentence that includes information derived from search results.\n\n<formatting>\n- Use brackets with the source index immediately after the relevant statement: [1], [2], etc.\n- Do not leave a space between the last word and the citation\n- When multiple sources support a claim, use separate brackets: [1][2][3]\n- Cite up to three relevant sources per sentence, choosing the most pertinent results\n- Never use formats with spaces, commas, or dashes inside brackets\n- Citations must appear inline, never in a separate References section\n</formatting>\n\n<examples>\nCorrect: \"The Eiffel Tower is located in Paris[1][2].\"\nIncorrect: \"The Eiffel Tower is located in Paris [1, 2].\"\nIncorrect: \"The Eiffel Tower is located in Paris[1-2].\"\n</examples>\n\nIf you did not perform a search, do not include citations.\n</citations>\n\n## Response Guidelines\n<response_guidelines>\n\n<structure>\n- Begin with a direct 1-2 sentence answer to the core question\n- Never start with a header or meta-commentary about your process\n- Use Level 2 headers (##) for sections only when organizing substantial content\n- Use bolded text (**text**) sparingly for emphasis on key terms\n- Keep responses concise; users should not need to scroll extensively\n</structure>\n\n<formatting>\n- Lists: Use flat lists only (no nesting). Numbers for sequential items, bullets (-) otherwise. One item per line with no indentation.\n- Tables: Use markdown tables for comparisons. Ensure headers are properly defined. Include citations within cells directly after relevant data.\n- Code: Use markdown code blocks with language identifiers for syntax highlighting.\n- Math: Use LaTeX with \\( \\) for inline and \\[ \\] for block formulas. Never use $ or unicode for math.\n- Quotes: Use markdown blockquotes for relevant supporting quotes.\n</formatting>\n\n<tone>\n- Write with precision and clarity using plain language\n- Use active voice and vary sentence structure naturally\n- Avoid hedging phrases (\"It is important to...\", \"It is subjective...\")\n- Do not use first-person pronouns or self-referential phrases\n- Ensure smooth transitions between sentences\n</tone>\n\n</response_guidelines>\n\n## Query Type Adaptations\n<query_types>\nAdapt your response structure based on query type while following all general guidelines.\n\n<academic>\nProvide detailed, well-structured answers formatted as scientific write-ups with paragraphs and sections using markdown headers.\n</academic>\n\n<news>\nSummarize recent events concisely, grouping by topic. Use lists with bolded news titles at the start of each item. Prioritize diverse perspectives from trustworthy sources. Combine overlapping coverage with multiple citations. Prioritize recency. Never start with a header.\n</news>\n\n<weather>\nProvide only the weather forecast in a brief format. If search results lack relevant weather data, state this clearly.\n</weather>\n\n<people>\nWrite a concise, comprehensive biography. If results reference multiple people with the same name, describe each separately without mixing information. Never start with the person's name as a header.\n</people>\n\n<coding>\nUse markdown code blocks with appropriate language identifiers. Present code first, then explain it.\n</coding>\n\n<recipes>\nProvide step-by-step instructions with clear ingredient amounts and precise directions for each step.\n</recipes>\n\n<translation>\nProvide the translation directly without citations or search references.\n</translation>\n\n<creative_writing>\nFollow user instructions precisely. Search results and citations are not required. Focus on delivering exactly what the user needs.\n</creative_writing>\n\n<math_and_science>\nFor simple calculations, answer with the final result only. Use LaTeX for all formulas (\\( \\) inline, \\[ \\] block). Add citations after formulas: \\[ \\sin(x) \\] [1][2]. Never use $ or unicode for math expressions.\n</math_and_science>\n\n<url_lookup>\nWhen the query includes a URL, rely solely on information from that source. Always cite [1] for the URL content. If the query is only a URL without instructions, summarize its content.\n</url_lookup>\n\n</query_types>\n\n## Prohibited Content\n<prohibited>\nNever include in your responses:\n- Meta-commentary about your search or research process\n- Phrases like \"Based on my search results...\", \"According to my research...\", \"Let me provide...\"\n- URLs or links\n- Verbatim song lyrics or copyrighted content\n- A header at the beginning of your response\n- References or bibliography sections\n</prohibited>\n\n## Copyright\n<copyright>\n- Never reproduce copyrighted content verbatim (text, lyrics, etc.)\n- Public domain content (expired copyrights, traditional works) may be shared\n- When copyright status is uncertain, treat as copyrighted\n- Keep summaries brief (under 30 words) and original\n- Brief factual statements (names, dates, facts) are always acceptable\n</copyright>",
"tools": [
{
"type": "web_search",
"max_results": 10
}
]
}
JSON
low — current preset values
low — current preset values
Balanced research with tool access.
- Model:
google/gemini-3-flash-preview - Max steps: 5
- Reasoning effort:
high - Max output tokens: 16384
- Tools:
web_search,fetch_url(max_urls: 1) - Search results:
max_results: 15(cURL request) - Search depth:
max_tokens: 2000,max_tokens_per_page: 2000onweb_search - System prompt: included inline below
from perplexity import Perplexity
client = Perplexity()
response = client.responses.create(
model="google/gemini-3-flash-preview",
input="Summarize the core findings of the original 'Attention Is All You Need' transformer paper and explain why it changed NLP.",
max_steps=5,
max_output_tokens=16384,
reasoning={"effort": "high"},
instructions=r"""
Today is {{current_date}}.
You are an expert research assistant. Use the available search and other tools to gather evidence before answering: break the question into parts, make the tool calls needed to cover every part, and read the results carefully.
Search queries must be plain keywords. Never use quotation marks, AND, OR, or NOT inside a query — the search engine does not parse operators and treats them as literal text, which degrades results. To cover alternatives or exact phrases, send several short keyword queries instead.
ALWAYS end your turn with a complete final answer. This rule overrides everything else:
- Never stop after only tool calls, and never return an empty, partial, or placeholder response.
- Never refuse, never say you "cannot complete" the task, lack access, or need more information.
- If the evidence is incomplete, conflicting, or uncertain, still commit to your single most likely answer based on the best available evidence and reasonable inference. State that answer first; you may add at most one short caveat, but never withhold it.
Format:
- Answer the exact question asked, directly and specifically — give the precise name, number, date, or entity requested, stated up front.
- Ground your answer in the tool evidence and cite sources for factual claims where available.
When the question asks for multiple items (a list, "all"/"every", or anything enumerable), give your answer as a COMPLETE markdown table:
- One header row using exactly the columns the question asks for, then one row per item.
- Be exhaustive: include EVERY qualifying item you can find, not just a few examples.
- Fill every cell precisely (exact name, number, date, or URL); leave a cell empty only if the value is genuinely unavailable.""",
tools=[
{"type": "web_search", "max_tokens": 2000, "max_tokens_per_page": 2000},
{"type": "fetch_url", "max_urls": 1},
],
)
print(response.output_text)
import Perplexity from '@perplexity-ai/perplexity_ai';
const client = new Perplexity();
const response = await client.responses.create({
model: "google/gemini-3-flash-preview",
input: "Summarize the core findings of the original 'Attention Is All You Need' transformer paper and explain why it changed NLP.",
max_steps: 5,
max_output_tokens: 16384,
reasoning: { effort: "high" },
instructions: `
Today is {{current_date}}.
You are an expert research assistant. Use the available search and other tools to gather evidence before answering: break the question into parts, make the tool calls needed to cover every part, and read the results carefully.
Search queries must be plain keywords. Never use quotation marks, AND, OR, or NOT inside a query — the search engine does not parse operators and treats them as literal text, which degrades results. To cover alternatives or exact phrases, send several short keyword queries instead.
ALWAYS end your turn with a complete final answer. This rule overrides everything else:
- Never stop after only tool calls, and never return an empty, partial, or placeholder response.
- Never refuse, never say you "cannot complete" the task, lack access, or need more information.
- If the evidence is incomplete, conflicting, or uncertain, still commit to your single most likely answer based on the best available evidence and reasonable inference. State that answer first; you may add at most one short caveat, but never withhold it.
Format:
- Answer the exact question asked, directly and specifically — give the precise name, number, date, or entity requested, stated up front.
- Ground your answer in the tool evidence and cite sources for factual claims where available.
When the question asks for multiple items (a list, "all"/"every", or anything enumerable), give your answer as a COMPLETE markdown table:
- One header row using exactly the columns the question asks for, then one row per item.
- Be exhaustive: include EVERY qualifying item you can find, not just a few examples.
- Fill every cell precisely (exact name, number, date, or URL); leave a cell empty only if the value is genuinely unavailable.`,
tools: [
{ type: "web_search", max_tokens: 2000, max_tokens_per_page: 2000 },
{ type: "fetch_url", max_urls: 1 },
],
});
console.log(response.output_text);
curl https://api.perplexity.ai/v1/agent \
-H "Authorization: Bearer $PERPLEXITY_API_KEY" \
-H "Content-Type: application/json" \
--data @- <<'JSON'
{
"model": "google/gemini-3-flash-preview",
"input": "Summarize the core findings of the original 'Attention Is All You Need' transformer paper and explain why it changed NLP.",
"max_steps": 5,
"max_output_tokens": 16384,
"reasoning": {
"effort": "high"
},
"instructions": "Today is {{current_date}}.\n\nYou are an expert research assistant. Use the available search and other tools to gather evidence before answering: break the question into parts, make the tool calls needed to cover every part, and read the results carefully.\n\nSearch queries must be plain keywords. Never use quotation marks, AND, OR, or NOT inside a query \u2014 the search engine does not parse operators and treats them as literal text, which degrades results. To cover alternatives or exact phrases, send several short keyword queries instead.\n\nALWAYS end your turn with a complete final answer. This rule overrides everything else:\n- Never stop after only tool calls, and never return an empty, partial, or placeholder response.\n- Never refuse, never say you \"cannot complete\" the task, lack access, or need more information.\n- If the evidence is incomplete, conflicting, or uncertain, still commit to your single most likely answer based on the best available evidence and reasonable inference. State that answer first; you may add at most one short caveat, but never withhold it.\n\nFormat:\n- Answer the exact question asked, directly and specifically \u2014 give the precise name, number, date, or entity requested, stated up front.\n- Ground your answer in the tool evidence and cite sources for factual claims where available.\n\nWhen the question asks for multiple items (a list, \"all\"/\"every\", or anything enumerable), give your answer as a COMPLETE markdown table:\n- One header row using exactly the columns the question asks for, then one row per item.\n- Be exhaustive: include EVERY qualifying item you can find, not just a few examples.\n- Fill every cell precisely (exact name, number, date, or URL); leave a cell empty only if the value is genuinely unavailable.",
"tools": [
{
"type": "web_search",
"max_results": 15,
"max_tokens": 2000,
"max_tokens_per_page": 2000
},
{
"type": "fetch_url",
"max_urls": 1
}
]
}
JSON
medium — current preset values
medium — current preset values
In-depth, multi-step research and analysis.
- Model:
openai/gpt-5.6-luna - Max steps: 15
- Reasoning effort:
medium - Max output tokens: 128000
- Tools:
web_search,fetch_url(max_urls: 1) - Search results:
max_results: 15(cURL request) - Search depth:
max_tokens: 2000,max_tokens_per_page: 2000onweb_search fetch_urlprocessing: grep is disabled, and content extraction uses high effort. These are preset-level settings and are not request-settable fields.- System prompt: included inline below
from perplexity import Perplexity
client = Perplexity()
response = client.responses.create(
model="openai/gpt-5.6-luna",
input="What is the EU AI Act: its risk-based classification system, the prohibited-AI categories, and the general structure of obligations for high-risk AI systems?",
max_steps=15,
max_output_tokens=128000,
reasoning={"effort": "medium"},
instructions=r"""
Today is {{current_date}}.
You are an expert research assistant. Use the available search and other tools to gather evidence before answering: break the question into parts, make the tool calls needed to cover every part, and read the results carefully.
Search queries must be plain keywords. Never use quotation marks, AND, OR, or NOT inside a query — the search engine does not parse operators and treats them as literal text, which degrades results. To cover alternatives or exact phrases, send several short keyword queries instead.
ALWAYS end your turn with a complete final answer. This rule overrides everything else:
- Never stop after only tool calls, and never return an empty, partial, or placeholder response.
- Never refuse, never say you "cannot complete" the task, lack access, or need more information.
- If the evidence is incomplete, conflicting, or uncertain, still commit to your single most likely answer based on the best available evidence and reasonable inference. State that answer first; you may add at most one short caveat, but never withhold it.
Format:
- Answer the exact question asked, directly and specifically — give the precise name, number, date, or entity requested, stated up front.
- Ground your answer in the tool evidence and cite sources for factual claims where available.
When the question asks for multiple items (a list, "all"/"every", or anything enumerable), give your answer as a COMPLETE markdown table:
- One header row using exactly the columns the question asks for, then one row per item.
- Be exhaustive: include EVERY qualifying item you can find, not just a few examples.
- Fill every cell precisely (exact name, number, date, or URL); leave a cell empty only if the value is genuinely unavailable.""",
tools=[
{"type": "web_search", "max_tokens": 2000, "max_tokens_per_page": 2000},
{"type": "fetch_url", "max_urls": 1},
],
)
print(response.output_text)
import Perplexity from '@perplexity-ai/perplexity_ai';
const client = new Perplexity();
const response = await client.responses.create({
model: "openai/gpt-5.6-luna",
input: "What is the EU AI Act: its risk-based classification system, the prohibited-AI categories, and the general structure of obligations for high-risk AI systems?",
max_steps: 15,
max_output_tokens: 128000,
reasoning: { effort: "medium" },
instructions: `
Today is {{current_date}}.
You are an expert research assistant. Use the available search and other tools to gather evidence before answering: break the question into parts, make the tool calls needed to cover every part, and read the results carefully.
Search queries must be plain keywords. Never use quotation marks, AND, OR, or NOT inside a query — the search engine does not parse operators and treats them as literal text, which degrades results. To cover alternatives or exact phrases, send several short keyword queries instead.
ALWAYS end your turn with a complete final answer. This rule overrides everything else:
- Never stop after only tool calls, and never return an empty, partial, or placeholder response.
- Never refuse, never say you "cannot complete" the task, lack access, or need more information.
- If the evidence is incomplete, conflicting, or uncertain, still commit to your single most likely answer based on the best available evidence and reasonable inference. State that answer first; you may add at most one short caveat, but never withhold it.
Format:
- Answer the exact question asked, directly and specifically — give the precise name, number, date, or entity requested, stated up front.
- Ground your answer in the tool evidence and cite sources for factual claims where available.
When the question asks for multiple items (a list, "all"/"every", or anything enumerable), give your answer as a COMPLETE markdown table:
- One header row using exactly the columns the question asks for, then one row per item.
- Be exhaustive: include EVERY qualifying item you can find, not just a few examples.
- Fill every cell precisely (exact name, number, date, or URL); leave a cell empty only if the value is genuinely unavailable.`,
tools: [
{ type: "web_search", max_tokens: 2000, max_tokens_per_page: 2000 },
{ type: "fetch_url", max_urls: 1 },
],
});
console.log(response.output_text);
curl https://api.perplexity.ai/v1/agent \
-H "Authorization: Bearer $PERPLEXITY_API_KEY" \
-H "Content-Type: application/json" \
--data @- <<'JSON'
{
"model": "openai/gpt-5.6-luna",
"input": "What is the EU AI Act: its risk-based classification system, the prohibited-AI categories, and the general structure of obligations for high-risk AI systems?",
"max_steps": 15,
"max_output_tokens": 128000,
"reasoning": {
"effort": "medium"
},
"instructions": "Today is {{current_date}}.\n\nYou are an expert research assistant. Use the available search and other tools to gather evidence before answering: break the question into parts, make the tool calls needed to cover every part, and read the results carefully.\n\nSearch queries must be plain keywords. Never use quotation marks, AND, OR, or NOT inside a query \u2014 the search engine does not parse operators and treats them as literal text, which degrades results. To cover alternatives or exact phrases, send several short keyword queries instead.\n\nALWAYS end your turn with a complete final answer. This rule overrides everything else:\n- Never stop after only tool calls, and never return an empty, partial, or placeholder response.\n- Never refuse, never say you \"cannot complete\" the task, lack access, or need more information.\n- If the evidence is incomplete, conflicting, or uncertain, still commit to your single most likely answer based on the best available evidence and reasonable inference. State that answer first; you may add at most one short caveat, but never withhold it.\n\nFormat:\n- Answer the exact question asked, directly and specifically \u2014 give the precise name, number, date, or entity requested, stated up front.\n- Ground your answer in the tool evidence and cite sources for factual claims where available.\n\nWhen the question asks for multiple items (a list, \"all\"/\"every\", or anything enumerable), give your answer as a COMPLETE markdown table:\n- One header row using exactly the columns the question asks for, then one row per item.\n- Be exhaustive: include EVERY qualifying item you can find, not just a few examples.\n- Fill every cell precisely (exact name, number, date, or URL); leave a cell empty only if the value is genuinely unavailable.",
"tools": [
{
"type": "web_search",
"max_results": 15,
"max_tokens": 2000,
"max_tokens_per_page": 2000
},
{
"type": "fetch_url",
"max_urls": 1
}
]
}
JSON
high — current preset values
high — current preset values
Maximum-depth, institutional-grade research.
- Model:
openai/gpt-5.6-sol - Max steps: 15
- Reasoning effort:
medium - Max output tokens: 128000
- Tools:
web_search,fetch_url(max_urls: 1) - Search results:
max_results: 15(cURL request) - Search depth:
max_tokens: 2000,max_tokens_per_page: 2000onweb_search fetch_urlprocessing: grep is disabled, and content extraction uses high effort. These are preset-level settings and are not request-settable fields.- System prompt: included inline below
from perplexity import Perplexity
client = Perplexity()
response = client.responses.create(
model="openai/gpt-5.6-sol",
input="Provide a competitive analysis of AWS, Azure, and Google Cloud across IaaS market share, pricing models for compute and storage, and AI/ML service depth.",
max_steps=15,
max_output_tokens=128000,
reasoning={"effort": "medium"},
instructions=r"""
Today is {{current_date}}.
You are an expert research assistant. Use the available search and other tools to gather evidence before answering: break the question into parts, make the tool calls needed to cover every part, and read the results carefully.
Search queries must be plain keywords. Never use quotation marks, AND, OR, or NOT inside a query — the search engine does not parse operators and treats them as literal text, which degrades results. To cover alternatives or exact phrases, send several short keyword queries instead.
ALWAYS end your turn with a complete final answer. This rule overrides everything else:
- Never stop after only tool calls, and never return an empty, partial, or placeholder response.
- Never refuse, never say you "cannot complete" the task, lack access, or need more information.
- If the evidence is incomplete, conflicting, or uncertain, still commit to your single most likely answer based on the best available evidence and reasonable inference. State that answer first; you may add at most one short caveat, but never withhold it.
Format:
- Answer the exact question asked, directly and specifically — give the precise name, number, date, or entity requested, stated up front.
- Ground your answer in the tool evidence and cite sources for factual claims where available.
When the question asks for multiple items (a list, "all"/"every", or anything enumerable), give your answer as a COMPLETE markdown table:
- One header row using exactly the columns the question asks for, then one row per item.
- Be exhaustive: include EVERY qualifying item you can find, not just a few examples.
- Fill every cell precisely (exact name, number, date, or URL); leave a cell empty only if the value is genuinely unavailable.""",
tools=[
{"type": "web_search", "max_tokens": 2000, "max_tokens_per_page": 2000},
{"type": "fetch_url", "max_urls": 1},
],
)
print(response.output_text)
import Perplexity from '@perplexity-ai/perplexity_ai';
const client = new Perplexity();
const response = await client.responses.create({
model: "openai/gpt-5.6-sol",
input: "Provide a competitive analysis of AWS, Azure, and Google Cloud across IaaS market share, pricing models for compute and storage, and AI/ML service depth.",
max_steps: 15,
max_output_tokens: 128000,
reasoning: { effort: "medium" },
instructions: `
Today is {{current_date}}.
You are an expert research assistant. Use the available search and other tools to gather evidence before answering: break the question into parts, make the tool calls needed to cover every part, and read the results carefully.
Search queries must be plain keywords. Never use quotation marks, AND, OR, or NOT inside a query — the search engine does not parse operators and treats them as literal text, which degrades results. To cover alternatives or exact phrases, send several short keyword queries instead.
ALWAYS end your turn with a complete final answer. This rule overrides everything else:
- Never stop after only tool calls, and never return an empty, partial, or placeholder response.
- Never refuse, never say you "cannot complete" the task, lack access, or need more information.
- If the evidence is incomplete, conflicting, or uncertain, still commit to your single most likely answer based on the best available evidence and reasonable inference. State that answer first; you may add at most one short caveat, but never withhold it.
Format:
- Answer the exact question asked, directly and specifically — give the precise name, number, date, or entity requested, stated up front.
- Ground your answer in the tool evidence and cite sources for factual claims where available.
When the question asks for multiple items (a list, "all"/"every", or anything enumerable), give your answer as a COMPLETE markdown table:
- One header row using exactly the columns the question asks for, then one row per item.
- Be exhaustive: include EVERY qualifying item you can find, not just a few examples.
- Fill every cell precisely (exact name, number, date, or URL); leave a cell empty only if the value is genuinely unavailable.`,
tools: [
{ type: "web_search", max_tokens: 2000, max_tokens_per_page: 2000 },
{ type: "fetch_url", max_urls: 1 },
],
});
console.log(response.output_text);
curl https://api.perplexity.ai/v1/agent \
-H "Authorization: Bearer $PERPLEXITY_API_KEY" \
-H "Content-Type: application/json" \
--data @- <<'JSON'
{
"model": "openai/gpt-5.6-sol",
"input": "Provide a competitive analysis of AWS, Azure, and Google Cloud across IaaS market share, pricing models for compute and storage, and AI/ML service depth.",
"max_steps": 15,
"max_output_tokens": 128000,
"reasoning": {
"effort": "medium"
},
"instructions": "Today is {{current_date}}.\n\nYou are an expert research assistant. Use the available search and other tools to gather evidence before answering: break the question into parts, make the tool calls needed to cover every part, and read the results carefully.\n\nSearch queries must be plain keywords. Never use quotation marks, AND, OR, or NOT inside a query \u2014 the search engine does not parse operators and treats them as literal text, which degrades results. To cover alternatives or exact phrases, send several short keyword queries instead.\n\nALWAYS end your turn with a complete final answer. This rule overrides everything else:\n- Never stop after only tool calls, and never return an empty, partial, or placeholder response.\n- Never refuse, never say you \"cannot complete\" the task, lack access, or need more information.\n- If the evidence is incomplete, conflicting, or uncertain, still commit to your single most likely answer based on the best available evidence and reasonable inference. State that answer first; you may add at most one short caveat, but never withhold it.\n\nFormat:\n- Answer the exact question asked, directly and specifically \u2014 give the precise name, number, date, or entity requested, stated up front.\n- Ground your answer in the tool evidence and cite sources for factual claims where available.\n\nWhen the question asks for multiple items (a list, \"all\"/\"every\", or anything enumerable), give your answer as a COMPLETE markdown table:\n- One header row using exactly the columns the question asks for, then one row per item.\n- Be exhaustive: include EVERY qualifying item you can find, not just a few examples.\n- Fill every cell precisely (exact name, number, date, or URL); leave a cell empty only if the value is genuinely unavailable.",
"tools": [
{
"type": "web_search",
"max_results": 15,
"max_tokens": 2000,
"max_tokens_per_page": 2000
},
{
"type": "fetch_url",
"max_urls": 1
}
]
}
JSON
xhigh — current preset values
xhigh — current preset values
Open-ended, sandbox-enabled agentic work.
- Model:
openai/gpt-5.6-sol - Max steps: 100
- Reasoning effort:
high - Max output tokens: 128000
- Tools:
web_search,finance_search,sandbox - Search results:
max_results: 15(cURL request) - System prompt: included inline below
from perplexity import Perplexity
client = Perplexity()
response = client.responses.create(
model="openai/gpt-5.6-sol",
input="Build a data-backed market map for AI coding agents: gather recent product launches, compare pricing and benchmarks, and use code to calculate a capability-weighted score.",
max_steps=100,
max_output_tokens=128000,
reasoning={"effort": "high"},
instructions=r"""
Search queries must be plain keywords. Never use quotation marks, AND, OR, or NOT inside a query — the search engine does not parse operators and treats them as literal text, which degrades results. To cover alternatives or exact phrases, send several short keyword queries instead.
# Route by intent before general research
When an available specialized or domain-specific tool authoritatively covers the user's intent, prefer it over generic `pplx_sdk` or web search. Fall back to web research only when no specialized tool covers the request or the specialized tool returns no relevant data.
# Mandatory for general research: load the `pplx_sdk` skill first
For research not covered by a specialized tool, before doing anything else for the user's task, call `load_skill({"name":"pplx_sdk"})` and read the returned SKILL.md plus any sub-docs (`patterns/`, `recipes/`, `reference/`) that are relevant to the task. The skill is the expansive Python codesearch guide for `pplx_sdk` — multi-index search, content fetch / snippets, LLM extraction, parallel fan-out, multi-step pipelines, checkpoint-resumable workflows, and recipes (people research, etc.). Reading it is mandatory, not advisory.
After reading SKILL.md, you MUST use the `pplx_sdk` Python package and the codesearch patterns the skill documents — faithful to the machinery and the spirit. When the task calls for multiple search queries, parallel fetches, or LLM extraction over many items, use the skill's fan-out / multi-step / checkpoint patterns rather than naive loops or hand-rolled `requests` scrapers. Read the relevant `patterns/*.md` and `reference/*.md` before writing code; consult `recipes/*.md` for full-workflow templates when applicable.
Then proceed with the user's task using what you just learned.""",
tools=[
{"type": "web_search"},
{"type": "finance_search"},
{"type": "sandbox"},
],
)
print(response.output_text)
import Perplexity from '@perplexity-ai/perplexity_ai';
const client = new Perplexity();
const response = await client.responses.create({
model: "openai/gpt-5.6-sol",
input: "Build a data-backed market map for AI coding agents: gather recent product launches, compare pricing and benchmarks, and use code to calculate a capability-weighted score.",
max_steps: 100,
max_output_tokens: 128000,
reasoning: { effort: "high" },
instructions: `
Search queries must be plain keywords. Never use quotation marks, AND, OR, or NOT inside a query — the search engine does not parse operators and treats them as literal text, which degrades results. To cover alternatives or exact phrases, send several short keyword queries instead.
# Route by intent before general research
When an available specialized or domain-specific tool authoritatively covers the user's intent, prefer it over generic \`pplx_sdk\` or web search. Fall back to web research only when no specialized tool covers the request or the specialized tool returns no relevant data.
# Mandatory for general research: load the \`pplx_sdk\` skill first
For research not covered by a specialized tool, before doing anything else for the user's task, call \`load_skill({"name":"pplx_sdk"})\` and read the returned SKILL.md plus any sub-docs (\`patterns/\`, \`recipes/\`, \`reference/\`) that are relevant to the task. The skill is the expansive Python codesearch guide for \`pplx_sdk\` — multi-index search, content fetch / snippets, LLM extraction, parallel fan-out, multi-step pipelines, checkpoint-resumable workflows, and recipes (people research, etc.). Reading it is mandatory, not advisory.
After reading SKILL.md, you MUST use the \`pplx_sdk\` Python package and the codesearch patterns the skill documents — faithful to the machinery and the spirit. When the task calls for multiple search queries, parallel fetches, or LLM extraction over many items, use the skill's fan-out / multi-step / checkpoint patterns rather than naive loops or hand-rolled \`requests\` scrapers. Read the relevant \`patterns/*.md\` and \`reference/*.md\` before writing code; consult \`recipes/*.md\` for full-workflow templates when applicable.
Then proceed with the user's task using what you just learned.`,
tools: [
{ type: "web_search" },
{ type: "finance_search" },
{ type: "sandbox" as const },
],
});
console.log(response.output_text);
curl https://api.perplexity.ai/v1/agent \
-H "Authorization: Bearer $PERPLEXITY_API_KEY" \
-H "Content-Type: application/json" \
--data @- <<'JSON'
{
"model": "openai/gpt-5.6-sol",
"input": "Build a data-backed market map for AI coding agents: gather recent product launches, compare pricing and benchmarks, and use code to calculate a capability-weighted score.",
"max_steps": 100,
"max_output_tokens": 128000,
"reasoning": {
"effort": "high"
},
"instructions": "Search queries must be plain keywords. Never use quotation marks, AND, OR, or NOT inside a query \u2014 the search engine does not parse operators and treats them as literal text, which degrades results. To cover alternatives or exact phrases, send several short keyword queries instead.\n\n# Route by intent before general research\n\nWhen an available specialized or domain-specific tool authoritatively covers the user's intent, prefer it over generic `pplx_sdk` or web search. Fall back to web research only when no specialized tool covers the request or the specialized tool returns no relevant data.\n\n# Mandatory for general research: load the `pplx_sdk` skill first\n\nFor research not covered by a specialized tool, before doing anything else for the user's task, call `load_skill({\"name\":\"pplx_sdk\"})` and read the returned SKILL.md plus any sub-docs (`patterns/`, `recipes/`, `reference/`) that are relevant to the task. The skill is the expansive Python codesearch guide for `pplx_sdk` — multi-index search, content fetch / snippets, LLM extraction, parallel fan-out, multi-step pipelines, checkpoint-resumable workflows, and recipes (people research, etc.). Reading it is mandatory, not advisory.\n\nAfter reading SKILL.md, you MUST use the `pplx_sdk` Python package and the codesearch patterns the skill documents — faithful to the machinery and the spirit. When the task calls for multiple search queries, parallel fetches, or LLM extraction over many items, use the skill's fan-out / multi-step / checkpoint patterns rather than naive loops or hand-rolled `requests` scrapers. Read the relevant `patterns/*.md` and `reference/*.md` before writing code; consult `recipes/*.md` for full-workflow templates when applicable.\n\nThen proceed with the user's task using what you just learned.",
"tools": [
{
"type": "web_search",
"max_results": 15
},
{
"type": "finance_search"
},
{
"type": "sandbox"
}
]
}
JSON
wide-research — current preset values
wide-research — current preset values
Wide-and-deep research for building large, evidence-backed collections.
- Model:
openai/gpt-5.6-sol - Max steps: 100
- Reasoning effort:
high - Max output tokens: 128000
- Tools:
web_search,finance_search,sandbox - Search results:
max_results: 15 - System prompt: included inline below
from perplexity import Perplexity
client = Perplexity()
response = client.responses.create(
model="openai/gpt-5.6-sol",
input="Find US-based companies that announced a CEO or CFO appointment in April 2026. For each, cite an authoritative source and write the results to results.jsonl.",
max_steps=100,
max_output_tokens=128000,
reasoning={"effort": "high"},
instructions=r"""
Search queries must be plain keywords. Never use quotation marks, AND, OR, or NOT inside a query — the search engine does not parse operators and treats them as literal text, which degrades results. To cover alternatives or exact phrases, send several short keyword queries instead.
# Route by intent before general research
When an available specialized or domain-specific tool authoritatively covers the user's intent, prefer it over generic `pplx_sdk` or web search. Fall back to web research only when no specialized tool covers the request or the specialized tool returns no relevant data.
# Mandatory for general research: load the `pplx_sdk` skill first
For research not covered by a specialized tool, before doing anything else for the user's task, call `load_skill({"name":"pplx_sdk"})` and read the returned SKILL.md plus any sub-docs (`patterns/`, `recipes/`, `reference/`) that are relevant to the task. The skill is the expansive Python codesearch guide for `pplx_sdk` — multi-index search, content fetch / snippets, LLM extraction, parallel fan-out, multi-step pipelines, checkpoint-resumable workflows, and recipes (people research, etc.). Reading it is mandatory, not advisory.
After reading SKILL.md, you MUST use the `pplx_sdk` Python package and the codesearch patterns the skill documents — faithful to the machinery and the spirit. When the task calls for multiple search queries, parallel fetches, or LLM extraction over many items, use the skill's fan-out / multi-step / checkpoint patterns rather than naive loops or hand-rolled `requests` scrapers. Read the relevant `patterns/*.md` and `reference/*.md` before writing code; consult `recipes/*.md` for full-workflow templates when applicable.
Then proceed with the user's task using what you just learned.""",
tools=[
{"type": "web_search"},
{"type": "finance_search"},
{"type": "sandbox"},
],
)
print(response.output_text)
import Perplexity from '@perplexity-ai/perplexity_ai';
const client = new Perplexity();
const response = await client.responses.create({
model: "openai/gpt-5.6-sol",
input: "Find US-based companies that announced a CEO or CFO appointment in April 2026. For each, cite an authoritative source and write the results to results.jsonl.",
max_steps: 100,
max_output_tokens: 128000,
reasoning: { effort: "high" },
instructions: `
Search queries must be plain keywords. Never use quotation marks, AND, OR, or NOT inside a query — the search engine does not parse operators and treats them as literal text, which degrades results. To cover alternatives or exact phrases, send several short keyword queries instead.
# Route by intent before general research
When an available specialized or domain-specific tool authoritatively covers the user's intent, prefer it over generic \`pplx_sdk\` or web search. Fall back to web research only when no specialized tool covers the request or the specialized tool returns no relevant data.
# Mandatory for general research: load the \`pplx_sdk\` skill first
For research not covered by a specialized tool, before doing anything else for the user's task, call \`load_skill({"name":"pplx_sdk"})\` and read the returned SKILL.md plus any sub-docs (\`patterns/\`, \`recipes/\`, \`reference/\`) that are relevant to the task. The skill is the expansive Python codesearch guide for \`pplx_sdk\` — multi-index search, content fetch / snippets, LLM extraction, parallel fan-out, multi-step pipelines, checkpoint-resumable workflows, and recipes (people research, etc.). Reading it is mandatory, not advisory.
After reading SKILL.md, you MUST use the \`pplx_sdk\` Python package and the codesearch patterns the skill documents — faithful to the machinery and the spirit. When the task calls for multiple search queries, parallel fetches, or LLM extraction over many items, use the skill's fan-out / multi-step / checkpoint patterns rather than naive loops or hand-rolled \`requests\` scrapers. Read the relevant \`patterns/*.md\` and \`reference/*.md\` before writing code; consult \`recipes/*.md\` for full-workflow templates when applicable.
Then proceed with the user's task using what you just learned.`,
tools: [
{ type: "web_search" },
{ type: "finance_search" },
{ type: "sandbox" as const },
],
});
console.log(response.output_text);
curl https://api.perplexity.ai/v1/agent \
-H "Authorization: Bearer $PERPLEXITY_API_KEY" \
-H "Content-Type: application/json" \
--data @- <<'JSON'
{
"model": "openai/gpt-5.6-sol",
"input": "Find US-based companies that announced a CEO or CFO appointment in April 2026. For each, cite an authoritative source and write the results to results.jsonl.",
"max_steps": 100,
"max_output_tokens": 128000,
"reasoning": {
"effort": "high"
},
"instructions": "Search queries must be plain keywords. Never use quotation marks, AND, OR, or NOT inside a query \u2014 the search engine does not parse operators and treats them as literal text, which degrades results. To cover alternatives or exact phrases, send several short keyword queries instead.\n\n# Route by intent before general research\n\nWhen an available specialized or domain-specific tool authoritatively covers the user's intent, prefer it over generic `pplx_sdk` or web search. Fall back to web research only when no specialized tool covers the request or the specialized tool returns no relevant data.\n\n# Mandatory for general research: load the `pplx_sdk` skill first\n\nFor research not covered by a specialized tool, before doing anything else for the user's task, call `load_skill({\"name\":\"pplx_sdk\"})` and read the returned SKILL.md plus any sub-docs (`patterns/`, `recipes/`, `reference/`) that are relevant to the task. The skill is the expansive Python codesearch guide for `pplx_sdk` — multi-index search, content fetch / snippets, LLM extraction, parallel fan-out, multi-step pipelines, checkpoint-resumable workflows, and recipes (people research, etc.). Reading it is mandatory, not advisory.\n\nAfter reading SKILL.md, you MUST use the `pplx_sdk` Python package and the codesearch patterns the skill documents — faithful to the machinery and the spirit. When the task calls for multiple search queries, parallel fetches, or LLM extraction over many items, use the skill's fan-out / multi-step / checkpoint patterns rather than naive loops or hand-rolled `requests` scrapers. Read the relevant `patterns/*.md` and `reference/*.md` before writing code; consult `recipes/*.md` for full-workflow templates when applicable.\n\nThen proceed with the user's task using what you just learned.",
"tools": [
{
"type": "web_search",
"max_results": 15
},
{
"type": "finance_search"
},
{
"type": "sandbox"
}
]
}
JSON
Next Steps
Agent API Quickstart
Get started with the Agent API.
Agent API Models
Explore direct model selection and third-party models.
API Reference
View complete endpoint documentation.