perplexity-search

Perplexity Search Skill

Perplexity API を使用して、リアルタイムのウェブ検索と調査を実行するスキルです。

目的

このスキルでは、次の機能を利用できます。

1. perplexity_ask - 一般的な質問に回答します（sonar-pro モデルを使用）
2. perplexity_research - 詳細な調査と包括的なレポートを作成します（sonar-deep-research モデルを使用）
3. perplexity_reason - 高度な推論と分析を行います（sonar-reasoning-pro モデルを使用）
4. perplexity_search - ウェブ検索結果を取得します

使用するタイミング

次のような場合に、このスキルを使用します。

• ユーザーが最新情報を必要としている
• ウェブ検索が必要な質問を受けた
• 詳細な調査や調査分析を依頼された
• 複雑な分析や推論が必要である
• 「調べて」「検索して」「最新の…」などのキーワードが含まれている

前提条件

• PERPLEXITY_API_KEY 環境変数が設定されている必要があります
• インターネット接続が利用可能である必要があります

使用方法

基本的な使い方

scripts/perplexity_api.py スクリプトを使用して API を呼び出します。

# General questions (ask)
python3 scripts/perplexity_api.py ask "your question"

# Deep research (research)
python3 scripts/perplexity_api.py research "research topic"

# Advanced reasoning (reason)
python3 scripts/perplexity_api.py reason "reasoning task"

# Web search (search)
python3 scripts/perplexity_api.py search "search query" [--max-results 10] [--country JP]

コマンドオプション

ask / research / reason

• 第 1 引数：質問、調査トピック、または推論タスク
• --strip-thinking：コンテキストトークンを節約するために、`` タグを削除します（research / reason のみ）

search

• 第 1 引数：検索クエリ
• --max-results：返す結果の最大数（1～20、デフォルト：10）
• --max-tokens-per-page：ページあたりの最大トークン数（256～2048、デフォルト：1024）
• --country：地域別の結果を取得するための ISO コード（例：JP、US、GB）

ワークフロー

標準的な検索フロー

1. ユーザーの質問を分析し、適切なツールを選択します

   • 簡単な質問 → ask
   • 詳細な調査 → research
   • 複雑な分析 → reason
   • 情報収集 → search

2. スクリプトを実行して API を呼び出します

3. 利用可能な場合は出典を引用しながら、結果をユーザーに提示します

ツール選択のガイドライン

使用例	ツール	説明
現在の天気、ニュース	ask	すばやい回答が必要な場合
技術トピックの調査	research	包括的な分析が必要な場合
複雑な問題の分析	reason	論理的な推論が必要な場合
出典の収集	search	URL やスニペットが必要な場合

API の詳細

API 仕様の詳細については、references/api_reference.md を参照してください。

トラブルシューティング

• API キーのエラー：PERPLEXITY_API_KEY 環境変数を確認してください
• タイムアウト：PERPLEXITY_TIMEOUT_MS を増やしてください（デフォルト：300000ms）
• プロキシの問題：PERPLEXITY_PROXY または HTTPS_PROXY を設定してください