Tools
A tool is something an agent is given so it can do more than work in its folder. Today there are two kinds: a tool that makes images, and a tool that transcribes a recording.
Tool or module
Section titled “Tool or module”A module is what a machine can do. A tool is what an agent is given, built on a module.
You add the fal module to a machine once. Then you make as many image tools on it as you like, each with its own name, description and settings: a fast cheap one for drafts, a better one for finished pictures. The agent reads the descriptions and picks.
A tool runs on the machine it was made on, whichever machine the agent is on.
What you need
Section titled “What you need”- To make tools, you must be an owner of the space. In your personal space you are.
- For an image tool: a machine with the fal module and a key.
- For a transcription tool: a machine with Parakeet, or with ElevenLabs and a key.
Make a tool
Section titled “Make a tool”- Open the menu on your name and choose Tools. If you are in more than one space, pick the space at the top.
- Choose Add a tool.
- Fill in the fields below and choose Add tool.
| Field | What it is |
|---|---|
| What it does | Makes images or Transcribes. It cannot be changed after the tool is added. |
| Name | What the agent calls it: lowercase letters, digits and underscores, starting with a letter, such as flux_fast. |
| Description | The agent reads this to choose between its tools. Say what it is good for and when to use it. |
| Where it runs | The Machine, the Connection on it, and that module’s options, such as the model and the image size. |
| Agent may change this | Shown beside an option the agent is allowed to set itself, such as the size of an image. Everything else is fixed for every use. |
| Ask before each use | Every use waits for a person’s approval. |
You should see the tool in the list, with where it runs and No agent has it yet.
Give a tool to an agent
Section titled “Give a tool to an agent”- Open the agent’s card: in the project menu choose About followed by its name.
- Under Tools, tick the tool.
You should see the agent’s name after Used by on the Tools page. Manage tools on the card takes you back to the list.
Ask before each use
Section titled “Ask before each use”With Ask before each use on, every use shows an approval card with what the agent wants to make or which file it wants to transcribe, and waits for Allow or Deny. This holds whatever the agent’s permissions are, including Auto. It suits tools that cost money per use. See Approvals.
What the agent can do with it
Section titled “What the agent can do with it”An image tool. The agent describes the picture and gets the files back. The people in the project see the images in the agent’s steps. For an agent with Full access, the files are also saved in an images folder inside the agent’s folder. For Read-only and Chat only agents nothing is written to the folder.
A transcription tool. The agent names an audio or video file and gets the transcript back as text. The file can be at most 20 MB. A Full agent can name any file it can reach; other agents only files inside their folder. With Parakeet, only the first 10 minutes of a recording are transcribed.
If the tool’s machine is offline, the tool fails and the agent is told so. There is no fallback to another machine.
Spending
Section titled “Spending”An image tool on fal is billed to the fal key it uses. To limit it, set a monthly cap in US dollars on that key; see fal. Transcription with ElevenLabs is billed to the ElevenLabs key. Parakeet runs on your machine.
Change or delete a tool
Section titled “Change or delete a tool”On the Tools page, Edit changes everything except what the tool does. Delete takes it away from every agent that has it. Images it already made stay.