perplexity-research

perplexity-research — 脳知識を活用したウェブ調査

規約： 引用ルールについては conventions/quality.md を参照してください。ウェブ調査によるすべての主張には、言い換えではなく、検証可能な引用を付けます。

規約： 検索の順序については conventions/brain-first.md を参照してください。このスキルは、Perplexity のプロンプトに脳のコンテキストを含めて送信することで、脳優先を徹底します。ウェブ検索では、脳の知識と現在のウェブ上の情報との差分に焦点を当てます。

この機能について

既存の脳の知識と Perplexity のウェブ検索を組み合わせます。エージェントはトピックに関する脳のコンテキストを Perplexity のクエリに含めて送信します。Perplexity は複数のページを検索、閲覧し、引用付きで情報を統合して、提供されたコンテキストと比較した新しい情報に焦点を当てます。

重要なポイント： Perplexity は検索するだけでなく、引用付きで情報を閲覧し、統合します。指示に脳のコンテキストを含めて送信すると、すでに把握している情報を認識し、確定した事実を繰り返すのではなく、その差分を提示します。

他のツールではなく、これを使う場面

必要なこと	使用するもの
引用付きの詳細な調査	このスキル — Perplexity + Opus
URL の内容をすばやく取得	web_fetch
脳のみを使った検索	gbrain query / gbrain search
リアルタイムのソーシャルメディア監視	外部の X / ソーシャルメディア収集ツール
トラッカーに対する構造化データの検索	skills/data-research/SKILL.md

出力構造

調査結果は、次の構造で research/<slug>.md の脳ページとして保存されます。

---
title: "[Topic] — Research [YYYY-MM-DD]"
type: research
date: YYYY-MM-DD
brain_context_slugs: ["pages whose context was sent to Perplexity"]
recency_filter: "[hour|day|week|month|none]"
---

# [Topic] — Research [YYYY-MM-DD]

> Executive summary: 2-3 sentences on the delta between brain knowledge
> and current web state.

## Key New Developments
What's changed since the brain was last updated on this topic.

## Confirming Signals
Web evidence validating existing brain knowledge.

## Contradictions or Updates
Things that conflict with the brain — these need a closer look.

## Recommended Brain Updates
Specific page updates the user might want to make based on this research.
Each item: which page, what to add or change, source URL.

## Citations
- [Source title](URL) — accessed YYYY-MM-DD
- [Source title](URL) — accessed YYYY-MM-DD
- ...

呼び出し方法

このスキルは Markdown 形式のエージェント指示です。エージェントは Perplexity の API を直接使用します（または、インストールされている場合はホストが提供する perplexity CLI を使用します）。

# 1. Pull brain context
gbrain get <slug>                    # or
gbrain query "<topic keywords>"

# 2. Compose the Perplexity query with brain context inline:
#    """
#    Topic: <topic>
#    Brain context (what we already know): <embedded gbrain content>
#    Find: what's NEW since 2026-MM-DD that the brain doesn't reflect.
#    Cite every claim.
#    """

# 3. Call Perplexity's Agent API (or the host's perplexity binary). The
#    Sonar chat-completions endpoint (/chat/completions with
#    "model": "sonar-pro") is being retired and refuses migrated accounts
#    with 403 agent_api_migration_required; use POST /v1/agent:
#    curl https://api.perplexity.ai/v1/agent \
#      -H "Authorization: Bearer $PERPLEXITY_API_KEY" \
#      -H "Content-Type: application/json" \
#      -d '{"preset": "low", "instructions": "Cite every claim.", "input": "..."}'
#    Read the answer from the output item with "type": "message" (SDKs
#    expose it as output_text) and the citations from the search results
#    in the output array; inline [n] markers refer to them.

# 4. Write the structured research page via put_page:
gbrain put research/<slug>      # via the put_page operation

# 5. Cross-link entities mentioned (people, companies) per Iron Law.

プリセット

エージェント API のプリセット	置き換え対象	使用する場面
"preset": "low"	Sonar Pro	詳細な分析、エンティティ情報の補足、案件調査（複数ステップの検索）
"preset": "fast"	Sonar	すばやい検索、一括監視、ブリーフィングのパイプライン

デフォルトでは low を使用します。深さよりもコストを重視する一括処理や cron のコンテキストでは、fast に切り替えます。Perplexity はプリセットのリクエストごとの固定料金を公開していません。一括ジョブを実行する前に、料金ページを確認してください。

統合パターン

エンティティ情報の補足

エンティティのページ（人物、企業）に最新のウェブ情報が必要な場合、skills/enrich/SKILL.md から呼び出します。

BRAIN=$(gbrain get people/<slug> 2>/dev/null)
# Send <slug>'s page content as brain_context to Perplexity, get current
# news / role / context, then update the brain page with what's new.

案件／企業の監視（cron）

deals/ または companies/ の各アクティブな項目に対して実行します。

# Weekly: pull recent news per company; flag changes for review.

朝のブリーフィング

ブリーフィングのパイプラインで web_fetch を直接呼び出す代わりに、このスキルを使用して、エージェントがすでに把握している事実を再度説明しないようにします。

情報の鮮度フィルター

ウェブ検索ツールに鮮度フィルターを指定します。 "tools": [{"type": "web_search", "filters": {"search_recency_filter": "week"}}] hour | day | week | month | year を指定できます。ニュース性の高いトピックに便利です。長期的に有効な調査では省略してください。ページのフロントマターでは、この値を recency_filter として記録します。

失敗した場合

gbrain のエラー code、終了コード、[AGENT] ブロック、または notice ブロックが発生した場合は、エージェント運用者プロトコルに従ってください。このスキルに固有の事項は次のとおりです。

• PERPLEXITY_API_KEY が設定されていないか、拒否された場合：ウェブ検索を実行できないことをユーザーに伝え、脳の情報のみから回答し、その旨を明記します。
• rate_limited：指定された遅延の後に再試行します。一括処理の場合は、ループを続けるのではなく、より安価なモデルに切り替えます。
• 脳のコンテキストを使った検索結果が空で、劣化に関する notice がある場合：「脳の知識と比べて何が新しいか」という差分は信頼できません。脳側の情報がキーワード検索のみだったことを伝えます。

アンチパターン

• ❌ 脳のコンテキストをまったく送信しないこと。その場合は単なる検索になるため、代わりに web_fetch を使用してください。
• ❌ 脳のコンテキストを切り詰めること。「把握していることを知っている」のがこの仕組みの要点です。情報量の多いコンテキストを送信してください。
• ❌ 引用を破棄すること。出力内のすべての主張に URL が必要です。
• ❌ エンティティに言及した際に、相互リンクの手順を省略すること。これは絶対に守るべきルールです。

環境

• エージェントの環境（または ~/.gbrain/.env）に PERPLEXITY_API_KEY を設定します。
• 任意：ストリーミング出力を充実させるには、Perplexity の公式 CLI をインストールします。

関連スキル

• skills/academic-verify/SKILL.md — 引用検証済みの学術的主張チェックのために perplexity-research をラップします
• skills/enrich/SKILL.md — エンティティ拡充ループの一部として perplexity-research を呼び出します
• skills/data-research/SKILL.md — 構造化データのトラッカーです（形式が異なり、自由形式の調査ではなく、パラメーター化された YAML レシピを使用します）

契約

このスキルでは、以下を保証します。

• ルーティングがフロントマターの標準トリガーと一致します。
• 該当する場合、writes_to: に記載されたディレクトリ配下に出力を書き込みます。
• 参照されている規約（quality.md、brain-first.md、_brain-filing-rules.md）に従います。
• プライバシー契約を維持します。実名、フォーク固有のファイルシステムパスのリテラル、上流フォークへの言及は含めません。

完全な動作契約は上記の本文セクションに記載されています。このセクションは適合性テスト用に設けられています。

出力形式

このスキルの出力形式は、上記の本文セクション（「Output」、「Brain page format」など）にインラインで記載されています。ここにあるセクション見出しは、適合性テスト（test/skills-conformance.test.ts）用に設けられています。