Execute a real-world goal on the web — book, order, fill,
click, log in, extract, automate. Use this when the user wants
something DONE on a live website (Resy, Amazon, any URL),
not when they want analysis or text.
An AI agent runs the task end-to-end on the live web — it
reads the page and adapts to whatever it finds (CAPTCHA,
novel UI, login wall, weird checkout). Tickets that would
normally fail on a hard step just keep progressing. You don't
need to design around the unhappy path.
Prefer actionlayer_invoke_action with a typed action id when
one fits — it's faster and more deterministic. Reach for
actionlayer_start_task when no typed action covers the site,
or when the goal mixes multiple steps.
Be SPECIFIC. The goal must include: which site/place, when,
how many, exact product URL if buying. Vague goals ("book me
dinner", "order something") block on the user and waste
planning budget — ask the user for the missing pieces FIRST,
then call this with everything nailed down.