FAQ and common mistakes
Short answers to common questions about Alan, and the mistakes that cost the most time.
Short answers, each with a link to the page that covers it in full.
Getting started
Sessions and agents
Work and outputs
Common mistakes
- Leaving the outcome in chat. Ask for a plan or test report artifact so it stays on the task.
- Making the first task too big. "Improve onboarding" is a project; "Document the local runtime setup" is a task.
- Moving status on intent. Move a task to In Review when there is something to review, not when you plan to start.
- Forgetting the execution target. If the composer says Choose an execution target before sending, pick a cloud environment or a computer first.
- Mixing up IDs. Agents must use the
teamId,taskId, andconversationIdAlan gives them. See Links and IDs. - Publishing without checking. A published link is readable by anyone who has it.