Documentation

Tenant OwnerReviewerOperator

Product knowledge base, playbooks, and embedded guidance for every persona.

Trigger Sources

A Trigger Source explains why CoffeeBreakAI is executing a task. It is a key part of understanding routing, retries, and refinement.

Common Trigger Sources

  • UserRequest – A user initiated the task from the UI or API.
  • Integration – A connected system (like GitHub or Jira) created or updated a work item.
  • Retry – The task is being retried due to a recoverable failure.
  • ReviewComment – A reviewer requested changes or provided feedback that requires a follow-up task.
  • InternalFollowUp – The system created a new task as part of a multi-step flow (such as decomposition).

Why Trigger Sources Matter

  • They inform the Task Router about context and desired behavior.
  • They can influence agent selection (e.g., refinement agents for ReviewComment).
  • They help with auditability, so teams can see why work was scheduled.

When inspecting a task in the UI, the trigger source provides a concise explanation of how it entered its current execution path.