tiangong-kb-sci-search

Tiangong KB SCI Search

このスキルは、意図的に単一ソースのみを対象とします。検索するのは sci のみです。all、report、patent には決して対象を広げないでください。アクセスには、デプロイ所有者が通常使用するキーと利用資格が必要です。認証、認可、サブスクリプション、VPN、またはサービスの障害が発生した場合は停止してください。回避を試みないでください。

実行モードの選択

• 管理対象ワークスペース外で直接、単独検索する場合は、以下の説明に従って scripts/sci_search.sh を使用してください。管理対象ワークスペース内では、ユーザーが明示的に要求した分離クエリの場合に限り、"execution_mode":"standalone" を設定できます。ラッパーは、秘密情報を含まないモードイベントを記録します。
• Tiangong Auto Research の探索パッケージ内では、このスクリプトや CLI／curl の例を実行しないでください。fetch_candidate_source を通じて、ロックされた機能 ID database.tiangong.sci-search を使用してください。ブローカーが、正確な POST メソッド、エンドポイント、リージョンヘッダー、認証情報の注入、応答の上限、サニタイズ、永続的なエビデンスレシートを管理します。

直接検索の前提条件

• スタンドアロンラッパーは、個別にテスト済みの CLI バージョン 0.0.62 をデフォルトで使用します。これは Auto Research ワークスペースのランタイムではありません。管理対象のリサーチでは、変更不可のセットアップ計画または runtime-lock.json から正確なバージョンを解決し、ブローカーを使用する必要があります。 スタンドアロンのエントリーポイントを意図的にオーバーライドする場合に限り、TIANGONG_AI_CLI_BIN に実行ファイルの正確なパスを設定するか、明示的にレビュー済みのコマンドを TIANGONG_AI_CLI に設定してください。
• ソース固有のキーは TIANGONG_SCI_APIKEY に設定するか、共通のフォールバックとして TIANGONG_AI_APIKEY を使用してください。認証情報をラッパーの JSON、リクエストファイル、CLI 引数に指定することはできません。
• ラッパーには jq が必要です。
• 任意のエンドポイント変数として、TIANGONG_SCI_SEARCH_URL、TIANGONG_RESEARCH_API_BASE_URL、TIANGONG_AI_SEARCH_API_BASE_URL、または TIANGONG_AI_API_BASE_URL を指定できます。TIANGONG_REGION と TIANGONG_RESEARCH_TIMEOUT もサポートされています。

直接クエリ

export TIANGONG_SCI_APIKEY='owner-authorized key'
./scripts/sci_search.sh '{
  "query": "mechanical recycling reduces lifecycle emissions",
  "top_k": 5,
  "get_meta": true
}'

ラッパーは、固定された CLI を使って、次と同等の処理を実行します。

npx --yes --package "@tiangong-ai/[email protected]" -- tiangong-ai research search \
  --query <query> --sources sci --json

結果を書き込むには、2 番目の引数として明示的な出力パスを 1 つ渡してください。ラッパーは一意な一時ファイルに書き込み、CLI が正常に終了した場合にのみ名前を変更します。ファイルの存在だけを根拠に成功を報告することはありません。

正確なリクエストペイロード

インラインで指定したサポート対象のエッジ関数フィールドは、一時的なリクエストファイルに変換されます。

{
  "query": "critical metal material flows",
  "filter": {
    "journal": ["JOURNAL OF INDUSTRIAL ECOLOGY"]
  },
  "datefilter": {
    "date": { "gte": 1262304000 }
  },
  "topK": 5,
  "extK": 2,
  "getMeta": true
}

または、既存の通常ファイルである非シンボリックリンクの JSON ファイルを指定できます。

./scripts/sci_search.sh '{
  "request_file": "/absolute/path/to/sci-request.json",
  "dry_run": true
}'

filter はメタデータの用語配列を受け付けます。datefilter は数値の gte／lte 範囲を受け付けます。topK、extK、getMeta はサービスの生の名前です。top_k、ext_k、get_meta はクエリモードで使う便宜的な名前です。

任意の dotenv 読み込み

明示的に指定する env_file は存在し、通常ファイルである非シンボリックリンクで、所有者のみが読み取れる権限（chmod 600）でなければなりません。request_file が指定されていて、明示的な env ファイルが指定されていない場合は、同じディレクトリにある .env が存在し、同じ条件を満たすときにのみ読み込まれます。既存のプロセス変数が優先されます。

パーサーはシェル構文を実行せず、文書化された Tiangong のキー、エンドポイント、リージョン、タイムアウトの名前のみを読み込みます。それ以外のキーはすべて無視されます。このファイルにエージェントキー、ブラウザーの Cookie、Authorization ヘッダー、セッショントークン、プロキシのパスワード、または無関係な秘密情報を決して記載しないでください。

受け付けるラッパーフィールド

• query、input、または claim；
• request_file または input_file；
• env_file；
• execution_mode。standalone のみ。管理対象ワークスペースが検出された場合は、分離クエリの明示的な要求があった後に限ります；
• filter、datefilter、topK、extK、getMeta；
• クエリモードでは top_k、ext_k、get_meta；
• sources。sci または default のみ；
• 秘密情報を含まないルーティング値としての api_base_url、sci_url、region、timeout；
• dry_run。

API キー、トークン、Authorization、Cookie、パスワード、認証情報、秘密情報、またはセッションに見えるキーは、CLI の起動前に再帰的に拒否されます。ラッパーは、拒否された値や失敗したコマンドの標準出力をエコーしません。

Auto Research のブローカー呼び出し

research setup でこのスキルを選択して設定した後、以下の内容で検索します。

{
  "capability_id": "database.tiangong.sci-search",
  "url": "<the exact manifest endpoint>",
  "request_body": {
    "query": "research claim",
    "topK": 5,
    "getMeta": true
  }
}

ドキュメントに記載された非機密のリクエストフィールドのみを使用してください。API キー、ヘッダー、Cookie、エンドポイントの上書き、トークンを request_body に決して追加しないでください。ブローカーは論理キー tiangong.sci.api-key を x-api-key として注入し、固定された x-region を送信し、POST のリダイレクトを拒否します。また、永続的な生レスポンスオブジェクトの外部には、リクエストボディの SHA-256 のみを記録します。このデータベースは Auto Research が独自に求める公開インターネット上のエビデンス要件を補完するものであり、その要件に取って代わるものではありません。