AI Agent Builder

Introduction

The Joget AI Agent Builder is a no-code/low-code tool that lets you build intelligent agents using a simple drag-and-drop interface. Just like Joget’s Form Builder, it is designed for ease of use, even if you do not have the necessary programming skills.

With this builder, you can create AI Agents that understand user input, rephrase questions, break down complex tasks, search the web for answers, interact with communities, schedule demos, and more. The agent handles both logic and language, powered by AI, so you can automate smart interactions and workflows quickly.

How does it work?

Joget AI Agent is a system powered by a large language model (LLM) like OpenAI’s GPT. It can understand natural language input, perform tasks, generate intelligent responses, and interact with external data or systems. AI Agents are commonly used for things like virtual assistants, automated support, content summarization, and workflow automation.

They do not just answer questions; they can follow instructions, make decisions based on context, and integrate with tools or APIs to take actions on your behalf.

When you create an AI Agent, it consists of two parts:

1. Define Agent
   

   
   This is the brain of your AI Agent. You define:

   • LLM Service: Choose the AI model your agent will use. Currently, Joget supports OpenAI’s GPT models. More AI services will be added in future versions.
   • Default Prompts: Predefined instructions or questions you want the AI to follow or ask.

   Example: You can set a default prompt like "Summarize this document in simple terms" or "Find the latest pricing information."

2. Task Setup
   
   

   The Task section defines what the agent will actually do. By default, this section is named First Task. You can create multiple tasks in a sequence, allowing the agent to process input step by step, such as retrieving data, formatting a response, or calling an API. Each task is made up of three key components, which are Prompt, Tool, and Enhancer.

   Example: A task can fetch data, then another task formats it, and a final task sends an email with the result.

How AI Agent Builder Tasks and Components Run

In Joget, AI Agent Tasks execute sequentially, one at a time. If multiple tasks are added (e.g., Task A, Task B, Task C), the agent processes Task A first, then Task B, and so on, following the order they are arranged.

Inside a Task: Step-by-Step Flow

Each task consists of components that also run in sequence, ensuring a structured execution process. The typical internal flow follows these steps:

1. Prompts:
   The system first sends the defined prompt to the LLM (Large Language Model). Multiple prompts placed within one task will also run sequentially.

2. Tools (Optional):
   If the response requires additional functionality, such as calling an API, retrieving data, or executing database queries, the appropriate tool is invoked after the prompt.

3. Enhancers (Optional):
   Once the output is generated (after Prompt + Tool), Enhancers are triggered last. These allow you to store the output in a form field, process a variable, or modify the result before final use.
   

Execution Order

Users can expect both tasks and their internal components to execute in the arranged sequence, following this structured flow:

Prompt > Tool (if needed) > Enhancer (if defined).

Plugin information

Plugins Available in the Bundle:

1. Joget AI Agent Builder

This plugin bundle is compatible with Joget DX 8.1.0 and onwards.

Get started

Prerequisites

• Please note that this plugin only supports Enterprise version 8.1.0 onward.
• An LLM Key. For example, you can obtain one from OpenAI.

Where to get the plugin

You can download the AI Agent Builder plugin from the Joget Marketplace.

How to install

1. Download the plugin JAR file from the Joget Marketplace. 
2. Go to your Joget localhost or server. In the Joget Console, go to Admin Bar > Systems Settings > Manage Plugins and click the Upload Plugins button.
3. Under Upload Plugin, select the plugin .jar file you downloaded and click Upload.
4. Once uploaded, the plugin will be available in your Joget environment.

How to use it

Once you have installed the AI Agent Builder plugin, proceed with the following steps:

1. In a new app or an existing app, navigate to the App Composer.
2. Under AI Agent, click the ADD NEW button to create a new AI Agent.
   
3. Provide an ID, Name, and Description for the API connector, and click Save.
   
4. When the AI Agent Builder is launched, you will see a Define Agent action and a First Task section.
   
5. Under Define Agent, click LLM Service to configure a large language model. Since OpenAI is currently the only supported model, configure the following:
   1. For Model, select an OpenAI model.
   2. For API Key, specify an LLM key obtained from OpenAI.
   3. Optionally, for Proxy Domain, if your environment routes API calls through a proxy, specify the domain here.
   4. Click Apply Changes.
      
6. By default, a Persona prompt is in the Define Agent section. You may delete by clicking the Remove  button and replace it with a new prompt by dragging and dropping it from the palette. If you choose to retain it, you can configure it by clicking on it:
   1. 1. For Role, specify the position, character, or responsibility the AI is expected to take on. By default, it is Research Analyst & Tech Writer.
      2. For Backstory, specify a brief background or experience for the AI to adopt, which helps add realism or specific domain knowledge. The default values are:
         Your writing is insightful, well-researched, and future-oriented, with a focus on:
         - Technical deep dives
         - Industry impact analyses
         - Ethical and societal discussions
         - Comparative studies
         Your goal is to educate and inspire businesses, researchers, and enthusiasts about ${query}.
      3. Click Apply Changes.
         
7. Under First Task, a default Text Prompt is in the Drop a prompt to here section. You may delete it or configure it if you choose to retain it.
8. Drag and drop a tool from the Tools section of the palette into the Drop a tool to here section. Click on the tool to configure it.
   
9. Drag and drop an enhancer from the Enhancers section of the palette into the Drop an enhancer to here section. Click the enhancer to configure it.
   
10. If needed, you can rename the First Task section to any desired name by clicking on the section, specifying a Task Name, and clicking Apply Change.
    
11. Additionally, you can add a New Task section by clicking the Add Task  button beside existing tasks.
    
12. Configure you AI Agent inputs in the Settings tab. Refer to AI Agent Builder Properties for more information.
    
13. In the Preview tab, test your AI Agent to ensure it generates a response correctly.
    After clicking Run Agent, a response is generated as follows:
    • Content: This refers to the actual data being transmitted in a request or response.
    • Request Payload: This is the data sent by the client to the server in an HTTP request. It usually contains information needed for processing, such as form inputs or JSON objects in a POST or PUT request.
    • Full Response: This includes everything returned by the server in response to a request. It consists of the status code, headers, and the response body (which contains the actual content).
      
14. Click Save to save the AI Agent.
    

Configure AI Agent Builder Properties

• Refer to AI Agent Builder Element for all configuration properties for Prompts, Tools, and Enhancers.
• Refer to AI Agent Builder Properties for AI Agent Builder properties in the Settings tab.

Expected Outcome

After configuring an AI Agent, the AI Agent can now be incorporated into a Joget App as a Process tool in Process Builder or as a post-processing tool in Form Builder. Refer to AI Agent Tool for more information.

Download plugin 

You can download the AI Agent Builder plugin from the Joget Marketplace.

Download Sample App