Skip to main content
Iterate on a Hive Agent by running it with a focused objective, reading the rejected nodes and trace details, then tuning stage models, tools, repeat settings, and budget limits.

​
How do I read verifier feedback?

Open Hive Agents > Logs and click a run. In the run detail sheet, review the node overview and trace stages. Rejected nodes include the reason and required fix from verification. The next execute pass receives that rejection feedback so the executor can try again. Deterministic checks run before semantic verification. They catch invalid JSON, blank required fields, nested JSON strings, and URL fields that do not resolve. Optional schema fields should be returned as null when unused; the platform fills omitted nullable keys before schema validation, but blank required fields still fail verification.

​
What should I tune first?

Start with the stage that failed:
  • Tune PLAN when nodes are poorly decomposed or verification criteria are vague
  • Tune EXECUTE when outputs are incomplete, unsupported by sources, or missing tool work
  • Tune VERIFY when good outputs are rejected or weak outputs pass
  • Tune REPEAT when the run stops too early or spends too long retrying similar failures
For source-heavy tasks, attach better sources before changing models.

​
How do completion modes affect iteration?

Strict mode fails the run when required nodes remain unverified after the max passes. Best effort mode completes with verified work and flags the unverified nodes. Use it when partial verified output is acceptable. Best effort does not bypass final composition: after nodes verify, Compose must still pass or the run fails.

​
Do edits affect running tasks?

Blueprint edits affect future runs. Stage agent settings can also affect later activity cycles in an already-running task because the runtime reads the current stage agent when an activity starts. Avoid changing models, tools, or budget settings mid-run unless you intend to change the next stage cycle. For clean comparisons, wait for the run to finish, edit the blueprint, then start a new run with the same objective.

​
How do I compare runs?

Use Hive Agents > Logs. Compare:
  • Objective
  • Status
  • Pass number
  • Node counts
  • Source counts
  • Total tokens
  • Total cost
  • Duration
  • Final response
  • Rejection reasons
Keep test objectives narrow while you tune. Once the loop is reliable, increase scope and budget. See also: Running Tasks and Logs.