SuperAPI AI Directory

search-guide

Agents & models

View repository

Updated 10-16 06:23

About this skill

Search Tool Usage Guidelines

✅ Scenarios where you should search

1. Real-time information

  • Today's news, latest updates
  • Stock prices, exchange rates
  • Weather forecast
  • Sports event results
  • Latest version numbers, release dates

2. Verification of specific facts

  • Specific numbers, dates, statistical data
  • Company information (founding time, founders, funding)
  • Product specifications, prices
  • Official documentation links

3. Unfamiliar concepts

  • Proper nouns, abbreviations
  • New technologies, new products
  • Domain-specific terminology
  • Background of people, companies

4. The user explicitly requests it

  • "Help me look up..."
  • "Search..."
  • "The latest..."
  • "The current..."

❌ Scenarios where you should not search

1. General knowledge

  • Basic syntax of programming languages
  • Common design patterns
  • Basic mathematical concepts
  • Widely known historical events

2. Concept explanations

  • "What is a REST API"
  • "Explain async/await"
  • "Characteristics of object-oriented programming"

3. Code writing

  • Write a sorting algorithm
  • Implement a certain feature
  • Fix a code bug
  • Code refactoring suggestions

4. Creative tasks

  • Write an article, write a story
  • Come up with names
  • Provide suggestions and solutions

5. Existing information

  • Content already returned by the previous search
  • Information provided by the user in the conversation

🔄 Search Decision Process

用户提问
    │
    ▼
┌─────────────────────┐
│ 这是实时信息需求吗? │──── 是 ────→ 搜索
└─────────────────────┘
    │ 否
    ▼
┌─────────────────────┐
│ 涉及具体事实/数据?  │──── 是 ────→ 搜索
└─────────────────────┘
    │ 否
    ▼
┌─────────────────────┐
│ 是不熟悉的专有名词? │──── 是 ────→ 搜索
└─────────────────────┘
    │ 否
    ▼
┌─────────────────────┐
│ 用户明确要求搜索?   │──── 是 ────→ 搜索
└─────────────────────┘
    │ 否
    ▼
  直接回答(不搜索)

📝 Search Keyword Techniques

Good keywords

  • Short and precise: 3-8 characters
  • Include the core concepts
  • Avoid modal particles and auxiliary words

Example comparison

❌ Bad keywords ✅ Good keywords
"Could you please tell me what Apple's current stock price is" "Apple stock price"
"I want to know what new features Python 3.12 has" "Python 3.12 new features"
"Can you help me check what the weather in Beijing is like today" "Beijing weather"

⚠️ Search Precautions

  1. Avoid repeated searches: If the same content has already been searched in the previous round, use the results directly
  2. Parallel search: For comparison-type questions, multiple keywords can be searched at the same time
  3. Switch tools: For simple queries use websearch, for complex research use deepsearch
  4. Result verification: Search results need to be assessed for credibility; prioritize authoritative sources