Tool

Tools are instruments that allow AI Agents do things. They way they operate is that we send an LLM a request, and in that request we include the possible actions we have available for taking. The LLM will not execute any action (Forma does it afterwards) but it can decide which tool and its arguments.

The purpose of this Tool object is to describe the possible actions to the LLM, so it can decide.

Full Specification

name: string
description: string # optional
tool: ToolRunner
just_for: 
	- string
	- ...

name

The name of the tool. Should be descriptive to the LLM so it can discriminate between tools.

(Misleading names just cause confusion)

description (optional)

A more detailed description of the tool, for the LLM to discriminate between options.

tool

The Tool that will be executed if the this tool is selected.

just_for

The roles that are allowed to use this tool. If empty, everyone is allowed to use it; if not, only the specific roles in here are allowed to use it.