Review Workflows

This guide describes a practical AgentInbox workflow for a review-focused agent.

The default recommendation is:

Standing Subscriptions

Typical standing subscriptions for a review agent are:

Keep these standing subscriptions low-noise. They should point the agent at real work, not every observable lifecycle event.

For a single PR or branch, add temporary subscriptions such as:

PR discussion events for metadata.number == <pr_number>
CI completion events for metadata.headBranch == <branch> and metadata.status == "completed"

When the task is finished:

agentinbox subscription remove <subscriptionId>

This lets one long-lived agent follow many short-lived review tasks without creating a new agent session for each one.

Temporary review subscriptions should not become standing subscriptions by accident.

Removing them after the task is done keeps:

For review workflows, prefer structured metadata filters where possible:

Use expression filters only when the shortcut form is not enough.