Tools

Wake-ups & fan-out

Work that does not fit one turn: come back later, or do the same thing for every item in a list.

ToolWhat it does
schedule_followupSchedules the agent to run again later with a follow-up prompt โ€” a reminder, a deferred check, "circle back in three days".
map_overRuns one child agent per item of a list or CSV with the same prompt ({item} is the placeholder), in parallel, then collects the results into one artifact.

schedule_followup

Schedules the agent to run again later with a follow-up prompt โ€” a reminder, a deferred check, "circle back in three days".

How an agent gets it. Added automatically on chat and automation runs.

Arguments

ArgumentTypeRequiredMeaning
whenstringyesISO 8601 datetime or a +Nh/+Nd offset.
promptstringyesWhat to work on when you wake up.

map_over

Runs one child agent per item of a list or CSV with the same prompt ({item} is the placeholder), in parallel, then collects the results into one artifact.

How an agent gets it. Added automatically on top-level chat and automation runs โ€” never on a child run, so fan-out is one level deep.

Arguments

ArgumentTypeRequiredMeaning
overarray | stringyesA JSON array of items, or a CSV/newline-delimited string.
prompt_templatestringyesPrompt for each child; use {item} as the placeholder.
target_agentstringOptional slug of a different agent to run per item.