Agent Installation

Guide

Tip

This guide describes the complete process for installing AI agents in your workspaces within the Prodgy platform.

Prerequisites

Before installing an agent, make sure that:

• You have an active account on Prodgy
• You have access to at least one product
• You have administrator or management permissions on the workspace

How to Install an Agent

1. Access the Agent Panel

   Log in to the Prodgy platform, select the workspace, and navigate to the agents section. You’ll see the grid with all available agents.

2. Choose the agent

   Identify the agent you want to install. Agents with Available status display the “Install” button on the card.

3. Start the installation wizard

   Click “Install” to open the guided wizard. The process is divided into steps, with a progress bar indicating advancement.

Installation Wizard Steps

The wizard guides you through all necessary configurations before activating the agent:

1. Welcome

The first screen presents the agent’s general information:

• Name and avatar of the agent
• Version that will be installed
• Author and publication date
• Description detailing what the agent does and how to use it

2. Integrations

Select the integrations the agent will use to connect to external tools:

• Each integration is displayed with its logo and description
• Examples: Azure DevOps, GitHub, Jira, OpenAI, Aha!
• You can select only the integrations relevant to your workflow
• Integrations can be added or removed later in the settings

Note

Available integrations depend on the agent. Not all agents require external integrations.

3. Prompts

Configure the system prompts that guide the agent’s behavior:

• Prompts are divided into sections with title and content
• You can add new sections or remove existing ones
• Content accepts free text and is editable with a full editor
• Prompts define how the agent interprets and processes requests

Tip

Default prompts come pre-configured by the agent author. Adjust as needed to adapt to your team’s context.

4. Parameters

Define the agent-specific configuration parameters:

Field type	Description
Text	Free text fields for names, URLs, descriptions
Number	Numeric values for limits, quantities, thresholds
Selection	Dropdown with pre-defined options
Boolean	On/off toggle to enable features
JSON	Fields for advanced configuration in JSON format

Required fields are marked with a red asterisk. Validation occurs in real time.

5. Result

After confirmation, the installation runs automatically. The progress bar displays the status of each internal step:

1. Copying — copies the agent’s base data
2. Integrations — configures the selected integrations
3. Parameters — applies the defined parameters
4. Publishing — publishes the agent’s first version
5. Exporting — exports the final configuration
6. Finalizing — completes the process

Each step displays a visual indicator: pending, running (spinner), or completed (green check).

Caution

Do not close the window during installation. If an error occurs, the result will be displayed with a detailed message for diagnosis.

---

Post-Installation

After successful installation:

• The agent appears with Installed status (green dot) in the Agent Panel
• A first version is automatically published
• The agent’s webhook is generated and can be copied in the settings
• You can access the Settings panel by clicking the gear icon on the card

Note

For agents that require local installation (such as Prodgy Assistant Plugin), see the specific documentation in the Assistant section.

---

Uninstalling an Agent

To uninstall an agent from the workspace:

1. Go to the Agent Panel and locate the installed agent
2. Click the uninstall button available on the agent card
3. Confirm the action in the confirmation dialog

Caution

Uninstalling an agent is irreversible. Upon uninstalling, the following items will be permanently removed:

• All published versions of the agent
• The execution history and its logs
• Custom settings (parameters, prompts, linked integrations)
• The webhooks associated with the agent
• The dashboards that were added during the agent’s installation

Note

If you need to use the agent again in the future, a new installation will be required along with reconfiguring all parameters.