The tool editor
The tool editor makes and changes tools with a form. Open it with New tool on the Tools page (or on one of your packs), or with Edit next to a tool in one of your packs.
Where it goes
Choose the pack for the tool, or A new pack… and type a name for it. A tool you're changing stays in its pack.
Form or TOML
The switch at the top shows the tool as a Form or as TOML, the text that's saved in the pack file. Change either one; the other follows. Problems show below as you type.
About the tool
- Name (what the AI calls): letters, numbers,
_and-, likedisk_usage. It must be different from every other tool. - Title (optional): a friendlier name for people, like "Disk usage".
- What it does, for the AI: the description. The AI reads it to decide when to use the tool, so say what it does and when it's useful.
What it runs
Choose one:
- Runs a program: a program and its arguments, like
du -sh {{ folder }}. - Runs a script: code in a language you pick, like Shell, PowerShell or Python.
- Calls a web address: a web request, with a method, headers and a body.
For programs and scripts, choose which systems each version is for, and use Add a version for another system to give Windows, say, its own version. See Programs, scripts and web requests and Versions for each system.
Parameters
What the AI fills in. Write {{ name }} where each value goes. See Parameters.
What it can change
- Only looks: reads or shows information and never changes anything.
- Makes changes: creates or changes things, but doesn't delete or overwrite them.
- Can delete or overwrite: removes or replaces files, data or settings.
This decides whether the tool asks first. See What a tool can change.
Try it
Fill in the parameters and click Run. The tool runs exactly as it is in the form, through your permissions, your allowed folders and the activity log, but nothing is saved. A tool that would ask first asks here too.
Save, Cancel and Delete
- Save writes the tool into its pack. Your AI apps can use it right away.
- Cancel leaves without saving. If you changed something, it asks first.
- Delete (for a saved tool) removes it from its pack, after you confirm.