# エージェントの基本：呼び出し・持ち物・スロット・設定

> エージェントは、MakeCodeのプログラムで動かせる相棒のロボットです。移動・ブロックの設置や破壊・アイテムの受け渡しなどを、命令どおりに実行します。

- URL：https://makecode.minecraft-okinawa.com/basics/agent/
- 更新日：2026-11-13

## エージェントとは

エージェントは、プログラムの命令どおりに動くロボットです。プレイヤーの代わりに、ブロックを置いたり、壊したり、畑を耕したりします。

## まずは呼び出す

「エージェントを自分の位置にもどす」を実行すると、エージェントがプレイヤーのところへ来ます。エージェントを使うプログラムを作るときは、このブロックのチャットコマンドを最初に1つ作っておくのがおすすめです。

## 持ち物とスロット

エージェントは、自分の持ち物（インベントリ）を持っています。エージェントを右クリックすると、エージェントとプレイヤーの持ち物の画面が開き、アイテムを渡せます。持ち物の左上がスロット番号1です。

ブロックを置かせるときは、有効にしているスロットのアイテムが使われます。プログラムで持たせることもできます。

```javascript
player.onChat("road", function () {
    agent.setItem(STONE_BRICKS, 64, 1)
    agent.setSlot(1)
    agent.setAssist(PLACE_ON_MOVE, true)
    agent.move(FORWARD, 20)
    agent.setAssist(PLACE_ON_MOVE, false)
})
```

```python
def on_on_chat():
    agent.set_item(STONE_BRICKS, 64, 1)
    agent.set_slot(1)
    agent.set_assist(PLACE_ON_MOVE, True)
    agent.move(FORWARD, 20)
    agent.set_assist(PLACE_ON_MOVE, False)
player.on_chat("road", on_on_chat)
```


このプログラムは、エージェントに石レンガを64個持たせ、「移動しながら置く」設定をオンにして20マス進ませます。道路がまっすぐ1本できます。

## よく使うブロック

- 移動させる・向きを変える：動きの基本です。
- 置かせる・破壊させる・耕させる：周りに働きかけます。
- 検知する：となりにブロックがあるかを調べ、条件分岐に使います。
- 設定を追加：「移動しながら置く」「障害物を破壊する」などをまとめて切り替えます。

## エージェントが動かないとき

進む先がブロックでふさがれている、持ち物が空、別のエージェントを見ている、などがよくある原因です。くわしくは[エージェントが動かないとき](https://makecode.minecraft-okinawa.com/troubleshooting/agent-not-moving/)で解説しています。

## よくある質問

### Q. エージェントに持ち物を渡すにはどうしますか？

A. エージェントを右クリックすると持ち物の画面が開き、プレイヤーの持ち物から渡せます。プログラムで「アイテムを持たせる」ブロックを使う方法もあります。

### Q. エージェントが見つかりません。

A. 「エージェントを自分の位置にもどす」ブロックを実行すると、プレイヤーのところへ戻ってきます。

## 出典

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

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