エージェントの基本:呼び出し・持ち物・スロット・設定
入門エージェント更新日:2026年11月13日
ひとことで言うと
エージェントは、MakeCodeのプログラムで動かせる相棒のロボットです。移動・ブロックの設置や破壊・アイテムの受け渡しなどを、命令どおりに実行します。
この記事で使うブロック
エージェントとは
エージェントは、プログラムの命令どおりに動くロボットです。プレイヤーの代わりに、ブロックを置いたり、壊したり、畑を耕したりします。
まずは呼び出す
「エージェントを自分の位置にもどす」を実行すると、エージェントがプレイヤーのところへ来ます。エージェントを使うプログラムを作るときは、このブロックのチャットコマンドを最初に1つ作っておくのがおすすめです。
持ち物とスロット
エージェントは、自分の持ち物(インベントリ)を持っています。エージェントを右クリックすると、エージェントとプレイヤーの持ち物の画面が開き、アイテムを渡せます。持ち物の左上がスロット番号1です。
ブロックを置かせるときは、有効にしているスロットのアイテムが使われます。プログラムで持たせることもできます。
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)
})
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本できます。
よく使うブロック
- 移動させる・向きを変える:動きの基本です。
- 置かせる・破壊させる・耕させる:周りに働きかけます。
- 検知する:となりにブロックがあるかを調べ、条件分岐に使います。
- 設定を追加:「移動しながら置く」「障害物を破壊する」などをまとめて切り替えます。
エージェントが動かないとき
進む先がブロックでふさがれている、持ち物が空、別のエージェントを見ている、などがよくある原因です。くわしくはエージェントが動かないときで解説しています。
よくある質問
Q. エージェントに持ち物を渡すにはどうしますか?
A. エージェントを右クリックすると持ち物の画面が開き、プレイヤーの持ち物から渡せます。プログラムで「アイテムを持たせる」ブロックを使う方法もあります。
Q. エージェントが見つかりません。
A. 「エージェントを自分の位置にもどす」ブロックを実行すると、プレイヤーのところへ戻ってきます。