Docs
  • Solver
  • Models
    • Field Service Routing
    • Employee Shift Scheduling
    • Pick-up and Delivery Routing
  • Platform
Try models
  • Timefold Platform
  • How-tos
  • Timefold Copilot (preview)

Timefold Platform

    • Introduction
    • Scheduling API concepts
    • Getting started with the Timefold Platform
    • Platform concepts
    • Models
      • Model catalog and documentation
      • Model maturity and versioning
      • Trialing Timefold models
    • How-tos
      • Dataset lifecycle
      • Interpreting dataset results
      • Configuration parameters and profiles
      • Reviewing the audit log
      • Searching and categorizing datasets for auditability
      • Member management and roles
      • Secrets management
      • Solve queue
      • Using the maps service
      • Comparing datasets (preview)
      • Insights (preview)
      • Timefold Copilot (preview)
      • Real-time planning with /from-patch (preview)
    • Job-oriented guides
      • Balancing different optimization goals
      • Validating an optimized plan with Explainable AI
      • Uncovering inefficiencies in operational planning
      • Responding to disruptions with real-time planning
      • Designing better routing plans with (just enough) traffic awareness
    • API integration
      • Model API usage
      • Receiving model API results
        • Webhooks
        • Server sent events (SSE)
        • Polling
      • Handling changes to your planning data
      • Integration scenarios
        • Multiple environments and clusters
        • Data residency requirements
        • Air-gapped environments
      • Platform API usage
    • Changelog
    • Feature requests
    • Pricing plans and capabilities
    • Self-Hosted
      • Self-Hosted vs. Timefold Cloud Platform
      • Installation instructions
      • Upgrade instructions
      • Troubleshooting
    • Support
      • Contacting support
      • Platform status
      • Troubleshooting
    • Trust
      • Risk profile
      • Product security
      • Data security
      • Legal and privacy
      • AI legislation compliance
      • Trust center

Timefold Copilot (preview)

This guide describes functionality that is currently available as a preview feature. If you’d like early access to this feature, contact us.

Timefold Copilot lets you interact with your planning models in plain language. Instead of digging through JSON or writing queries, you describe what you want to understand or explore, and the Copilot handles the translation.

Available skills

Explain bottlenecks

Ask the Copilot to analyze a dataset and explain what is limiting your planning solution. You can ask questions like "Why are 12 shifts left unassigned on Friday?" or "Which constraint is being broken most often?", and get a plain-language answer without having to interpret score analysis manually.

The skill also suggests follow-up experiments based on what it finds, so you can move directly from understanding the problem to testing a solution.

Start a what-if experiment

Describe a change to your planning problem in plain language, and the Copilot sets up the scenarios and runs them in parallel using the Timefold Experiments API. You get a side-by-side comparison without having to configure or trigger each dataset manually.

The Copilot supports the following experiment types:

Goal alignment

Verify whether the model is optimizing toward the outcome you actually care about. Useful when you suspect constraint weights or priorities may not reflect real-world needs.

What-if scenarios

Explore how a change in the planning problem affects the outcome. For example: "What happens if workload increases by 20%?", "What if this employee is unavailable all week?", or "What if we add a required skill to this shift category?"

Getting started

Once you have access to the preview, you will receive setup instructions for the available skills.

  • © 2026 Timefold BV
  • Timefold.ai
  • Documentation
  • Changelog
  • Send feedback
  • Privacy
  • Legal
    • Light mode
    • Dark mode
    • System default