jp_lit_refine_results
Read-onlyIdempotent
Locally refine saved Japanese literature search results. Sort, filter, and perform set operations without re-querying. Optionally attach cached enrichment metadata.
Instructions
read-only。保存済み jp_lit_search 結果を upstream 再検索せずローカルでソート・フィルタ・集合演算し、必要時だけ重複候補クラスタも返す。include_enrichment=true なら保存済み jp_lit_enrich_record cache を cluster に重ねるが、Crossref/OpenAlex へ新規照会しない。cache_key が分かっている結果を再評価するときに使い、cache_key を探す段階では jp_lit_search_cache_index または jp_lit_list_cache を使う。cache や session は変更しない
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | 返す item の最大件数。最大 200。 | |
| key_by | No | 集合演算時に item を同一視するキー。source_record は source+source_id、duplicate_key は正規化重複キー、title_author_year はタイトル著者年。 | source_record |
| offset | No | 返す item の offset。0 始まり。 | |
| combine | No | 複数 cache の集合演算。union は和集合、intersection は積集合、minus は先頭から後続を除外する。 | union |
| filters | No | 保存済み結果に対するローカル filter。upstream 再検索は行わない。 | |
| sort_by | No | 再抽出結果の並び替え項目。未指定なら元の順序を保つ。 | |
| cache_key | No | 再抽出する単一の jp_lit_search cache_key。cache_keys と同時指定しない。 | |
| cache_keys | No | 集合演算する複数の jp_lit_search cache_key。 | |
| session_id | No | セッションに紐づく検索 cache を対象にする場合のセッションID。 | |
| sort_order | No | sort_by 指定時の並び順。 | asc |
| cluster_limit | No | 返す重複クラスタの最大件数。 | |
| cluster_offset | No | 重複クラスタ一覧の offset。0 始まり。 | |
| include_enrichment | No | true の場合は保存済み jp_lit_enrich_record cache を読み、重複クラスタに外部書誌照合 metadata を付与する。外部 API は呼ばない。 | |
| cluster_member_limit | No | 各重複クラスタで preview する member の最大件数。 | |
| enrichment_cache_keys | No | cluster enrichment に使う jp_lit_enrich_record cache_key。未指定なら対象 session の jp_lit_enrich_record 履歴を使う。 | |
| include_duplicate_clusters | No | true の場合は重複候補クラスタを追加で返す。 |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | ||
| limit | Yes | ||
| key_by | Yes | ||
| offset | Yes | ||
| combine | Yes | ||
| clusters | No | ||
| total_after | Yes | ||
| total_before | Yes | ||
| base_cache_key | Yes | ||
| totals_by_base | Yes | ||
| base_cache_keys | Yes | ||
| cluster_summary | No |