HumanReview

A request for human review before proceeding.

Usage

Source

HumanReview(
    content,
    agent="",
    context="",
    state="",
    metadata=dict(),
    created_at=time.time()
)

HumanReview captures content produced by an agent (or a pathway state) that requires human approval, rejection, or revision before the workflow continues.

Parameters

content: str

The content to be reviewed.

agent: str = ""

Name of the agent that produced the content.

context: str = ""

Additional context for the reviewer (e.g., task description, instructions).

state: str = ""

The pathway state name where the review was requested, if applicable.

metadata: dict[str, Any] = dict()


Arbitrary metadata attached to the review.

created_at: float = time.time()


Unix timestamp when the review was created.

Examples

Create a review, then approve it:

import talk_box as tb

review = tb.human_review("Deploy to production?", agent="deploy_bot")
review.status          # ReviewStatus.PENDING
review.is_pending      # True

decision = tb.approve(review, feedback="Looks good")
decision.status        # ReviewStatus.APPROVED
review.is_resolved     # True