Files
Redflag/skills/synthetic-search.md
User user-00000000-0000-4000-8000-000000000000 43be571463 Backfill skills/synthetic-search block
2026-03-24 21:55:44 +00:00

1.3 KiB

description
description
null

Synthetic Search Skill

When to Use This Skill

Use this skill when:

  • You need to search the web for information
  • You need privacy-focused search (Synthetic API has zero data retention)
  • You need web search results formatted as JSON

How to Use

The skill provides a Python function search_synthetic that makes API calls to Synthetic search:

# Import and call the function
from tools.search_synthetic import search_synthetic

results = search_synthetic(query="your search query", num_results=10)
# Returns JSON string of search results

Parameters

  • query (str, required): The search query to look up on the web
  • num_results (int, optional): Maximum number of results to return (default: 10)

Returns

JSON string containing search results array or error message.

Example Usage

results = search_synthetic("Letta AI agent memory architecture", num_results=5)
# Parse JSON and extract results
import json
data = json.loads(results)
for result in data:
    print(result['title'], result['url'])

API Key

The function reads SYNTHETIC_API_KEY from environment variables. If not set, uses default key (for development).

Notes

  • Zero data retention (privacy-focused)
  • 30 second timeout
  • Returns raw JSON, not formatted text
  • Handle errors by checking for "error" key in response