tiangong-kb-report-search

name	tiangong-kb-report-search
description	Search Tiangong knowledge-base report sources through the Tiangong AI CLI. Use for industry reports, policy reports, whitepapers, institutional reports, and technical reports. This skill searches only the report source, not sci or patent.

Tiangong KB Report Search

Use this skill for Tiangong report-source retrieval. It is intentionally single-source: always search report, never all, sci, or patent.

Prerequisites

• The wrapper defaults to npx @tiangong-ai/cli@0.0.19; users do not need a preinstalled CLI. Set TIANGONG_AI_CLI or TIANGONG_AI_CLI_BIN only to override the CLI entrypoint.
• Set the authentication environment variables expected by tiangong-ai, or pass api_key / report_api_key to the wrapper script.
• When request_file / input_file is provided, the wrapper loads .env from that file's directory by default. env_file can point to a different dotenv file. Loaded dotenv values only fill unset environment variables; explicit JSON fields such as api_key, report_api_key, and api_base_url are passed as CLI flags and take precedence.
• Optionally set TIANGONG_AI_API_BASE_URL; the CLI accepts a Supabase project root, /functions/v1, or /rest/v1 and derives Functions URLs.

Search

For normal searches, pass a query:

./scripts/report_search.sh '{
  "query": "mechanical recycling policy report",
  "top_k": 5
}'

The script calls:

npx @tiangong-ai/cli@0.0.19 research search --query <query> --sources report --json

For exact edge-function payloads, provide request_file or input_file:

./scripts/report_search.sh '{
  "request_file": "./report-request.json",
  "dry_run": true
}'

Raw Payload Filters

Wrapper JSON can include inline raw report_search fields; the wrapper will forward them through the CLI --input path. The same payload can also be put in request_file / input_file:

{
  "query": "mechanical recycling policy report",
  "filter": {
    "source": ["IEA"]
  },
  "topK": 5,
  "extK": 2
}

• filter: metadata term filters, shaped as { "field": ["value"] }.
• topK, extK: raw edge-function names for result count and adjacent chunk expansion.
• datefilter and getMeta are not supported by report_search.

Input Fields

• query, input, or claim: convenience query text.
• request_file or input_file: JSON body forwarded unchanged.
• env_file: optional dotenv file. Without it, request_file / input_file causes the wrapper to load .env from that file's directory.
• filter, topK, extK: optional inline raw payload fields for report search.
• sources: optional compatibility field; only report or default is accepted.
• dry_run: true to return the exact request plan with masked credentials.
• api_base_url, api_key, report_api_key.
• report_url, region, timeout.
• top_k, ext_k: only used in query mode.