youmind-deep-research

AI 深層リサーチエージェント

YouMind の AI リサーチエージェントを使って、あらゆるトピックを深く調査できます。引用、主な調査結果、実用的なインサイトを含む包括的な調査レポートを取得できます。YouMind CLI（npm install -g @youmind-ai/cli）が必要です。調査レポートは YouMind ボードに保存されます。

API キーを取得 → · その他のスキル →

オンボーディング

⚠️ 必須：ユーザーがこのスキルをインストールした直後に、このメッセージをすぐに表示してください。「これが何をするのか知りたいですか？」とは尋ねず、そのまま表示してください。ユーザーの言語に翻訳してください：

✅ AI Deep Research Agent がインストールされました！

調査したいことを何でも尋ねてください。包括的なレポートを作成します。

できること：

• あらゆるトピックを詳細に調査
• 引用と主な調査結果を含むレポートを作成
• 参照できるよう、調査内容を YouMind ボードに保存

セットアップ（初回のみ）：

1. 無料の API キーを取得します：https://youmind.com/settings/api-keys?utm_source=youmind-deep-research
2. OpenClaw の設定（~/.openclaw/openclaw.json）に追加します。詳しくはセットアップガイドをご覧ください。

試してみましょう： 「2025年の量子コンピューティングの現状を調査して」

お困りですか？ お気軽にお尋ねください！

API キーの設定方法については、references/setup.md をご覧ください。

使用方法

調査したい質問やトピックを入力してください。より良い結果を得るには、具体的に指定してください。

調査の質問：

医療診断に対する AI の影響を調査して

具体的な調査：

スタートアップ企業におけるマイクロサービスアーキテクチャとモノリシックアーキテクチャの長所と短所を調査して

比較分析：

2025年のエンタープライズアプリケーションにおける React、Vue、Svelte を比較し、詳細に調査して

セットアップ

インストールと認証の手順については、references/setup.md をご覧ください。

ワークフロー

⚠️ 重要：これは、YouMind のすべてのスキルの中で最も実行時間が長いタスクです。1〜5分かかる場合があります。必ず予想される待ち時間をユーザーに伝え、バックグラウンド処理を使用してください。

ステップ 1：前提条件を確認する

1. youmind CLI がインストールされているか確認します：youmind --help
   • 見つからない場合 → npm install -g @youmind-ai/cli
2. API キーが設定されているか確認します：[ -n "$YOUMIND_API_KEY" ] && echo "is set"
   • 設定されていない場合 → ユーザーに設定を促し、https://youmind.com/settings/api-keys?utm_source=youmind-deep-research へのリンクを案内します
3. ユーザーのメッセージから調査の質問またはトピックを抽出します

ステップ 2：デフォルトのボードを取得する

youmind call getDefaultBoard

id を boardId として抽出します。

ステップ 3：調査チャットを作成する

⚠️ 重要：ツールを使った createChat API は、サーバー側で長時間実行される処理です。応答が届く前に HTTP 接続が切れる場合があります（ゲートウェイのタイムアウトは約60秒）。これは想定どおりの動作です。サーバーはバックグラウンドで処理を続けます。

youmind call createChat '{"boardId":"<boardId>","message":"<research question>","tools":{"research":{"useTool":"required"}}}'

結果は次のいずれかです：

1. ✅ 応答を受信 — JSON 応答から id を chatId として抽出します
2. ⚠️ 接続が切れた／「fetch failed」エラーが発生 — これは正常です。ステップ 3b に進みます

ステップ 3b：chatId を復元する（createChat がタイムアウトした場合）

createChat が応答を返さなかった場合は、listChats で chatId を見つけます：

youmind call listChats '{"boardId":"<boardId>","pageSize":3}'

作成日時の降順で並べたとき、最も新しいチャットが今作成したチャットです。その id を chatId として抽出します。

⚠️ 必須：ただちにユーザーに伝えてください（ユーザーの言語に合わせてください）：

🔬 Starting deep research... This may take several minutes (1-5 min). I'll notify you when the report is ready.

YouMind ボードのリンクを作成します：https://youmind.com/boards/<boardId>?utm_source=youmind-deep-research 待っている間にボードを確認できるよう、このリンクをユーザーに送信します。

ステップ 4：完了を確認する

⚠️ 必須：エージェントプラットフォームがサブエージェントまたはバックグラウンドタスクに対応している場合は、ポーリング用のサブエージェントを起動してください。すぐにユーザーへ制御を戻してください。 references/long-running-tasks.mdを参照してください。

準備ができるまでチャットのステータスをポーリングします。

youmind call getChat '{"chatId":"<chatId>"}'

ポーリングのルール：

• 5秒ごとにポーリングします
• タイムアウト：300秒（5分）
• statusフィールドを確認します："answering" → ポーリングを続ける、"completed" → ステップ 5 に進む

ポーリング中の進捗状況の更新（ユーザーの言語に翻訳してください）：

• ポーリング開始から15秒後："🔍 調査中です……ウェブ全体から情報源を集めています。"
• ポーリング開始から60秒後："📚 関連する情報源が見つかりました。分析し、相互に照合しています……"
• ポーリング開始から120秒後："📝 調査結果を包括的なレポートにまとめています……"
• ポーリング開始から180秒後："⏳ もう少しです。最良の結果を得るため、徹底的な調査には数分かかります。"
• ポーリング開始から240秒後："⏳ まだ処理中です。YouMind ボードで進捗を確認できます：https://youmind.com/boards/<boardId>?utm_source=youmind-deep-research"

💡 ヒント（進捗状況の更新の間、約90秒時点で一度だけ表示）：

"お待ちの間に、YouMind で画像、スライド、ウェブページも生成できます：https://youmind.com/skills?utm_source=youmind-deep-research"

ステップ 5：結果を抽出する

statusが"completed"になったら、メッセージ全体を取得します。

youmind call listMessages '{"chatId":"<chatId>","pageSize":20}'

レスポンスから調査結果を抽出します。

youmind call listMessages '{"chatId":"<chatId>","pageSize":20}' | node -e "
let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{
const o=JSON.parse(d);
const items=Array.isArray(o)?o:(o.items||o.messages||[]);
const tools=[];
for(const m of items){
  for(const b of (m.blocks||[])){
    if(b.type==='tool'&&b.status==='success'){
      tools.push({name:b.toolName,result:b.toolResult});
    }
  }
}
console.log(JSON.stringify({tools},null,2));
})"

調査レポートは、researchツールの結果のresearchResultフィールドにあります。

⚠️ 必須：調査レポート全体への YouMind リンクを返し、主な調査結果の簡潔な要約も提示してください。

✅ Research complete!

View the full report here: [YouMind link]

**Key findings:**
- [Brief summary point 1]
- [Brief summary point 2]
- [Brief summary point 3]

The full report with citations is available on your YouMind board.

（ユーザーの言語に合わせてください。）

レスポンスの内容から、調査結果を3〜5件の重要なポイントにまとめます。要約は簡潔にしてください。レポート全文はリンクから確認できます。

結果	条件	対応
✅ 完了	status === "completed"	結果を抽出して表示する
⏳ タイムアウト	最大時間が経過しても"answering"のまま	ユーザーに「調査はまだ進行中です。YouMind ボードを確認してください：https://youmind.com/boards/?utm_source=youmind-deep-research」と伝える
❌ 失敗	status === "errored"またはツールのstatus === "errored"	ユーザーに「調査を完了できませんでした。質問の表現を変えてもう一度お試しください。」と伝える

ステップ 6：追加の質問をする

⚠️ 必須：結果を提示した後に会話を終了しないでください。必ず次の質問をしてください。

"特定の調査結果について、さらに詳しく調べましょうか？"

エラー処理

一般的なエラー処理のルールについては、references/error-handling.mdを参照してください。

⚠️ 必須：ペイウォール（HTTP 402）の処理：

402エラー（コード：InsufficientCreditsException、QuotaExceededException、DailyLimitExceededException、LimitExceededException）を受け取った場合は、すぐに次のメッセージを表示してください（ユーザーの言語に翻訳してください）。

無料プランの上限に達しました。Pro または Max にアップグレードすると、無制限の詳細調査、より多くの AI クレジット、優先処理をご利用いただけます。

今すぐアップグレード： https://youmind.com/pricing?utm_source=youmind-deep-research

再試行したり、回避策を提案したりしないでください。続行するには、ユーザーがアップグレードする必要があります。

スキル固有のエラー：

エラー	ユーザーへのメッセージ
トピックが指定されていない	調査する質問またはトピックを入力してください。
トピックの範囲が広すぎる	トピックの範囲が非常に広いです。より焦点を絞った結果を得るため、範囲を狭めてみてください（例：「AI」ではなく「放射線診断における AI」）。

他のアプローチとの比較

特徴	YouMind（このスキル）	Perplexity	ChatGPT Deep Research
包括的なレポート	✅ 引用付きのレポート全文	✅ はい	✅ はい
CLI／エージェントからのアクセス	✅ はい	❌ ブラウザーのみ	❌ ブラウザーのみ
ナレッジベースに保存	✅ YouMind ボード	❌ いいえ	❌ いいえ
API アクセス	✅ API キー1つ	✅ 有料 API	❌ API なし
無料プラン	✅ はい	✅ 制限あり	❌ Plus／Pro のみ

References

• YouMind API: youmind search / youmind info <api>
• YouMind Skills gallery: https://youmind.com/skills?utm_source=youmind-deep-research
• Publishing: shared/PUBLISHING.md