diff --git a/akka-docs/rst/scala/agents.rst b/akka-docs/rst/scala/agents.rst index 3724b6dcd2..107d04f2de 100644 --- a/akka-docs/rst/scala/agents.rst +++ b/akka-docs/rst/scala/agents.rst @@ -29,7 +29,13 @@ that transaction. Agents are integrated with Scala STM - any dispatches made in a transaction are held until that transaction commits, and are discarded if it is retried or aborted. +.. note:: + Agents are local to the node on which they are created. This implies that you + should generally not include them in messages that may be passed to remote Actors + or as constructor parameters for remote Actors; those remote Actors will not be able to + read or update the Agent. + Creating Agents ============================