revise
Continue a council discussion by feeding each member the previous round's answers and asking them to update their positions. Use when you want another round of cross-critique after reading the first results.
Instructions
Run ONE more round of an existing discussion: show every member what was said last round and ask it to revise.
This is ask_all's rounds turned inside out, so that you can drive them. Two
reasons to want that.
You would rather decide after reading. ask_all(rounds=2) commits to the
second round before the first one exists. Ask with rounds=1, read what comes
back, and call this only if the disagreement is worth another call per member —
or call it three more times if they are still moving. There is no round ceiling
here, unlike ask_all, because every round is one you chose to pay for.
A voice in the discussion is one only you can produce — a subagent you spawned, or your own answer — and you want it to be a full member rather than a one-off: something that answers, reads the others, and revises alongside them.
The loop, in the second case:
ask_all(prompt)— the members answer round 1 ...and you produce your subagent's round-1 answer yourselfrevise(prompt, answers=[...])— pass EVERY round-1 answer, the members' and your subagent's; the members come back revised ...and you re-run your subagent on the same materialrepeat as long as it is still moving
Each entry in answers is {text, model} for a member's own answer, or
{text, label} for an outside one. Naming the member matters: that is what lets
it see its previous answer as its own and revise, instead of answering fresh.
round is which round the answers you are passing came from, so the members are
told where they are. Pass answers verbatim, never summarised.
Pass the same materials you passed to ask_all, every round. The members are
stateless: a document they were shown last round does not exist for them in this
one, and a council revising from memory it does not have will revise from the
other answers alone.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| round | No | ||
| models | No | ||
| prompt | Yes | ||
| system | No | ||
| answers | Yes | ||
| materials | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |