research-agent-optimization
リサーチエージェントのパフォーマンスとUXの最適化
リサーチエージェントはAPIレート制限に直面しやすく、進捗状況が不明瞭でユーザーに不満を与えます。このスキルは指数関数的バックオフ、適切なウェブ検索統合、リアルタイムの進捗更新を追加し、長いリサーチタスク中にユーザーが情報を得られるようにします。
スキルZIPをダウンロード
Claudeでアップロード
設定 → 機能 → スキル → スキルをアップロードへ移動
オンにして利用開始
テストする
「research-agent-optimization」を使用しています。 最新の再生可能エネルギー貯蔵技術の開発を調査してください
期待される結果:
- ✓ Searching web for: renewable energy storage technology...
- ✓ Searching news for: renewable energy storage...
- ✓ Searching internal knowledge base...
- ✓ Reading article: Breakthrough in Battery Storage - techreview.com
- ✓ Reading article: Grid-Scale Storage Solutions - energy.gov
- Found 5 sources from web search, 3 from news, 2 from internal database
セキュリティ監査
安全All 50 static findings are false positives. This is a YAML specification document describing optimization tasks, not executable code. The scanner misinterpreted markdown code formatting backticks as Ruby shell execution, and documentation text as cryptographic/system reconnaissance patterns. The skill contains no network calls, filesystem access, or external commands.
リスク要因
🌐 ネットワークアクセス (1)
📁 ファイルシステムへのアクセス (1)
⚙️ 外部コマンド (36)
品質スコア
作れるもの
リサーチ進捗の追跡
エージェントがウェブ、ニュース、内部データベースを検索する際にリアルタイムの更新を確認できます
API統合バグの修正
DuckDuckGoツールの名前解決問題を修正し、適切なエラー処理を実装します
信頼性の高いソース帰属の取得
不明なJSONではなく、クリック可能なソースカードでクリーンな回答を受け取れます
これらのプロンプトを試す
リサーチエージェント内のDuckDuckGoウェブ検索ツールの初期化を修正します。インポートは'from duckduckgo_search import DDGS'を使用する必要があります。web_searchおよびnews_searchツールがLLMに適切にバインドされ、内部検索にフォールバックできることを確認します。
Gemini API呼び出しに指数関数的バックオフリトライロジックを1秒、2秒、4秒、8秒の遅延で追加します。429エラーの検出と「APIレート制限: しばらく待ってから再試行してください」といったユーザー向けメッセージを実装します。
リサーチストリーミングジェネレーターを更新して、詳細なSSEイベントを放出するようにします。各イベントには、ツール名、クエリパラメータ、タイムスタンプ、実行時間を含める必要があります。web_search('query')を'Searching web for: query...'スタイルメッセージにマッピングします。フロントエンドを更新して、リサーチ回答からJSONブロックを削除します。タイトル、ソース、日付、サムネイルを含むクリック可能な記事カードの「ソース」セクションを追加します。ソースを取得方法でグループ化します。
ベストプラクティス
- 短時間内の重複API呼び出しを防ぐためにTTL付きのキャッシュを追加します
- 生のスタックトレースを表示する代わりに、ユーザー向けのエラーメッセージを提供します
- APIクオータの使用状況と残りのトークンをログに記録して、デバッグと監視を可能にします
回避
- フォーマットせずにユーザー向け応答内に生のJSONブロックを表示します
- 構成オプションなしでモデル名をハードコードして使用します
- ウェブ検索ツールがエラーに遭遇したときに応答なく失敗します