synthesis_search

Search past lessons when stuck or facing a familiar error.

When to Call

Use search when you:

• Encounter an error you might have seen before
• Are stuck on a problem
• Want to check if there's a known solution
• Need to recall how something was done previously

Input Schema

Example Request

{
  "keywords": ["jwt", "token", "expiry"],
  "error_message": "token expired"
}

Response

{
  "success": true,
  "search_terms": ["jwt", "token", "expiry", "expired"],
  "matches": [
    {
      "lesson_id": "2026-02-24-jwt-tokens-expiring",
      "title": "JWT tokens expiring immediately",
      "type": "incident",
      "score": 6,
      "matched_keywords": ["jwt", "token", "expiry"],
      "solution_preview": "Server was using local time, client expected UTC..."
    }
  ],
  "message": "Found 1 relevant lesson(s)"
}

Search Scope

Search looks through:

• All lessons in your account
• Lesson titles, content, and keywords
• Explicit keywords field (higher weight)

Scoring

Results are ranked by relevance:

• Higher weight for keyword matches in title
• Higher weight for explicit keyword field matches
• Results sorted by score descending
• Maximum 5 results returned

No Results

If no lessons match:

{
  "success": true,
  "search_terms": ["xyz", "unknown"],
  "matches": [],
  "message": "No matching lessons found. This might be a new issue."
}