deliberate
Run an adversarial deliberation on a decision. Multiple AI perspectives argue opposing positions over multiple rounds, iteratively strengthening arguments, and converge on a recommendation with confidence scoring. Use for important decisions where you want to stress-test options from multiple angles. Over MCP the deliberation runs in the background: the first call returns a run_id immediately; call deliberate again with { run_id } (plus the same companyId) after ~1-2 minutes to fetch the result.
Routing: Important decision → deliberate for adversarial analysis
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| run_id | No | Poll a background deliberation started earlier (MCP mode). Pass the run_id returned by the starting call, with the same companyId. Omit question/positions when polling. | |
| context | No | Goals, constraints, values, and relevant data that should inform the deliberation. The more context, the better the arguments. | |
| criteria | No | Optional weighted evaluation criteria. Each item should have "name" (string) and "weight" (number 0-1, should sum to ~1). If omitted, defaults are generated. | |
| question | No | The decision or question to deliberate. Be specific — e.g., "Should we invest in mobile app development or API partnerships for growth in Q2?" Required unless polling with run_id. | |
| companyId | No | FreedomOS company id to act within (you must be a member). Required for company-scoped tools. | |
| positions | No | Two or more positions to argue. Each should be a clear, distinct option — e.g., ["Mobile app development", "API partnerships", "Content marketing"]. Required unless polling with run_id. | |
| max_rounds | No | Maximum rounds of deliberation (default: 5). More rounds = better arguments but more compute. |