intentions_ask_hour
Call when the user asks about timing within a specific day — best hour to act, morning vs afternoon, when during the day ("best time today to X", "morning or afternoon for Y", "几点去见面好"). Use for interview slots, meeting times, send/publish times, departure times, workout windows. Pro subscription required; on the free tier this returns a subscription_required error whose payload suggests intentions_ask_day for day-level analysis or intentions_energy_chart with period weekly / yearly for a visual overview (the caller LLM decides whether to retry). Modes: single (date+hour), compare up to 5 hour-pairs, or scan all 12 two-hour blocks of one day. Accepts any clock hour 0..23; internally mapped to the containing 2-hour block midpoint (0/2/4/…/22). 23:00–23:59 automatically rolls the effective day forward by one. Every output entry includes a window { start, end } local wall-clock span (YYYY-MM-DDTHH:MM, no timezone offset — interpret in the same frame as the input hour). Always cite this when presenting the time. Returns score, verdict, adverse alerts.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| category | No | Decision domain — tunes the analysis weighting. Default: general. | |
| question | Yes | The decision or action being considered | |
| bestInDay | No | Find best hours within a single day. Each entry carries an explicit `window` span. | |
| birthInfo | No | Optional override. If provided, all 6 fields required: { year, month, day, hour, minute, gender } — use null for unknown hour/minute/gender. Omit entirely to use the stored profile. | |
| targetDate | No | YYYY-MM-DD. Default: today (single mode only) | |
| targetHour | No | Clock hour 0..23. Auto-rounded to the containing 2-hour block. 23:XX rolls the effective day forward by one. | |
| compareHours | No | Up to 4 additional (date, clock-hour 0..23) pairs to compare against targetDate+targetHour. Pairs that resolve to the same 2-hour block (e.g. hours 7 and 8 on the same date) are deduplicated — submit distinct blocks if you want distinct results. |