# エージェントでブロックを検知する（agent.detect）

> エージェントが隣接している指定した方向のマスに、ブロックが存在するかどうかを検知する。

- カテゴリ：エージェント（agent）
- ブロック：エージェントの前 にブロック がある
- URL：https://makecode.minecraft-okinawa.com/reference/agent/detect/
- 公式データ取得日：2026-11-13
- 動作確認：確認待ち

## JavaScript

```javascript
agent.detect(AgentDetection.Block, FORWARD)
```

## Python

```python
agent.detect(AgentDetection.BLOCK, FORWARD)
```

## 引数

| 名前 | 値 | 意味 |
|---|---|---|
| kind | AgentDetection | エージェントが検出しようとするもの |
| direction | 方向 | 検出を実施する方向。たとえば：SixDirection.Forward |

## 使用例

### エージェントの前にレッドストーンがあると、ゲーム内のチャットにメッセージを表示させる。

```javascript
if (agent.detect(AgentDetection.Redstone, FORWARD)) {
    player.say("Agent found redstone!");
}
```

```python
if agent.detect(AgentDetection.REDSTONE, FORWARD):
    player.say("Agent found redstone!")
```

## くわしい解説

「もし〜なら」と組み合わせると、エージェントが周りを調べて行動を変えるプログラムが作れます。迷路を自動で進ませる作品の基本になるブロックです。

## よくあるミス

- 調べるのは、エージェントのすぐとなりの1マスだけです。
- 空気や水はブロックとして検知されません。

## 出典

- [MakeCode for Minecraft 公式リファレンス（agent.detect）](https://minecraft.makecode.com/reference/agent/detect)

執筆：鈴木孝昌（現役プロジェクトマネージャー／マイクラカップ指導者）／運営：沖縄マイクラ部 プログラミングスクール「クロスウェーブ」（https://minecraft-okinawa.com/）