This sections indicates how to migrate your assistant to a new Botfront version.
As we haven’t reached 1.x minor versions are considered major and could have breaking changes.
Botfront and Rasa versions compatibility
Minor upgrades are generally seamless.
You can run
botfront upgrade in your terminal.
You can upgrade our Helm Charts.
Make sure you install the same chart versions
Although we offer seperate charts for the Botfront framework and Rasa itself, they both have the same version. Installing the same chart version for both Botfront and Rasa ensures that Rasa and Botfront versions are compatible.
When upgrading to a major version, always flush locally build images as follow:
docker rmi <folder_name>_rasa # e.g. docker rmi my_project_rasadocker rmi <folder_name>_actions
In Settings > Endpoints, replace:
tracker_store:store_type: rasa_addons.core.tracker_stores.AnalyticsTrackerStoreurl: 'http://botfront-api:8080'project_id: 'bf'
tracker_store:store_type: 'rasa_addons.core.tracker_stores.botfront.BotfrontTrackerStore'url: 'http://botfront:3000/graphql' # Or the appropriate custom URL
We significantly changed (and improved) how bot responses work. Only three types remain:
- Text with buttons
If you were using other response types (mostly facebook related such as Templates, Lists, …) they will be lost. You need to make a copy before upgrading.
The project structure has changed
You will need to create another project and copy your data in it:
- Create a new project with
- Copy the
botfront-dbfolder from your old project to the newly created project. Make sure to copy and not move your db so you can always recover it from your existing project. Your existing project should remain unchanged.
- If you have custom actions, copy them to the
actionsfolder in the new project.
- Run your project with
botfront up. At this point, you should be able to log in.
- Go to
Settings > EndpointsIf you are running with the default CLI configuration, replace:
nlg:type: "rasa_addons.core.nlg.GraphQLNaturalLanguageGenerator"url: "http://botfront:3000/graphql" # This should be the same host as the Botfront app
- Restart Rasa with
botfront restart rasa
- You’re done, have fun :)
Always check that the Botfront and Rasa versions you install are compatible.
You can check this file to find out which version of Rasa corresponds to the Botfront version you are upgrading to:
vX.X.X with your version, e.g: