Deployment and Versioning
How saving, testing, deploying, and linking courses work.
How deployment works
Every assistant has two version counters: Test Version (increments each time you save) and Deployed Version (increments each time you deploy). When Test Version is ahead of Deployed Version, you have saved edits that learners cannot see yet. You see the test version in the creator dashboard. Learners see the deployed version.
A Deployed Version of 0 means the assistant has never been deployed. Learners cannot access it regardless of access level.
When you deploy:
- Deployed Version advances to match Test Version
- The new configuration goes live for all learners immediately
- The pending changes indicator clears
There is no review step and no rollback. Deployment is immediate.
An assistant starts in Draft status (never deployed, not accessible to learners). It moves to Active on first deploy. You cannot set it back to Draft.
Testing before deploying
Use the Test Assistant to check behaviour before deploying. The Test Assistant runs your current test configuration but is only accessible to you. Test with realistic learner inputs, especially at edge cases and branching points.
Linking multiple courses
An assistant is created inside one course (its "primary" course), but you can link it to additional courses. All linked courses become part of the assistant's knowledge base.
Use cases:
- A cross-functional assistant that draws from both a strategy course and a finance course
- A programme-level assistant that covers content across multiple modules
- An assistant that references a shared methodology library alongside the specific course
Every linked course must be compatible with the assistant's access level. If your assistant is Restricted and you try to link it to a Private course, it will fail.
Common mistakes
Deploying before testing
There is no rollback. Always run through the Test Assistant before deploying. It runs your current test version without affecting what learners see.
Linking an assistant to a more restrictive course
If your assistant is Restricted and you try to link a Private course, it will fail. The assistant's access level cannot be more permissive than any of its linked courses.