WRITE ACTION — creates a new DreamAgent project (website, Telegram
bot, Discord bot, or AI agent). confirm must be true to execute.
When several telegram/discord credentials are saved, the one to use
is selected via bot_token_integration_id (see
dreamagent_list_global_integrations).
MODEL SELECTION — IMPORTANT: the default model is GLM 5.3 Flash
("z-ai/glm-5.3-flash"). Keep the default unless the USER explicitly
asked for a specific model. Only pass a different id when the user
named it, e.g. "use claude sonnet" → "anthropic/claude-sonnet-5.5",
"use glm 5.3" → "z-ai/glm-5.3", "use opus" → "claude-opus-4-6".
Claude models consume the project owner's Claude subscription quota
— never choose them on your own initiative.
CREATION IS ASYNCHRONOUS: after calling, check
dreamagent_get_project_status repeatedly until the project is
'ready' or 'failed' (bots ~2-5 min, websites longer).
CREDENTIALS: raw bot tokens are never accepted in chat or as inputs.
For Telegram/Discord bots you MUST pass bot_token_integration_id —
the ID of a saved credential from dreamagent_list_global_integrations.
If none is saved, direct the user to dreamagent.cloud → Settings →
Global Integrations. Other saved keys can be imported via
global_integration_ids. Credentials are stored as project secrets
and are never exposed back.
DESCRIPTION = the refined creation brief describing WHAT should be
built (see the structure notes below).
THREE.JS / WEBGL SIGNAL: if the site genuinely needs real 3D/WebGL
(3D scenes, games, product configurators, 3D visualization), the
description MUST contain the exact word "three.js" (e.g. "Includes
interactive 3D scenes built with three.js") — the platform installs
the 3D stack based on that word. Include it ONLY when genuinely
needed; regular websites must never include it. When included, also
mention the 3D usage in one clause of the description.
Create a concise but complete description of WHAT should be built:
- product vision and target audience
- user experience and core functionality
- design/tone direction
- important features and behavior
- final expected result
Do not include implementation details such as:
- technology stack
- architecture
- database/API implementation
- authentication implementation
- deployment
- CI/CD
- testing commands
Infer reasonable defaults when missing details are non-critical.
Ask for clarification only when missing information materially
affects the requested functionality, scope, credentials, or
expected result.
Prefer the following structure and constraints for each project
type, but do not override explicit user requirements:
Website:
- Project Vision
- Design Style
- Pages
- Hero Experience
- Core Features
- UI Components
- Mobile Experience
- Final Expectation
- Prefer up to 4 pages unless the user clearly requires more.
Telegram bot:
- Bot Purpose
- Commands
- User Flow
- Optional AI Features
- Integrations when required
- Final Expectations
- Prefer a compact command set; always include /start and /help
unless the user's explicit requirements conflict.
Discord bot:
- Bot Purpose
- Slash Commands
- Events
- Permissions
- Optional AI Features
- Final Expectations
- Prefer a compact command set; include /help where appropriate.
Agent (recurring/scheduled automation with OAuth actions):
- Purpose (what it monitors or automates)
- Data Sources (which connected OAuth services: YouTube, GitHub,
Discord, Notion, X, Google Sheets, Slack — or public APIs)
- Schedule (e.g., every 5 minutes / hourly / daily at 9am) and/or
Event Triggers (incoming webhook)
- Conditions (when to act — thresholds, keywords, state changes)
- Delivery Channels (Telegram, Discord, Slack, email — optional)
- Final Expectation
- Use concrete schedules; note that agents keep persistent state
between runs and can call any connected OAuth integration.
- Agents do NOT need a bot token unless they deliver via Telegram/
Discord (then a saved credential is required as for bots).
SUPERPOWERS: the account may have add-on AI tools enabled. If the
requested product uses one, reflect the FEATURE in the description —
DreamAgent wires the tool integration automatically at build time.
Check what is enabled with dreamagent_list_superpowers.