Your first task
A daily check-in your kid sees on their iPad. Your agent reads the family, then creates the task. No skill, no canvas: the simplest thing that lands on your kid's screen.
A task is the kid-facing unit in Sprout. It's the thing that shows up on the iPad and that your kid taps into. You can author one directly from your agent; no skill wrapper required. We'll save it as a skill in the next page.
Read the family
Every meaningful call starts with knowing who's in the family. family.query_overview returns the roster: parents, kids, ids, names, ages. Resolve a kid's name to an id yourself; never hardcode UUIDs.
family.query_overview()
# Returns:
# {
# parents: [{ userId, name, ... }],
# kids: [{ childId, name, birthDate, age, ... }]
# }
#
# Pick the kid you want; remember their childId for the next call.Create the task
One call creates the task and assigns it to your kid. We use runMode: "conversation" so Sprout's in-app agent runs a guided chat. The conversationSpec.guidance is the prompt Sprout follows. Weekday cadence at 5pm, three gems on completion.
task.create({
name: "Daily check-in",
assignChildIds: ["<childId>"],
runMode: "conversation",
conversationSpec: {
goalType: "share",
guidance: "Ask about one highlight from today, one lowlight, and one thing they're looking forward to tomorrow. Listen well; reflect back. Keep it warm, short. Under 3 minutes."
},
scheduleSpec: {
taskType: "schedule",
days: ["mon","tue","wed","thu","fri"],
startMinutes: 1020
},
rewardSpec: { gems: 3 }
})
# Returns: { taskId: "<task>" }
# The task is now live on the kid's iPad, weekdays at 5pm.What the kid sees
Every weekday at 5pm, the Daily check-in card lands on the kid's iPad. They tap in, Sprout opens the chat with the guidance you wrote, and listens. They get 3 gems on completion, and the chat posts to the family inbox automatically.