Improve documentation around how to use agent states

[Robadob]

My dissertation student highlighted some areas where more information is required.

It isn't clear how an agent function is assigned to custom states by default, and how to assign agent function to multiple agent states (e.g. if all states of an agent should run the function).