--- title: "Create a Genie in the FlowGenie Studio" slug: "create-a-genie-in-the-flowgenie-studio" updated: 2026-06-03T13:17:14Z published: 2026-06-03T13:17:14Z canonical: "docs.processmaker.com/create-a-genie-in-the-flowgenie-studio" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.processmaker.com/llms.txt > Use this file to discover all available pages before exploring further. # Create a Genie in the FlowGenie Studio The FlowGenie Studio offers a robust, intuitive interface for designers to create and manage Genies efficiently. Its well-structured layout and comprehensive features allow users to train Genies to meet specific needs. --- ## Create a New Genie **Permission** Your user account or group membership must have the following permissions to create a new FlowGenie unless your user account has the **Make this user a Super Admin** setting selected: - FlowGenies: Create FlowGenies - FlowGenies: View FlowGenies See the [FlowGenie](/v1/docs/permission-descriptions-for-users-and-groups#description-of-platform-permissions) permissions or ask your Administrator for assistance. Follow these steps to create a new FlowGenie: 1. From the [Designer Welcome Screen](/v1/docs/designer-welcome-screen), do one of the following: - Hover over the **FlowGenie** icon ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/image(122).png), and then select the **New Genie** option. - Hover over the **FlowGenie** icon ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/image(123).png), select **View all Genies** to [view a list of Genies](/v1/docs/flowgenie#view-all-genies). Then click the **+Genie** button. 2. The **Create Genie** screen displays. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/image(124).png) 3. In the **Name** setting, enter the name of the Genie. Names must be unique in your organization and can only use apostrophe characters (`'`) and spaces. This is a required setting. 4. In the **Description** setting, enter a description for the Genie. 5. From the **Category** drop-down menu, select one or more [FlowGenie Categories](/v1/docs/flowgenie-categories) to associate with this Genie. To remove a FlowGenie Category that is currently selected, click the ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/image.webp) icon for that selection or press Enter when the drop-down is visible. This is a required setting. 6. From the **Project** drop-down menu, optionally select the Project(s) to which this Genie will be added as an asset. Only Projects where you are a member will be displayed. To remove a selected Project, click the ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/image(1).webp) icon next to it or press Enter when the drop-down is visible. 7. Click **Save**. 8. Continue editing in the [FlowGenie Studio](/v1/docs/create-a-genie-in-the-flowgenie-studio). --- ## **The FlowGenie Studio** The FlowGenie Studio provides an interface to preview, test and adjust Genie configurations. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/The FlowGenie Studio.png) ### Genie Settings Genie settings are displayed on the left, enabling users to configure the following settings: - **Provider**: Select the AI model provider the Genie uses to generate responses. Available providers include: - OpenAI - Google (Gemini) - Anthropic (Claude) - **API Key:** Enter the API key required to connect to the selected provider. This field is displayed when Google (Gemini) or Anthropic (Claude) is selected as the Provider. Then, click **Load** to display all models. - **Model:** Select the AI model the Genie uses to generate responses. The available options depend on the selected Provider. After choosing a provider, the Model dropdown displays the models supported for that provider, allowing you to select the most appropriate model for your Genie configuration. - [OpenAI](https://developers.openai.com/api/docs/models) - [Google (Gemini)](https://ai.google.dev/gemini-api/docs/models) - [Anthropic (Claude)](https://platform.claude.com/docs/en/about-claude/models/overview) - **Model Settings**: Click the ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Gear Settings Icon.png) icon to configure the following model settings: ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Model Settings.png) - **Response Format**: Response format configuration options include: For example, if JSON is selected, the Genie will return a response in the following format: ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/image(125).png) - Text (This is the default format) - JSON - Table - **Temperature**: Adjust the slider to control the response style. Lower values produce more consistent responses, while higher values increase diversity and creativity. - **Top P**: Adjust the slider to control token diversity, affecting the variety of word choices. - **Max Tokens**: Use the slider to set the maximum length of the response. One token represents approximately 4 characters or 0.75 words in English text. - **Presence Penalty**: Adjust the slider to decrease the chance of reusing already generated tokens, encouraging new content. - **Frequency Penalty**: Modify the slider to reduce the likelihood of repeating frequent tokens, minimizing redundancy. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Agent Settings.png) - **Tool Choice**: Select how the agent uses tools while generating responses. This setting controls whether the model can decide when to use tools, must use a tool, or cannot use tools. Select one of the following options: - **Auto**: The model decides when to use tools. This is the default option. - **Required**: The model must use at least one tool when responding. - **None**: The model cannot use tools when responding. - **Parallel Tool Calls**: Enable this setting to allow the agent to run multiple tool calls at the same time. This can improve response speed when a task requires several independent tool actions. Disable this setting for workflows that require tools to run in a specific order or depend on the result of a previous tool call. - **Max Turns**: Set the maximum number of agent turns allowed before the agent stops running. An agent turn includes a tool call, a response, or both. Increase this value for complex tasks that require multiple tool calls or several steps to complete. Keep the value limited enough to prevent the agent from running too long or entering an infinite loop. - **Tools**: Manage the tools available to the agent. Tools allow the agent to perform actions, retrieve information, and interact with external services. To learn how to add, configure, or remove tools, see [Agent Tools](/v1/docs/create-a-genie-in-the-flowgenie-studio#add-tools-to-an-agent). - **Subagents**: Add genies as a subagent. To learn about it, see [Subagents](/v1/docs/create-a-genie-in-the-flowgenie-studio#subagents). - **Data**: Enter sample data in JSON format to test Genie's response in the Studio. It includes JSON variables. - **Sources**: Select the RAG Collection the Genie uses as a knowledge source. Only fully analyzed RAG Collections appear in the list, allowing you to choose the collection the Genie can use to retrieve relevant information when generating responses. - **Source Settings**: Click the ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Gear Settings Icon.png) icon to configure the following source settings: ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Source Settings.png) - **Match Threshold**: Set the minimum similarity score required for a document section to be included in the Genie’s response context. Higher values return only more closely related content, while lower values allow broader matches. - **Limit**: Set the maximum number of document sections the Genie can retrieve from the selected RAG Collection when generating a response. - **Instructions**: Enter the system prompt that defines the agent’s behavior, role, and response guidelines. Optionally, click the **wizard** icon to generate instructions with AI. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/AI Instructions.png) --- ### Agent Tools Tools allow an agent to perform actions, retrieve information, and interact with external services. To add tools to an agent, click **+ Add Tool** in the [Genie settings](/v1/docs/create-a-genie-in-the-flowgenie-studio#the-flowgenie-studio). ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Add Tool Options.png) Two options are available: - [**MCP Server**](/v1/docs/create-a-genie-in-the-flowgenie-studio#add-a-remote-mcp-server) - [**Tool**](/v1/docs/create-a-genie-in-the-flowgenie-studio#add-default-tools) #### Add Default Tools Use **Tool** to add tools from the ProcessMaker MCP Server. This option provides a set of default tools that are commonly used by agents. 1. Select **Tool**. 2. In the **Select Tools** window, review the available default tools. Default tools include: ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Select Tools - FlowGenie.png) - **Chain of Thought** - **Web Search** - **Web Scrape** - **Batch Scrape** - **API Request** 3. To review a tool before adding it, click the **arrow** next to the tool name. The expanded view displays the tool details, including: ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/image(361).png) - **Definition:** Describes what the tool does. - **Arguments:** Lists the input values required by the tool. - **Returns:** Describes the response generated by the tool. - **Response Example:** JSON answer example. 1. Select the checkbox for each tool the agent can use. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Select Tools - FlowGenie.png) 2. Click **Save**. The selected tools are added to the agent. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Default Tools.png) #### Add a Remote MCP Server Use this option to connect the agent to a remote third-party MCP Server. 1. Select **MCP Server**. 2. Configure the MCP Server settings: ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Firecrawl MCP Server.png) 1. **Server Name:** Enter a name to identify the MCP Server. 2. **Connection Type:** Select **HTTP-SSE** or **HTTP**. 3. **URL or Command:** Enter the server URL or command used to connect to the MCP Server. 4. **Authentication Method:** Select the authentication method required by the server. Available authentication methods include: - **None** - **Access Token/API Key** - **Custom Headers** - **OAuth 2.0 (Client Credentials)** - **OAuth 2.0 (PKCE)** 3. Click **Connect**. If the connection is successful, the available tools from the MCP Server are displayed. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Firecrawl Tools.png) 4. Select the tools the agent can use. 5. For MCP Servers that require OAuth authentication: 1. Click **Discover OAuth** to automatically detect the server authentication configuration. 2. Click **Authorize** to sign in with the MCP Server account. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/MCP Server with OAuth.png) 3. After authorization is complete, click **Connect** to display the available tools. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Notion Tools.png) 6. Select the required tools. 7. Click **Add Server**. The MCP Server and its selected tools are added to the agent. #### Manage Added Tools After tools are added, they are listed in the agent configuration. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Default Tools.png) From the tools list, you can: - Click a tool to view or configure its settings. - Click the **X** icon to remove a tool from the agent. --- ### Subagents Use the **Subagents** setting to delegate work from a parent FlowGenie to one or more specialized Genies. Each Subagent acts as a specialist that the parent FlowGenie can call when a task matches the subagent’s purpose. - A parent FlowGenie calls each Subagent as a tool. Nested specialists are also displayed as tools in their parent Genie. - The runtime timeline shows which subagent ran and which tools the subagent used during execution. - If a subagent stops before completing its tools, increase the **Max Turns** value in the child Genie configuration. #### Add a Subagent 1. Click **Subagents**. The list of available Genies in the platform is displayed. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Subagents FlowGenie.png) 2. Locate and select the Genie to use as a subagent. 3. Click the **Plus** icon next to the Genie. The selected Genie is added as a subagent and displayed in the Subagents list. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Subagent Added.png) #### Configure the Handoff Description The handoff description defines when the parent FlowGenie should use the subagent. This description helps the parent Genie decide which subagent to call for a specific task. 1. In the Subagents list after adding the agent, the system displays a **No description** alert. 2. Click the ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Gray Edit Icon.png) icon for the subagent. 3. Enter a handoff description that explains when this subagent should be used. For example, describe the type of task, topic, or responsibility assigned to the subagent. 4. The status is updated. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Handoff Description FlowGenie.png) Handoff descriptions are important because they help the parent FlowGenie determine when to call one Subagent instead of another. --- ### Genie Training The center of the FlowGenie Studio provides an interface where Genies can be trained to perform specific tasks. The prompting can render Markdown instructions. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Prompt FlowGenie.png) Follow these steps to train a Genie: 1. Enter a prompt for the Genie in the **Enter a user message** box. 2. Click **Add** to add the message to the chat box. 3. Click **Run** to get a response from the Genie. You can also add several messages and then run them all at once to get a response. 4. Use the attach file icon ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/image(126).png) to include a file for the Genie to analyze. > [!NOTE] > **Supported File Types** > > - **Images**: Must be 2MB or less. Support multiple image uploads at once > - **PDFs**: Must be 2MB or less and contain 3 pages or fewer. > - **CSV**: Must be 0.2MB or less. > - **URL links**: Should be publicly accessible and contain no copyrighted content. 5. To delete a file or message, click the **Trash** icon at the top of the message. 6. After uploading and adding a file, select **Use Process Variable** to replace the file dynamically with the variable value during a Request of the process. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/image(127).png) 7. Click **Save Genie** to save all configurations. ### User vs. Assistant Use the **User/Assistant** button to switch between editing the chat as a user or the assistant. The assistant in this context is the Genie itself, and this feature allows you to modify the Genie's response as needed. Follow these steps to switch between user and assistant modes: 1. While editing a Genie, click the **User** button ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/image(129).png). 2. The **User** button will change to **Assistant** ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/image-1.png), and any message typed will now be added on behalf of the Genie. 3. Click the **User/Assistant** button at the top of a previously added message to switch the sender for that message.