AI Finder Kit 検索 は何をしますか？
バージョン: 1.3.1
バンドルされた依存関係のないクライアントを使用して、認証済みの集約検索サービスにクエリを実行します。インタラクティブなローカルインストールの場合はconfigureを実行してキーを保護されたファイルに保存します。自動化の場合はAIFINDERKIT_API_KEYを注入します。プロンプト、コマンド出力、ソースファイル、スキルファイルにキーを決して配置しないでください。
必要条件
- Python 3.10以降で、アウトバウンドHTTPSアクセスが可能であること。
AIFINDERKIT_API_KEY、またはconfigureによって作成された保護された認証情報ファイル内の有効なAI Finder Kitの検索キーまたはオーナーキー。- 追加のPythonパッケージは不要です。このスキルバンドルには意図的に認証情報は含まれていません。
最初の検索前に、python scripts/aifinderkit_search.py doctorを実行してください。これにより、キーを出力せずに、Python、認証、APIバージョン、利用可能なエンドポイント、現在の制限を検証します。
ワークフロー
- 現在の環境でアクセスがまだ確認されていない場合は、
doctorを実行します。 - リクエストに応える最小の操作を選択します。
search: 1つのクエリに対し、正規化・重複排除された結果を返します。domains: 構造化検索の前に、有効なAnySearch垂直サブドメインを発見します。batch: 2～5つの独立したクエリを実行します。fetch: 既知の公開HTTP(S)ページから可読性の高いテキストを抽出します。map: 1つの静的ページ上のリンクの範囲指定されたリストを発見します。crawl: 小さな同一ホストセクションを抽出します。広範なサイトクロールは行いません。research: 複数クエリによる証拠収集、抽出、カバレッジ、ギャップ検出を行います。- 学術研究では、
--preset academic-strictを使用してください。プロジェクトページや非論文のテクニカルレポートも有用な場合にのみacademic-relaxedを使用します。Relaxedモードは精度より再現性を優先するため、retrieval_signals.query_relevanceを検査し、弱いマッチを破棄してください。 meta: 現在のアクセス階層とリクエスト制限を表示します。
scripts/aifinderkit_search.pyを実行します。- 検索品質を評価する際は、
retrieval_signalsと共にretrieval_scoreを使用します。フュージョンscoreはプロバイダランキングの値にすぎません。confidenceはretrieval_scoreの非推奨のエイリアスであり、決して事実の真実を表すものではありません。 - ユーザー向けの回答では、返されたページURLを引用します。スニペットは発見の補助として扱い、正確な主張を行う前に
fetchまたは元のページを使用してください。 - 比較や重要な主張には、一次情報源、または2つの独立した情報源間の一致のいずれかを必要とします。
confidenceを事実確認として扱わないでください。これは検索シグナルです。
コマンド
python scripts/aifinderkit_search.py search "query" --limit 10 --mode balanced
python scripts/aifinderkit_search.py search "query" --language zh --category news
python scripts/aifinderkit_search.py search "query" --include-domain github.com
python scripts/aifinderkit_search.py domains --domain academic --domain code
python scripts/aifinderkit_search.py search "transformer" --vertical-domain academic --vertical-sub-domain academic.search
python scripts/aifinderkit_search.py search "multimodal learning" --preset academic-strict --mode deep
python scripts/aifinderkit_search.py research "retrieval augmented generation evaluation" --preset academic-strict --fetch-top 5
python scripts/aifinderkit_search.py batch --query "paper one" --query "paper two" --preset academic-relaxed --limit 5
python scripts/aifinderkit_search.py fetch "https://example.com/page"
python scripts/aifinderkit_search.py map "https://example.com/docs" --max-links 30
python scripts/aifinderkit_search.py crawl "https://example.com/docs" --max-pages 5 --max-depth 1
python scripts/aifinderkit_search.py research "topic" --subquery "history" --subquery "current evidence" --fetch-top 3
python scripts/aifinderkit_search.py meta
python scripts/aifinderkit_search.py configure
secret-manager-command | python scripts/aifinderkit_search.py configure --key-stdin
python scripts/aifinderkit_search.py doctor
レイテンシが重要な発見にはfastを、デフォルトではbalancedを、研究にはdeepを使用します。リクエストが時間に制限されている場合にのみ、--freshness day|week|month|yearを追加します。クライアントのタイムアウトはデフォルトで60秒です。複数PDFの研究の場合は、コマンド名の前に--timeout 120を配置します。
金融、学術、コード、医療、法律、セキュリティ、旅行、その他の構造化AnySearchドメインについては、最初にdomainsを実行します。返されたsub_domainのみをコピーし、必要なすべてのパラメータを--vertical-param key=valueで含めます。ディレクトリに必須パラメータがマークされているが該当するものがない場合は、空の値を使用します。domainsが403を返した場合は、垂直スキーマをでっち上げる代わりに、通常の集約検索を続行します。
ワークフローのステップ2が文献レビューの場合は、通常の検索パスの代わりにreferences/academic-research.mdに従ってください。アカデミックプリセットは専門の学術エンジンを使用し、可能な場合はDOI/著者/年/オープンアクセスのメタデータを公開し、厳格モードでは一般ウェブへのフォールバックを避けます。academicオブジェクトをプログラムで利用する前に、references/api.mdをお読みください。
crawlの前にmapを使用してください。ユーザーが特定の小さなドキュメンテーションセクションを必要としない限り、クロールのデフォルトは維持してください。クロールは静的HTML、同一ホスト、最大8ページ、深さ2です。ブラウザ自動化ツールではありません。
深層調査については、サブクエリを選択したりcoverageやgapsを解釈する前に、references/research-workflow.mdをお読みください。ソースの選択と引用チェックについては、references/source-quality.mdをお読みください。
バンドルされたスクリプトがカレントワーキングディレクトリにない場合は、ユーザーのプロジェクトにscripts/があると仮定するのではなく、このSKILL.mdからの相対パスで解決してください。
クライアントは最初にAIFINDERKIT_API_KEYをインラインキーとしてチェックします。設定されていない場合、クライアントはAIFINDERKIT_API_KEY_FILEで選択された保護ファイル、またはデフォルトの~/.config/aifinderkit/credentialsを読み取ります。インタラクティブなconfigureはエコーなしで読み取ります。configure --key-stdinはシークレットマネージャーパイプラインをサポートします。どちらもスキルと現在のプロジェクトの外部にモード0600で書き込みます。キーをコマンドライン引数として渡さないでください。
エンドポイントが401を返した場合は、ユーザーに有効な検索キーを設定するよう依頼してください。429を返した場合は、制限を報告し、リトライのループはしないでください。warningsにソースが利用不可と表示された場合は、完全な集約であると暗示するのではなく、結果セットが低下したことを報告してください。
正確なスキーマ、エンドポイントマッピング、またはエラー動作が必要な場合にのみ、references/api.mdをお読みください。