Skip to content

docs: document Scheduled Tasks (preview)#11126

Merged
keydunov merged 1 commit into
masterfrom
artyom/docs-scheduled-tasks
Jun 19, 2026
Merged

docs: document Scheduled Tasks (preview)#11126
keydunov merged 1 commit into
masterfrom
artyom/docs-scheduled-tasks

Conversation

@keydunov

Copy link
Copy Markdown
Member

Check List

  • Tests have been run in packages where changes have been made if available
  • Linter has been run for changed code
  • Tests for the changes have been added if not covered yet
  • Docs have been added / updated if required

Description of Changes Made

Adds a docs page for the Scheduled Tasks preview feature.

Scheduled Tasks let a user save a natural-language prompt for the agent and have Cube run it automatically on a cron schedule (or on demand), producing an Analytics Chat thread per run.

The new page (docs-mintlify/docs/explore-analyze/scheduled-tasks.mdx) covers:

  • A required preview <Warning> callout directing users to Cube support for activation
  • Task anatomy (name, description, instructions, schedule, enabled)
  • Schedule options (Manual / Hourly / Daily / Weekly / Monthly / Custom cron + timezone)
  • Management actions (create, edit, enable/pause, run now, delete)
  • Output as Analytics Chat threads, run under the creator's security context
  • Conversational management via Analytics Chat
  • Preview limitations (no email/Slack delivery, no missed-run catch-up, no run-history view)

It's wired into the Explore & Analyze nav group in docs.json, next to Analytics Chat.

Reviewer notes

  • Per docs conventions: no internal feature-flag or agent-tool names are exposed; uses "the agent" / "Analytics Chat" naming.
  • Screenshot is left as a {/* TODO */} placeholder pending an asset.

🤖 Generated with Claude Code

Add a docs page for the Scheduled Tasks preview feature, which lets users
save a natural-language agent prompt and run it on a schedule (or on
demand), producing an Analytics Chat thread per run. Covers the task
anatomy, schedule options, management actions, output, conversational
management, and preview limitations. Wire the page into the
Explore & Analyze nav group next to Analytics Chat.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@claude

claude Bot commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

Claude finished @keydunov's task in 1m 7s —— View job


Code Review

Overall: clean, well-scoped docs page that follows the docs-mintlify/CLAUDE.md conventions correctly. Approving in spirit — no blocking issues.

Verdict: LGTM — 0 high, 0 medium, 2 low (nits)

Conventions check

  • Lives under docs-mintlify/ (active site), not legacy /docs
  • Required preview <Warning> placed right after frontmatter, mentions support team ✓
  • No H1 in body — frontmatter title is the heading ✓
  • Internal links are root-relative ✓
  • No internal feature-flag / agent-tool names exposed ✓
  • Screenshot placeholder uses MDX comment per convention ({/* TODO: screenshot — ... */}) ✓
  • Wired into docs.json under Explore & Analyze, next to Analytics Chat ✓
  • All cross-links resolve to existing pages (analytics-chat.mdx, scheduled-refreshes.mdx, workbooks/, admin/account-billing/support.mdx) ✓
  • docs.json diff is a single-line addition, valid JSON ✓

Nits (low priority, optional)

  1. docs-mintlify/docs/explore-analyze/scheduled-tasks.mdx:77[save results to a Workbook](/docs/explore-analyze/workbooks) links to the directory. Mintlify will resolve this to workbooks/index.mdx, but other pages in this folder tend to deep-link to the specific child page (e.g. workbooks/index). Worth verifying the rendered link lands where you want.

  2. scheduled-tasks.mdx:33 — TODO screenshot placeholder is acknowledged in the PR description. Just flagging so it doesn't ship to public docs forgotten. Consider tracking the asset capture as a follow-up.

Praise

  • Concrete example at line 20-22 ("every weekday at 9am…") makes the feature land immediately.
  • The "Managing tasks from chat" section is a nice touch — surfaces the conversational entry point without duplicating the Analytics Chat docs.
  • "Preview limitations" section sets expectations honestly (no email/Slack, no catch-up, no run-history). Good practice for preview features.
• Branch: `artyom/docs-scheduled-tasks`

@mintlify

mintlify Bot commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
cubed3 🟢 Ready View Preview Jun 19, 2026, 9:01 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@keydunov keydunov merged commit 31ad8db into master Jun 19, 2026
14 checks passed
@keydunov keydunov deleted the artyom/docs-scheduled-tasks branch June 19, 2026 21:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant