Skip to main content
Use /v2/prioritize when the caller provides environment context and asks what matters now.

Environment Profile

Include the context that changes priority:

Workflow

  1. Call /v2/prioritize with environment, time_window_days, and max_items.
  2. Review top signals by priority_score, confidence_score, and environment_match_reasons.
  3. Validate the top 1-3 signals with evidence and relationships.
  4. Run the relevant assessment for each material item.
  5. Return an action plan ordered by priority.

Interpret Ranking Fields

  • priority: human-friendly urgency label
  • priority_score: deterministic rank score
  • confidence_score: confidence in the signal and supporting data
  • activity_level: current activity signal
  • novelty_score: how new the signal is to the request context
  • freshness_score: recency of supporting data
  • environment_match_reasons: why this matters to the provided environment
  • suppression_reasons: why a signal was lowered or deprioritized
  • what_changed: changes since the requester’s last view
  • recommended_action_type: action category for follow-up