> For the complete documentation index, see [llms.txt](https://docs.artific.nl/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.artific.nl/en/for-administrators/toolbox/elements.md). # Elements An element is one tool in the AI Toolbox. Managed under **AI Toolbox → Elements**. ## Creating an element Choose **Create element**. The settings screen has the element's own properties on the left, and its inputs and template on the right. ### Settings | Field | What it does | | ------------------------- | --------------------------------------------------------------------------------------------------------------------- | | **Name** | What users see on the card. Name it after the job: *Write a rejection letter*, not *Letter tool 2*. | | **Description** | Shown under the name. Say what it produces and when to use it. | | **Category** | Which group it appears under. See [Categories](/en/for-administrators/toolbox/categories.md). | | **Image** | A cover image for the card. Optional but makes a long list far easier to scan. | | **Status** | **Draft** while you build, **Published** when colleagues should see it. | | **Availability** | Whether the element can be shared beyond your organisation. See [Library](/en/for-administrators/toolbox/library.md). | | **Type** | **Text** produces written output; **Image** produces a picture. | | **Model** | Which model runs it. | | **Model temperature** | How much variation to allow. Low for consistent output, higher for creative work. | | **Label as new** | Puts a **New** marker on the card. | | **Mask personal data** | Removes personal data before processing. | | **Enable Knowledge Base** | Lets the element draw on your knowledge base. | {% hint style="info" %} Leave an element on **Draft** until you have tested it. A published element appears in everyone's Toolbox immediately. {% endhint %} ### Advanced settings | Setting | What it does | | --------------------------------------- | ------------------------------------------------------------------------------------- | | **Allowed groups** | Restricts the element to specific user groups. | | **Don't fail if primary model is down** | Falls back to another model during an outage, using the chosen **Fallback strategy**. | ## Inputs: the form the user fills in Each input becomes one field on the element's form. **Create input** adds one. | Field | What it does | | ---------------------- | ------------------------------------------------------------------------------------------------- | | **Name** | The label the user sees. | | **Template reference** | The name you use inside the template to insert this value. Filled in automatically from the name. | | **Type** | What kind of field it is. | | **Required field** | Whether the user must fill it in. | Drag the rows to change the order they appear in. ### Input types | Type | What the user gets | | ---------------------------------------------------- | -------------------------------------------------------------------------------------------------- | | **Text** | A single-line box. | | **Text area** | A multi-line box. **Max row count** sets its height. | | **Number of words** | A number, with **Max word count** as the ceiling. | | **Options** | A dropdown of choices you define. | | **Tone of voice** | A dropdown of your organisation's saved [tones of voice](/en/for-administrators/tone-of-voice.md). | | **Form of address**, **Writing style**, **Language** | Dropdowns filled from your [default values](/en/for-administrators/toolbox/default-values.md). | | **Document** | A file upload. | | **Document (including tables and scanned images)** | A file upload that also handles spreadsheets and tables. Prefer this one. | | **Reference image** | An image upload, for image elements. | | **Audio transcription** | Lets the user record or upload audio, which is transcribed and used as input. | **Max files** limits how many documents can be attached. {% hint style="success" %} Use dropdowns rather than free text wherever the answer comes from a known set. A **Options** or **Writing style** field gives you predictable output; a text box invites someone to type something the template was never designed for. {% endhint %} ## The template The **Template** is the instruction sent to the model, with the user's answers slotted in by their template reference. Write it as you would brief a colleague: * State the task and the audience. * Set the format explicitly: length, structure, whether headings are wanted. * Say what to avoid. * Place the inputs where they belong in the instruction. A template that references an input which does not exist cannot be saved, so remove or rename references when you change an input. ## Trying it Open the element from the Toolbox and run it with realistic inputs. Check what happens with a nearly-empty form and with an unusually long input, not just the ideal case. Then have someone who did not build it try it. If they hesitate over a field, the label needs work. ## Tools and connectors Two further tabs let an element do more than produce text: * **Tools**: switch on tools the element may use while it runs. * **Connectors**: give it access to actions on external servers. Both work exactly as they do for assistants. See [Tools](/en/for-administrators/assistants/tools.md) and [Connectors](/en/for-administrators/assistants/connectors.md). ## Deleting **Delete element** removes it. Anyone who saved results from it keeps those results, but the element itself is gone.