Skip to content

Build a draft agenda with the Scheduler agent

The Scheduler is the agent that places sessions into rooms and time slots. It works inside an agenda draft: you describe the schedule you want — the day’s start and end, how long each format runs, which sessions to include, the rules that matter to you — and it proposes a full placement that respects your rooms and speakers. The proposal stays in the draft until you commit it, so the live agenda never changes on its own.

Training video · 4:13Scheduler agent: a draft agenda from your rooms, formats and rulesWhat the Scheduler agent does, switching it on from the Agents page, its panel (Works from your agenda, Run Scheduler → Open agenda, Activity), the Scheduler panel on the agenda's Week view with a draft (Scheduling against, Generated), the Configure tab (Hard constraints, Schedule window, Sessions to include, Format durations, Room visibility, Scheduling behavior, Scheduling rules with weights, Event criteria, Generate Agenda), the Explain tab (Last Run with Placed, Score and Skipped, each day's placements with the rules they satisfied), the proposal on the calendar and the Conflicts tab, and how a draft becomes the live agenda through View & Commit Changes.
Video transcript

Building the agenda is a puzzle. Nine rooms, four days, a keynote that needs the big hall, workshops that run longer, speakers who can’t be in two places at once. The Scheduler is the agent that solves it. You describe the schedule you want in a draft, the hours, how long each format runs, the rules that matter, and it proposes a full placement, every session in a room and a slot, with the reason for each. The proposal stays in the draft until you commit it. The live agenda never changes on its own.

It starts on the Agents page. The switch on the Scheduler card turns it on, Setup becomes On. Click the card for its panel. Works from your agenda is the whole idea: it reads a draft agenda’s criteria and places sessions into rooms and time slots, and you review every proposed change. Run Scheduler is a button, Open agenda, because the draft is where the work happens. Activity lists the drafts it has scheduled, with runs, proposed changes and applied changes.

This is the agenda’s Week view, inside a draft. The banner says so, you’re viewing a draft of your agenda, with its title. The Scheduler panel is the wand button at the top of the right-hand sidebar; until the agent is on, it’s disabled. The header reads Scheduling against this draft, with Change and New draft to switch. Two tabs. Configure is the brief. Explain is the result.

Configure, top to bottom. Hard constraints, the two it always enforces, no speaker in two rooms at once and one session per room per slot. Schedule window, the day’s start and end and the slot length. Sessions to include, by status. Format durations, how many minutes a keynote, a workshop, a lightning talk runs. Room visibility, all rooms or a chosen set. Scheduling behavior, whether to ignore existing times and rooms and start from a blank grid.

Then Scheduling rules, the preferences. Group by Track, keep a track in one room. Avoid Parallel Topics. Balance Tracks Across Days, Balance Sessions Per Day, Workshops in Morning. Each one has a weight from one to fifteen, and a higher weight is a stronger preference, so the Scheduler knows what to give up when two rules disagree. The footer counts the active rules, criteria and hard constraints, and Generate Agenda runs it. The calendar updates only when it finishes.

Explain is what it did. Last Run, how many sessions were Placed and how many were Skipped, none here. Then each day’s placements, time, room, title, and the rules that placement satisfied, groups track together, balances day load. A session it couldn’t fit would be listed under Could Not Schedule with the reason. And the calendar behind the panel is the same proposal, every accepted session in a room and a slot across the four days. The Conflicts tab counts anything in the draft that breaks one of your conflict rules.

The proposal is a draft until you say otherwise. Drag a placement to another slot and your change stays in the draft. Raise a rule’s weight or change a duration and generate again. When it looks right, View and Commit Changes in the banner lists every difference between the draft and your live agenda; you keep or remove each one, and only the accepted changes land on the agenda and in your embeds. Back to Agenda leaves the draft where it is.

Back on the Agents page, the Scheduler’s Activity tab lists each draft it has worked on, how many runs, how many proposed changes, how many applied, and clicking one opens it in the agenda. The Help Center article on the Scheduler agent has the detail on every criterion and rule. Next, Team Lead, the guide on every page, and the Attention tab where your agents bring you their decisions.

The Scheduler agent builds and refines a draft agenda automatically, moving sessions into the best available slots based on your rules and constraints. Improve mode lets you iterate on an existing draft — tightening the schedule run by run — without discarding manual pins or accepted placements. The results banner and warning list give you full visibility into every decision the scheduler made, so you can trust the output and act on any issues before publishing.

  • Reads a draft agenda’s criteria — rules, formats and durations, day start and end — and places sessions into rooms and time slots.
  • Enforces two hard constraints every time: a speaker cannot be in two rooms at the same time, and a room hosts one session per time slot.
  • Weighs your scheduling rules (keep a track in one room, avoid parallel topics, balance days) to pick the best slot among the valid ones, and scores every placement.
  • Explains each placement — the rules it satisfied — and lists any session it could not fit.

The Scheduler never changes the agenda on its own. Every proposed change waits in the draft until you apply it.

  1. Open Agents in the event sidebar.
  2. On the Scheduler card, switch the toggle on. The card’s chip changes from Setup to On, and Active agents at the top of the page counts it.
  3. Click the card to open its panel. Settings explains how the Scheduler works and opens the agenda; Activity lists the drafts it has scheduled.

Until the Scheduler is on, its button in the agenda’s sidebar is disabled with the hint Enable the Scheduler agent in Agents to use this feature.

The Scheduler has no settings of its own on the Agents page — the draft is the setting. From its panel:

  • Works from your agenda describes what it reads: a draft agenda’s criteria, rules, formats and durations, day start and end.
  • Run Scheduler → Open agenda takes you to the agenda with the Scheduler panel open.

In the agenda, the Scheduler panel is the wand button at the top of the right-hand sidebar, in the Week and Day views. Its header reads Scheduling against the draft you are working in, with a Generated or Not generated badge, and Change or New draft to switch drafts. The Configure tab holds the draft’s criteria:

  • Hard constraints — the two system rules, always enforced, plus any conflict rule you have set to enforced.
  • Schedule window — the day’s start and end times and the slot interval.
  • Sessions to include — which session statuses the Scheduler may place.
  • Format durations — how many minutes each session format runs.
  • Room visibility — all rooms, or a chosen set.
  • Scheduling behavior — Ignore existing times and Ignore assigned rooms, so the Scheduler can start from a blank grid instead of keeping what is already placed.
  • Scheduling rules — the soft rules, each with a weight from 1 to 15: Group by Track, Avoid Parallel Topics, Balance Tracks Across Days, Balance Sessions Per Day, Workshops in Morning, Minimize Wasted Seats and Room Variety. A higher weight means a stronger preference. The footer counts the active rules, criteria and hard constraints.
  • Event criteria — your agenda’s conflict rules, attached to the draft.
  1. In the agenda, open a draft (or create one with New draft) and open the Scheduler panel.
  2. Check the Configure tab, then click Generate Agenda. The calendar updates only after generation finishes.
  3. The draft’s badge changes to Generated, the calendar fills with the proposed placements, and the panel switches to Explain.

Generating again replaces the previous proposal in the draft, including placements you moved by hand — make your manual adjustments after the last run you intend to do.

  • On the calendar — the draft’s Week and Day views show every proposed placement in its room and slot, under the banner You are viewing a draft of your agenda. The Conflicts tab counts anything in the draft that breaks a conflict rule.
  • In Explain — Last Run shows how many sessions were Placed, the proposal’s total Score and how many were Skipped. Below it, each day lists its placements: time, room, title, the placement’s score and the rules it satisfied — for example Groups track together. Balances day load. A Could Not Schedule section lists sessions with no valid slot and why.
  • On the Scheduler’s panel — Activity lists each draft with its runs, proposed changes and applied changes.

The proposal is a draft until you say otherwise:

  • Move or resize a placement on the draft calendar to override the Scheduler for that session. Your change stays in the draft.
  • Adjust the criteria — raise a rule’s weight, change a duration, remove a room — and Generate Agenda again.
  • When the draft looks right, click View & Commit Changes in the banner. The Draft changes page lists every difference between the draft and your live agenda; keep or remove each one, then Commit changes. Only the accepted changes land on the primary agenda and in embeds and integrations.
  • Back to Agenda leaves the draft where it is and returns you to the live schedule.

The Activity tab on the Scheduler’s panel lists every draft it has worked on, with the number of runs, proposed changes and applied changes. Click a draft to open it in the agenda. In the agenda, the Explain tab shows the latest run for the draft you have open.

Get release notes by email

A short digest on the days something new goes live — each change with a link to its note in the release notes. No marketing, and one click to stop.

Company email addresses only. We’ll send one email to confirm it’s you. Already use Sessionboard? You can also turn this on under Community → What’s new.