# MakeCodeのエージェント実習：移動・設置・障害物の検知

- URL: https://maikurabu.jp/education/agent/
- 対象の版: 教育版

> エージェントを呼び出してから、持ち物を入れ、スロットを選び、向きに合わせて動かします。3マスの線を作って一つずつ確かめます。

## エージェントを動かすブロック

| ブロック・API | 先に決めること | 確かめる結果 |
|---|---|---|
| `teleportToPlayer` | 立ち位置と周囲の空き | エージェントが近くに来る |
| `move` / `turn` | エージェント自身の前方と距離 | 進む向きが変わる |
| `setItem` / `setSlot` | 材料・個数・スロット番号 | 選んだ場所に材料が入る |
| `place` | 置く方向と材料 | となりのマスに置かれる |
| `detect` | 調べる種類と方向 | 条件分岐に使える真偽値が返る |

## 3マスの目印を作る

練習用の平地で、周囲に人や建築がない場所を使います。次の例はエージェントが前に進んだあと、直前にいたマスへ後ろ向きにブロックを置きます。地面を入れ替える必要はありません。

```typescript
player.onChat("trail", function () {
    agent.teleportToPlayer()
    agent.setItem(STONE, 3, 1)
    agent.setSlot(1)
    for (let step = 0; step < 3; step++) {
        if (!agent.detect(AgentDetection.Block, FORWARD)) {
            agent.move(FORWARD, 1)
            agent.place(BACK)
        }
    }
})
```

最初は `step < 1` に変えて1回だけ試し、前進と設置を確認します。高さが違うと歩けない場合があるので、まず平らな場所で試します。

## 動かないときの調べ方

1. 呼び出しだけのコードで、実行できるか確認する。
2. 進まないならエージェントの前にブロックがないかを見る。
3. 進むのに置かないなら、選んだスロットの材料、置く方向、置き先の空き、ワールドの建築権限を確認する。
4. 回数を増やしたら、必要な材料の数も一緒に増やす。

動作を個別に調べるときは、MakeCode大全の [移動](https://makecode.minecraft-okinawa.com/reference/agent/move/)、[設置](https://makecode.minecraft-okinawa.com/reference/agent/place/)、[検知](https://makecode.minecraft-okinawa.com/reference/agent/detect/) を参照できます。

## 出典
- [Microsoft MakeCode · Agent API](https://minecraft.makecode.com/reference/agent)
- [Microsoft MakeCode · Agent Place](https://minecraft.makecode.com/reference/agent/place)
- [Microsoft MakeCode · Agent Detect](https://minecraft.makecode.com/reference/agent/detect)

---
マイクラ部は、MojangおよびMicrosoftとは関係のない非公式のファンサイトです。NOT AN OFFICIAL MINECRAFT PRODUCT. NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.