|
|
|
|
|
|
|
|
|
|
## Migrating from ML-Agents toolkit v0.5 to v0.6 |
|
|
|
|
|
|
|
### Important |
|
|
|
### Important Changes |
|
|
|
|
|
|
|
* Brains are now Scriptable Objects instead of MonoBehaviors. |
|
|
|
* You can no longer modify the type of a Brain. If you want to switch |
|
|
|
|
|
|
leveraging Unity's prefab system or look for all the agents in a scene |
|
|
|
using the search bar of the `Hierarchy` window with the word `Agent`. |
|
|
|
* To update a scene from v0.5 to v0.6, you must: |
|
|
|
* Remove the `Brain` GameObjects in the scene. (Delete all of the |
|
|
|
Brain GameObjects under Academy in the scene.) |
|
|
|
* Create new `Brain` Scriptable Objects using `Assets -> Create -> |
|
|
|
ML-Agents` for each type of the Brain you plan to use, and put |
|
|
|
the created files under a folder called Brains within your project. |
|
|
|
* Edit their `Brain Parameters` to be the same as the parameters used |
|
|
|
in the `Brain` GameObjects. |
|
|
|
* Agents have a `Brain` field in the Inspector, you need to drag the |
|
|
|
appropriate Brain ScriptableObject in it. |
|
|
|
|
|
|
|
__Note:__ You will need to delete the previous TensorFlowSharp package |
|
|
|
and install the new one to do inference. To correctly delete the previous |
|
|
|
TensorFlowSharp package, Delete all of the files under `ML-Agents/Plugins` |
|
|
|
folder except the files under `ML-Agents/Plugins/ProtoBuffer`. |
|
|
|
|
|
|
|
|
|
|
|
* We replaced the **Internal** and **External** Brain with **Learning Brain**. |
|
|
|
When you need to train a model, you need to drag it into the `Training Hub` |
|
|
|
inside the `Academy` and check the `Control` checkbox. |
|
|
|
|
|
|
[Inference Engine](Inference-Engine.md). |
|
|
|
* To use a `.tf` model, drag it inside the `Model` property of the `Learning Brain` |
|
|
|
|
|
|
|
#### Steps to Migrate |
|
|
|
|
|
|
|
* To update a scene from v0.5 to v0.6, you must: |
|
|
|
* Remove the `Brain` GameObjects in the scene. (Delete all of the |
|
|
|
Brain GameObjects under Academy in the scene.) |
|
|
|
* Create new `Brain` Scriptable Objects using `Assets -> Create -> |
|
|
|
ML-Agents` for each type of the Brain you plan to use, and put |
|
|
|
the created files under a folder called Brains within your project. |
|
|
|
* Edit their `Brain Parameters` to be the same as the parameters used |
|
|
|
in the `Brain` GameObjects. |
|
|
|
* Agents have a `Brain` field in the Inspector, you need to drag the |
|
|
|
appropriate Brain ScriptableObject in it. |
|
|
|
* The Academy has a `Broadcast Hub` field in the inspector, which is |
|
|
|
list of brains used in the scene. To train or control your Brain |
|
|
|
from the `mlagents-learn` Python script, you need to drag the relevant |
|
|
|
`LearningBrain` ScriptableObjects used in your scene into entries |
|
|
|
into this list. |
|
|
|
* You will need to delete the previous TensorFlowSharp package |
|
|
|
and install the new one to do inference. To correctly delete the previous |
|
|
|
TensorFlowSharp package, Delete all of the files under `ML-Agents/Plugins` |
|
|
|
folder except the files under `ML-Agents/Plugins/ProtoBuffer`. |
|
|
|
|
|
|
|
|
|
|
|
## Migrating from ML-Agents toolkit v0.4 to v0.5 |
|
|
|