K-Fortune 사주

Compute a Korean Saju / Four Pillars (사주팔자) analysis from birth details and render the result in the K-Fortune widget. When to call: - Call this tool whenever the user has provided enough birth information to compute a chart: at minimum `birth_date`, `gender`, and `timezone` (IANA name such as Asia/Seoul or America/New_York), plus `birth_time` OR `unknown_time=true`. - Also call it when the K-Fortune widget submits the form (the widget invokes this tool with the collected fields). - If required fields are missing or ambiguous, call `open_kfortune_ui` instead so the user can fill them in via the form. - If a chart for the same person already exists earlier in the conversation, reuse it instead of recomputing. - IMPORTANT: After calling this tool, do NOT also call `open_kfortune_ui`. That would render two widgets at once. This tool alone updates the widget with the results. Consultation behavior (after the chart is returned): reply in the user's language (Korean ↔ Korean, English ↔ English). First, greet the user briefly and ask them to choose: 1) a full step-by-step reading from Stage 1 (recommended for first-time visitors), or 2) jumping straight to specific questions (wealth, love, career, this year's flow — recommended for returning visitors). If they choose 1, run a warm, staged consultation — one stage per turn, end each by inviting the user to continue: (1) chart structure, (2) five-element balance, (3) Ten Gods, (4) stem/branch relations, (5) fortune flow, (6) personality & direction, (7) practical follow-up. If they choose 2 or ask a direct question, answer it immediately using the chart (Stage 7 behavior); they can request the full staged reading later. Avoid robotic, fear-inducing, or deterministic language. Output schema: - Returns `structuredContent` (full chart, original Korean/Chinese fields for the UI) and `content[0].text` (JSON the model reads for interpretation). - When `lang=en`, `content[0].text` is fully English-keyed: - `pillars`: year/month/day/hour as `{ ganzhi, stem, branch }`, with romanized labels (e.g. `geng_yang_metal`, `wu_horse`). `ganzhi` keeps the canonical 2-character Chinese symbol. - `five_elements`: `{ wood, fire, earth, metal, water }` (counts). - `deep`: `ten_gods_stem`, `ten_gods_branch_primary`, `ten_gods_branch_all`, `twelve_stages_day_master`, `twelve_stages_year_stem`. Values are romanized (e.g. `parallel_self`, `direct_officer`, `seven_killings`, `birth`, `bath`, `nourishment`). - When `lang=ko`, `content[0].text` keeps Korean keys (`목/화/토/금/수`, `십성/정기지지십성/지지십성/봉법12운성/거법12운성`) and Chinese ganzhi. - When replying in English, use the English labels — do not output raw Chinese/Korean characters.

analyze_saju

Open the K-Fortune embedded UI to collect a user's birth details (date, time, gender, timezone) via a form. Call this tool when the user asks for a Saju / Four Pillars reading but has NOT yet provided the required birth information in the conversation. If the user has already supplied birth_date, gender, and timezone (and either birth_time or an explicit 'time unknown' note), call `analyze_saju` directly instead of opening the form. Never ask for these details in chat when this tool is the right choice — the widget will collect them. IMPORTANT: Do NOT call this tool in the same turn as `analyze_saju`, and do NOT call it after `analyze_saju` has already returned a chart in this conversation. Calling both tools in the same response will render two widgets and confuse the user.

open_kfortune_ui