AI-Studio/app/MindWork AI Studio/Plugins/assistants/plugin.lua

174 lines
6.9 KiB
Lua
Raw Normal View History

require("icon")
--[[
This sample assistant shows how plugin authors map Lua tables into UI components.
Each component declares a `UserPrompt` which is prepended as a `context` block, followed
by the actual component value in `user prompt`. See
`app/MindWork AI Studio/Plugins/assistants/README.md` for the full data-model reference.
]]
-- The ID for this plugin:
ID = "00000000-0000-0000-0000-000000000000"
-- The icon for the plugin:
ICON_SVG = SVG
-- The name of the plugin:
NAME = "<Company Name> - Configuration for <Department Name>"
-- The description of the plugin:
DESCRIPTION = "This is a pre-defined configuration of <Company Name>"
-- The version of the plugin:
VERSION = "1.0.0"
-- The type of the plugin:
TYPE = "ASSISTANT"
-- The authors of the plugin:
AUTHORS = {"<Company Name>"}
-- The support contact for the plugin:
SUPPORT_CONTACT = "<IT Department of Company Name>"
-- The source URL for the plugin:
SOURCE_URL = "<Any internal Git repository>"
-- The categories for the plugin:
CATEGORIES = { "CORE" }
-- The target groups for the plugin:
TARGET_GROUPS = { "EVERYONE" }
-- The flag for whether the plugin is maintained:
IS_MAINTAINED = true
-- When the plugin is deprecated, this message will be shown to users:
DEPRECATION_MESSAGE = ""
ASSISTANT = {
["Title"] = "<Title of your assistant>",
["Description"] = "<Description presented to the users, explaining your assistant>",
["UI"] = {
["Type"] = "FORM",
["Children"] = {}
},
}
-- usage example with the full feature set:
ASSISTANT = {
["Title"] = "<main title of assistant>", -- required
["Description"] = "<assistant description>", -- required
["SystemPrompt"] = "<prompt that fundamentally changes behaviour, personality and task focus of your assistant. Invisible to the user>", -- required
["SubmitText"] = "<label for submit button>", -- required
["AllowProfiles"] = true, -- if true, allows AiStudios profiles; required
["UI"] = {
["Type"] = "FORM",
["Children"] = {
{
["Type"] = "TEXT_AREA", -- required
["Props"] = {
["Name"] = "<unique identifier of this component>", -- required
["Label"] = "<heading of your component>", -- required
["UserPrompt"] = "<direct input of instructions, questions, or tasks by a user>",
["PrefillText"] = "<text to show in the field initially>",
["IsSingleLine"] = false, -- if true, shows a text field instead of an area
["ReadOnly"] = false -- if true, deactivates user input (make sure to provide a PrefillText)
}
},
{
["Type"] = "DROPDOWN", -- required
["Props"] = {
["Name"] = "<unique identifier of this component>", -- required
["Label"] = "<heading of your component>", -- required
["UserPrompt"] = "<direct input of instructions, questions, or tasks by a user>",
["ValueType"] = "<data type of item values>", -- required
["Default"] = { ["Value"] = "<internal data>", ["Display"] = "<user readable representation>" }, -- required
["Items"] = {
{ ["Value"] = "<internal data>", ["Display"] = "<user readable representation>" },
{ ["Value"] = "<internal data>", ["Display"] = "<user readable representation>" },
} -- required
}
},
{
["Type"] = "SWITCH",
["Props"] = {
["Name"] = "<unique identifier of this component>", -- required
["Label"] = "<heading of your component>", -- required
["Value"] = true, -- initial switch state
["UserPrompt"] = "<direct input of instructions, questions, or tasks by a user>",
["LabelOn"] = "<text if state is true>", -- required
["LabelOff"] = "<text if state is false>" -- required
}
},
{
["Type"] = "PROVIDER_SELECTION", -- required
["Props"] = {
["Name"] = "Provider",
["Label"] = "Choose LLM"
}
},
-- If you add a PROFILE_SELECTION component, AI Studio will hide the footer selection and use this block instead:
{
["Type"] = "PROFILE_SELECTION",
["Props"] = {
["ValidationMessage"] = "<warning message that is shown when the user has not picked a profile>"
}
},
{
["Type"] = "HEADING", -- descriptive component for headings
["Props"] = {
2026-02-10 16:06:45 +00:00
["Text"] = "<heading content>", -- required
["Level"] = 2 -- Heading level, 1 - 3
}
},
{
["Type"] = "TEXT", -- descriptive component for normal text
["Props"] = {
2026-02-10 16:06:45 +00:00
["Content"] = "<text content>"
}
},
{
["Type"] = "LIST", -- descriptive list component
["Props"] = {
["Items"] = {
{
["Type"] = "LINK", -- required
["Text"] = "<user readable link text>",
["Href"] = "<link>" -- required
},
{
["Type"] = "TEXT", -- required
["Text"] = "<user readable text>"
}
}
}
},
{
["Type"] = "IMAGE",
["Props"] = {
["Src"] = "plugin://assets/example.png",
["Alt"] = "SVG-inspired placeholder",
["Caption"] = "Static illustration via the IMAGE component."
}
},
{
["Type"] = "WEB_CONTENT_READER", -- allows the user to fetch a URL and clean it
["Props"] = {
["Name"] = "<unique identifier of this component>", -- required
["UserPrompt"] = "<help text that explains the purpose of this reader>",
["Preselect"] = false, -- automatically show the reader when the assistant opens
["PreselectContentCleanerAgent"] = true -- run the content cleaner by default
}
},
{
["Type"] = "FILE_CONTENT_READER", -- allows the user to load local files
["Props"] = {
["Name"] = "<unique identifier of this component>", -- required
["UserPrompt"] = "<help text reminding the user what kind of file they should load>"
}
},
}
},
}