docs: update agent control tutorial with entity class details and examples

Author: shima004

docs/source/tutorial/agent/agent_control.md

@@ -130,81 +130,96 @@ python main.py
 
 ## `Human Detector` モジュールの実装で使用するクラス・メソッド
 
-### WorldInfo
-
-`WorldInfo` クラスは，エージェントが把握している情報とそれに関する操作をおこなうメソッドをもったクラスです． エージェントはこのクラスのインスタンスを通して，他のエージェントやオブジェクトの状態を確認します．
+### Entity
 
-モジュール内では，`WorldInfo` クラスのインスタンスを `self._world_info` として保持しています．
+`Entity` クラスは，エンティティの基底クラスです． このクラスは，エンティティの基本情報を保持します．
 
-### AgentInfo
+RRS上のエンティティは下図のように `Entity` を継承したクラスで表現されています． 赤枠で囲まれたクラスは，クラスの意味がそのままRRSの直接的な構成要素を表しています．
 
-`AgentInfo` クラスは，エージェント自身の情報とそれに関する操作をおこなうメソッドをもったクラスです． エージェントはこのクラスのインスタンスを通して，エージェント自身の状態を取得します．
+例: Road クラスのインスタンスの中には， Hydrant クラスを継承してない通常の道路を表すものも存在しています．
 
-モジュール内では，`AgentInfo` クラスのインスタンスを `self._agent_info` として保持しています．
+![エンティティの継承関係](./../../images/entity.png)
 
 ### EntityID
 
 `EntityID` クラスは，全てのエージェント/オブジェクトを一意に識別するためのID(識別子)を表すクラスです． RRSではエージェントとオブジェクトをまとめて，エンティティと呼んでいます．
 
-- 自分自身のエンティティIDを取得する
+### Civilian
+
+`Civilian` クラスは，市民を表すクラスです．このクラスからは，エージェントの位置や負傷の進行状況を取得することができます．
+
+- `entity` が市民であるかどうかを判定する
 
 ```python
-self._agent_info.get_entity_id()
+isinstance(entity, Civilian)
 ```
 
-### Entity
+- エンティティIDを取得する
 
-`Entity` クラスは，エンティティの基底クラスです． このクラスは，エンティティの基本情報を保持します．
+```python
+entity.get_id()
+```
 
-- エンティティIDからエンティティを取得する
+- 市民が生きているかどうかを判定する
 
 ```python
-self._world_info.get_entity(entity_id)
+hp: Optional[int] = entity.get_hp()
+if hp is None or hp <= 0:
+    return False
 ```
 
-- 同じクラスのエンティティを全て取得する
+- 市民が埋まっているかどうかを判定する
 
 ```python
-self._world_info.get_entities_by_type([Building, Road])
+buriedness: Optional[int] = entity.get_buriedness()
+if buriedness is None or buriedness <= 0:
+    return False
 ```
 
-### Civilian
+### WorldInfo
 
-`Civilian` クラスは，市民を表すクラスです．このクラスからは，エージェントの位置や負傷の進行状況を取得することができます．
+`WorldInfo` クラスは，エージェントが把握している情報とそれに関する操作をおこなうメソッドをもったクラスです． エージェントはこのクラスのインスタンスを通して，他のエージェントやオブジェクトの状態を確認します．
 
-- `entity` が市民であるかどうかを判定する
+モジュール内では，`WorldInfo` クラスのインスタンスを `self._world_info` として保持しています．
+
+- エンティティIDからエンティティを取得する
 
 ```python
-isinstance(entity, Civilian)
+self._world_info.get_entity(entity_id)
 ```
 
-- 市民が生きているかどうかを判定する
+- 指定したクラスのエンティティを全て取得する
 
 ```python
-hp: Optional[int] = entity.get_hp()
-if hp is None or hp <= 0:
-    return False
+self._world_info.get_entities_by_type([Building, Road])
 ```
 
-- 市民が埋まっているかどうかを判定する
+- エージェントの位置から指定したエンティティまでの距離を取得する
 
 ```python
-buriedness: Optional[int] = entity.get_buriedness()
-if buriedness is None or buriedness <= 0:
-    return False
+self._world_info.get_distance(me, civilian.get_id())
 ```
 
-### entityの継承
+[詳細はこちら](../../adf_core_python.core.agent.info.rst)
+
+### AgentInfo
 
-RRS上のエンティティは下図のように Entity を継承したクラスで表現されています． 赤枠で囲まれたクラスは，クラスの意味がそのままRRSの直接的な構成要素を表しています．
+`AgentInfo` クラスは，エージェント自身の情報とそれに関する操作をおこなうメソッドをもったクラスです． エージェントはこのクラスのインスタンスを通して，エージェント自身の状態を取得します．
 
-例: Road クラスのインスタンスの中には， Hydrant クラスを継承してない通常の道路を表すものも存在しています．
+モジュール内では，`AgentInfo` クラスのインスタンスを `self._agent_info` として保持しています．
 
-![エンティティの継承関係](./../../images/entity.png)
+- 自分自身のエンティティIDを取得する
+
+```python
+self._agent_info.get_entity_id()
+```
+
+[詳細はこちら](../../adf_core_python.core.agent.info.rst)
 
 ## `Human Detector` モジュールの実装
 
 `Human Detector` モジュールの実装を行います．
+以下のコードを`fire_brigade_human_detector.py` に記述してください。
 
 ```python
 from typing import Optional
@@ -289,3 +304,12 @@ class SampleHumanDetector(HumanDetector):
         """
         return self._result
 ```
+
+シミュレーションサーバーを起動し，エージェントを実行してみましょう．
+
+```bash
+cd WORKING_DIR/<your_team_name>
+python main.py
+```
+
+埋没している市民を消防隊エージェントが救出できるようになっていれば成功です．