push

The push command is used to register an agent. This command will create a new agent if it doesn’t already exist, or update an existing agent if it does.

bash

blocks push <relative-path-to-filename>

If your folder structured looked like the following:

.blocks/
    your_agent/
        filename.py

You’d run:

bash

blocks push .blocks/your_agent/filename.py

When you change your agent’s pip or plugins dependencies, the command may take a few minutes to complete, since we need to build a runtime for your agent. Subsequent pushes will execute immediately, assuming the dependencies have not changed.

The name of an agent is specified in the agent decorator. This is used to identify an agent and must be unique per workspace. Changing this will create a new agent.