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

入門エージェント更新日: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. 「エージェントを自分の位置にもどす」ブロックを実行すると、プレイヤーのところへ戻ってきます。

執筆:鈴木孝昌官公庁のWeb・システム開発を担当する現役プロジェクトマネージャー。マイクラカップ沖縄代表チームを指導(第6回・第7回、第7回TBS賞)。
沖縄マイクラ部で、子どもたちにMakeCodeを教えています。プロフィールと編集方針
Instagramで教室の様子を見る
noteで記事を読む