Community研究&データ分析github.com

valyuai/valyu-best-practices

AIエージェント向けの完全なValyu APIツールキット。ウェブ、学術、医療、交通、金融情報源のリアルタイム検索、URLからのコンテンツ抽出、引用付きAI回答、包括的なディープリサーチレポートなどを実行します。

valyu-best-practices とは?

このスキルは、Valyu APIを最大限活用するためのベストプラクティス集です。AIエージェント(Claude Code、Cursor、Codexなど)がリアルタイム検索、データ抽出、引用付きの回答生成、深い調査レポートの作成を効率的に行えるようになります。ウェブ全体、学術論文、医療情報、交通データ、金融情報など多様なソースを横断的に検索可能です。Valyu APIのエンドポイントやパラメータ設定の推奨事項、そしてAPI呼び出し結果を自然言語で解釈する方法を記述しており、エージェントが正確で信頼性の高い情報を提供できるよう支援します。Markdown形式のベストプラクティスとして提供され、エージェントはこれをツール定義やプロンプトテンプレートとして解釈・実行できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/valyuai/skills/tree/main/skills/valyu-best-practices

Installed? Explore more 研究&データ分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

valyu-best-practices は何をしますか?

AIエージェント向けの完全なValyu APIツールキット。ウェブ、学術、医療、交通、金融情報源のリアルタイム検索、URLからのコンテンツ抽出、引用付きAI回答、または包括的なディープリサーチレポートを実行するよう求められた場合にこのスキルを使用します。

機能

  • リアルタイム検索: 指定したソース(web、academic、medical、transportation、financial)から最新情報を取得
  • コンテンツ抽出: 任意のURLからテキストコンテンツを抽出
  • AI回答: 引用元付きのインテリジェントな回答を生成
  • ディープリサーチ: 複数ソースを横断した詳細な調査レポートを作成

使用手順

  1. 検索クエリの作成: 目的に応じた適切なクエリとソースパラメータを指定します。
  2. API呼び出しの実行: Valyu APIエンドポイントに対してリクエストを送信します。
  3. 結果の処理: 返されたJSONレスポンスを解析し、必要な情報を抽出します。
  4. 回答の提示: 引用元を明示しながら、ユーザーにわかりやすく結果を提示します。

ベストプラクティス

  • ソースの選択: 検索対象に応じて適切なソース(web、academic、medical、transportation、financial)を指定してください。
  • クエリの具体化: 曖昧なクエリよりも具体的なキーワードを使用すると、結果の精度が向上します。
  • 引用の明示: 情報の信頼性を高めるため、必ず引用元を明記してください。
  • レート制限の考慮: APIの利用制限に注意し、必要に応じてリクエスト間隔を調整してください。

例

import requests

# Valyu APIへの検索リクエスト例
response = requests.post(
    "https://api.valyu.ai/v1/search",
    json={
        "query": "最新のAI技術動向",
        "sources": ["web", "academic"],
        "max_results": 5
    },
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)

data = response.json()
for result in data["results"]:
    print(f"タイトル: {result['title']}")
    print(f"URL: {result['url']}")
    print(f"スニペット: {result['snippet']}")

注意事項

  • APIキーは環境変数 VALYU_API_KEY として設定してください。
  • 大量のリクエストを行う場合は、バックオフ戦略を実装することを推奨します。
  • 法的・倫理的な制約を遵守し、適切な利用範囲内で使用してください。

関連スキル