Minecraft Wiki
This page describes an education-related feature. 
This feature is available only in Minecraft Education or when enabling the "Education" option in Bedrock Edition.

In Minecraft Education and Bedrock Edition worlds connected to a WebSocket server, the agent is a mob that helps players learn coding, by allowing players to program actions into it. The agent can be programmed to execute several tasks, like planting and harvesting, mining, and building.

In a Bedrock Edition world not connected to a WebSocket server, it is unused and thus has no AI unless spawned by putting the command execute @p ~ ~ ~ agent create or in 1.19.10+ you can summon with execute as @p run agent create into an NPC, but can still store items given to it by the player in its inventory. It can also teleport between dimensions with the player. It can be spawned using its spawn egg, obtainable with /give @s spawn_egg 1 56 .


In Minecraft Education, the agent is used in conjunction with Code Connection for Minecraft / Code Builder, and is programmable by a visual programming language.

In Minecraft Education and Bedrock Edition, the agent can be used in conjunction with WebSocket servers.

The agent carries its own 27-item inventory, which can be manipulated by commands that the player programs it to use, or edited directly by a GUI that the player can access in-game, in any dimension.

The visual interface allows the player to drag and drop commands, structural constructs and other components into a sequence, and associate the sequence with a custom-named slash command, which can be executed in the traditional way, from the console.

The agent can push push pressure plates. It can interact with buttons, levers, and other right-click mechanisms like doors and fence gates.

Agent commands[]

  • attack <direction>
  • destroy <direction>
  • drop <int:slotNum> <int:quantity> <direction>
  • drop all <direction>
  • move <direction>
  • turn <turnDirection>
  • inspect <direction>
  • inspect data <direction>
  • detect <direction>
  • detectredstone <direction>
  • transfer <int:srcSlotNum> <int:quantity> <int:dstSlotNum>
  • create agent
  • remove agent
  • teleport to player
  • teleport to location facing direction
  • collect <string:item>
  • till <direction>
  • place <int:slotNum> <direction>
  • place on move<int:slotNum> <true/false>
  • get item count <int:slotNum>
  • get item space <int:slotNum>
  • get item detail <int:slotNum>

<direction> refers to forward|back|left|right|up|down

<turnDirection> refers to left|right


SoundSourceDescriptionResource locationVolumePitch
Friendly CreaturesWhen an agent is spawnedmob.agent.spawn??

Data values[]


NameIdentifierNumeric ID Translation key


Pocket Edition Alpha
v0.16.0build 1Agent Added agent.
build 2Removed agent.
Pocket Edition
1.0.0alpha agent has been re-added, hidden in a(n) .apk file.
Bedrock Edition
1.8.0beta agent spawn egg texture file.
?Agent can now be spawned by putting the command execute @p ~ ~ ~ agent create into an npc.
Education Edition
1.0.1Agent Added the "learn to code mascot".
1.0.2The entity ID changed has been changed from "learn_to_code_mascot" to "agent".
1.4.0The agent's default name tag color has been changed to blue.
1.7Agent can now be removed through /remove.
Players now can show the agent coordinates on the HUD.
/summon agent now creates or teleports the executor's agent to the executor.
Added spawn eggs for agents. agent no longer has range restrictions. It can move and build far away from the player.
The agent now has an animation for unsuccessful actions.
The agent now chooses which item to detect or interact with in a “line of sight” in the direction the code specified, up to 1 block away.