Build conversation in 2ools
build_from_conversationIdempotent
Create a new project from a structured conversation brief and queue a durable build. Returns project and job IDs for tracking.
Instructions
Create a new 2ools project from a structured conversation brief and queue one durable build. Returns project_id and job_id; use get_build to retrieve completion status and the protected preview.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | Generation engine. studio is keyless; other models require an available account provider or linked Engine. | studio |
| pages | No | Pages to generate. Use Home for a one-page site or widget. | |
| entity | No | Grounded identity facts that must survive the build. | |
| audience | No | Primary audience and the job they need to complete. | |
| headline | No | Exact hero headline to preserve verbatim in the generated site. | |
| skill_ids | No | Exact compatible Skill IDs from list_build_systems. When supplied, replaces the Rulebook's default Skill set. | |
| curator_id | No | Exact Curator ID from list_build_systems. Omit for automatic selection. | |
| rulebook_id | No | Exact compatible Rulebook ID from list_build_systems. Overrides the Curator's default Rulebook. | |
| project_name | Yes | Short name for the new 2ools project. | |
| requirements | No | Concrete functionality, content, and section requirements. | |
| output_target | No | Delivery target: site, browser game, desktop wrapper, embeddable component, floating overlay, or standalone HTML. | web |
| max_iterations | No | Hard project cap for later outside-agent child revisions. Defaults to 6 and cannot exceed 12. | |
| idempotency_key | Yes | Caller-generated unique key. Reusing it returns the original project/job instead of creating a duplicate. | |
| visual_direction | No | Desired visual character, composition, color, typography, or references. | |
| content_constraints | No | Claims, wording, exclusions, or fidelity constraints the build must obey. | |
| conversation_summary | Yes | Factual build brief distilled from the conversation, including the intended artifact and key decisions. |