Back to Details

perplexity

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Perplexity Tools

Perplexity 工具

Use ONLY when user says "search", "find", "look up", "ask", "research", or "what's the latest" for generic queries. NOT for library/framework docs (use Context7), gt CLI (use Graphite MCP), or workspace questions (use Nx MCP).
仅当用户针对通用查询说出“search”“find”“look up”“ask”“research”或“what's the latest”时使用。请勿用于库/框架文档查询（请使用Context7）、gt CLI相关问题（请使用Graphite MCP）或工作区问题（请使用Nx MCP）。

Quick Reference

快速参考

Which Perplexity tool?
  • Need search results/URLs? → Perplexity Search
  • Need conversational answer? → Perplexity Ask
  • Need deep research? → Researcher agent (
    /research <topic>
    )
NOT Perplexity - use these instead:
  • Library/framework docs → Context7 MCP
  • Graphite 
    gt
    CLI → Graphite MCP
  • THIS workspace → Nx MCP
  • Specific URL → URL Crawler
选择哪款Perplexity工具？
  • 需要搜索结果/URL？ → Perplexity Search
  • 需要对话式回答？ → Perplexity Ask
  • 需要深度调研？ → Researcher agent（
    /research <topic>
    ）
请勿使用Perplexity，改用以下工具：
  • 库/框架文档 → Context7 MCP
  • Graphite 
    gt
    CLI → Graphite MCP
  • 当前工作区相关问题 → Nx MCP
  • 特定URL内容 → URL Crawler

Perplexity Search

Perplexity Search

When to use:
  • Generic searches, finding resources
  • Current best practices, recent information
  • Tutorial/blog post discovery
  • User says "search for...", "find...", "look up..."
Default parameters (ALWAYS USE):
typescript
mcp__perplexity__perplexity_search({
  query: "your search query",
  max_results: 3,           // Default is 10 - too many!
  max_tokens_per_page: 512  // Reduce per-result content
})
When to increase limits: Only if:
  • User explicitly needs comprehensive results
  • Initial search found nothing useful
  • Complex topic needs multiple sources
typescript
// Increased limits (use sparingly)
mcp__perplexity__perplexity_search({
  query: "complex topic",
  max_results: 5,
  max_tokens_per_page: 1024
})
使用场景：
  • 通用搜索、资源查找
  • 当前最佳实践、最新资讯
  • 教程/博客文章发现
  • 用户说出“search for...”“find...”“look up...”时
默认参数（务必使用）：
typescript
mcp__perplexity__perplexity_search({
  query: "your search query",
  max_results: 3,           // 默认是10 - 结果过多！
  max_tokens_per_page: 512  // 单结果内容精简
})
何时提高限制： 仅在以下情况使用：
  • 用户明确需要全面的结果
  • 初始搜索未找到有效内容
  • 复杂主题需要多来源信息
typescript
// 提高限制（谨慎使用）
mcp__perplexity__perplexity_search({
  query: "complex topic",
  max_results: 5,
  max_tokens_per_page: 1024
})

Perplexity Ask

Perplexity Ask

When to use:
  • Need conversational explanation, not search results
  • Synthesize information from web
  • Explain concepts with current context
Usage:
typescript
mcp__perplexity__perplexity_ask({
  messages: [
    {
      role: "user",
      content: "Explain how postgres advisory locks work"
    }
  ]
})
NOT for:
  • Library documentation (use Context7)
  • Deep multi-source research (use researcher agent)
使用场景：
  • 需要对话式解释，而非搜索结果
  • 整合网页信息进行归纳
  • 结合当前背景解释概念
使用方式：
typescript
mcp__perplexity__perplexity_ask({
  messages: [
    {
      role: "user",
      content: "Explain how postgres advisory locks work"
    }
  ]
})
请勿用于：
  • 库文档查询（请使用Context7）
  • 多来源深度调研（请使用Researcher agent）

Prohibited Tool

禁用工具

NEVER use: 
mcp__perplexity__perplexity_research
Use instead: Researcher agent (
/research <topic>
)
  • Token cost: 30-50k tokens
  • Provides multi-source synthesis with citations
  • Use sparingly for complex questions only
绝对禁止使用： 
mcp__perplexity__perplexity_research
替代方案： Researcher agent（
/research <topic>
）
  • Token消耗：30-50k tokens
  • 提供带引用的多来源整合内容
  • 仅针对复杂问题谨慎使用

Tool Selection Chain

工具选择优先级

Priority order:
  1. Context7 MCP - Library/framework docs
  2. Graphite MCP - Any 
    gt
    CLI mention
  3. Nx MCP - THIS workspace questions
  4. Perplexity Search - Generic searches
  5. Perplexity Ask - Conversational answers
  6. Researcher agent - Deep multi-source research
  7. WebSearch - Last resort (after Perplexity exhausted)
优先级顺序：
  1. Context7 MCP - 库/框架文档查询
  2. Graphite MCP - 任何涉及
    gt
    CLI的问题
  3. Nx MCP - 当前工作区相关问题
  4. Perplexity Search - 通用搜索
  5. Perplexity Ask - 对话式回答
  6. Researcher agent - 多来源深度调研
  7. WebSearch - 最后备选方案（Perplexity无法解决时使用）

Examples

示例

✅ CORRECT - Use Perplexity Search:
  • "Find postgres migration best practices"
  • "Search for React testing tutorials"
  • "Look up latest trends in microservices"
✅ CORRECT - Use Perplexity Ask:
  • "Explain how postgres advisory locks work"
  • "What are the trade-offs of microservices?"
❌ WRONG - Use Context7 instead:
  • "Search for React hooks documentation" → Context7 MCP
  • "Find Next.js routing docs" → Context7 MCP
  • "Look up Temporal workflow API" → Context7 MCP
❌ WRONG - Use Graphite MCP instead:
  • "Search for gt stack commands" → Graphite MCP
  • "Find gt branch workflow" → Graphite MCP
❌ WRONG - Use Nx MCP instead:
  • "Search for build config" (in THIS workspace) → Nx MCP
  • "Find project dependencies" (in THIS workspace) → Nx MCP
✅ 正确场景 - 使用Perplexity Search：
  • "Find postgres migration best practices"
  • "Search for React testing tutorials"
  • "Look up latest trends in microservices"
✅ 正确场景 - 使用Perplexity Ask：
  • "Explain how postgres advisory locks work"
  • "What are the trade-offs of microservices?"
❌ 错误场景 - 应使用Context7：
  • "Search for React hooks documentation" → Context7 MCP
  • "Find Next.js routing docs" → Context7 MCP
  • "Look up Temporal workflow API" → Context7 MCP
❌ 错误场景 - 应使用Graphite MCP：
  • "Search for gt stack commands" → Graphite MCP
  • "Find gt branch workflow" → Graphite MCP
❌ 错误场景 - 应使用Nx MCP：
  • "Search for build config"（当前工作区内）→ Nx MCP
  • "Find project dependencies"（当前工作区内）→ Nx MCP

Key Points

核心要点

  • Default to limited results - avoid context bloat
  • Library docs = Context7 - ALWAYS try Context7 first
  • "gt" = Graphite MCP - ANY "gt" mention uses Graphite
  • Deep research = /research - NOT perplexity_research tool
  • Fallback chain - Search → Ask → WebSearch (last resort)
  • 默认使用有限结果 - 避免上下文冗余
  • 库文档查询优先用Context7 - 务必先尝试Context7
  • 涉及“gt”用Graphite MCP - 任何提到“gt”的场景都使用Graphite
  • 深度调研用/research - 不要使用perplexity_research工具
  • 备选流程 - Search → Ask → WebSearch（最后备选）