Modifying prebuilt agents

Prebuilt agents in BMC HelixGPT provide ready-to-use capabilities for common business scenarios. To adapt these agents to your organization’s requirements, you must clone the prebuilt agent and modify the cloned version. For more information about prebuilt agents, see Prebuilt agents.

You can customize agent behavior, integrations, and security controls to align with your business processes. Administrators can modify a prebuilt agent in the following scenarios:

Align agent behavior with internal business processes
Integrate with enterprise systems such as BMC Helix ITSM or HR applications
Refine the response tone and communication style
Improve response accuracy by updating skills or knowledge sources

Components that you can modify

You can modify the following components of a prebuilt agent:

Agent instructions
Skills
Subagents
Tools and toolkits

To modify a prebuilt agent

To modify a prebuilt agent, first clone it. You can clone the agent by using the Clone option in HelixGPT Agent Studio or by using the command-line interface.

(Recommended) To clone a prebuilt agent by using BMC HelixGPT Agents Studio

Log in to BMC Helix Innovation Studio and navigate to the Workspace tab.
From Application launcher, select HelixGPT Agent Studio.
On the Agents tab, select the agent you want to modify.
Click Action > Clone.
The Clone Agent dialog box is displayed.
Enter a name for the new agent.
(Optional) To include all the components, sub-agents, the tools, toolkits, and prompts of the original agent, select Deep copy.
Click Confirm.

To clone a prebuilt agent by using the command line interface

Use the following cURL commands to clone an agent. When you clone an agent, its associated tools are also cloned.

Obtain a token.
See the following example:
curl --location '<IS_HOST_NAME>/api/rx/authentication/loginrequest' \
--header 'X-Requested-By: BMC' \
--header 'Content-Type: application/json' \
--data '{
"userName": "<userName>",
"password": "<Password>"
}'
See the example of Microsoft Windows operating system:
curl --location "<IS_HOST_NAME>/api/rx/authentication/loginrequest" ^
--header "X-Requested-By: BMC" ^
--header "Content-Type: application/json" ^
--data "{ \"userName\": \"<userName>\", \"password\": \"<Password>\" }"
Clone the agent.
See the following example:
curl --location --request POST '<IS_HOST_NAME>/api/com.bmc.dsom.hgm/agent/clone/<AGENT_ID>?newName=<NAME>&shallowCopy=false or true' \
--header 'Cookie: AR-JWT=TOKEN' \
--header 'X-Requested-By: BMC'

To modify agent settings

Log in to BMC Helix Innovation Studio and navigate to the Workspace tab.
From the Application Launcher, select HelixGPT Agents Studio.
Select the Agent tab and select the agent you have cloned.
Click Actions > Edit.
(Optional) On the Agent summary tab, modify the agent name, description, or model details, and click Save and next.
(Optional) On the Instructions tab, modify agent instructions, and click Save and next.
For more information about adding or modifying instructions, see <Link to agent instruction section>
(Optional) On the Tools tab, select tools or toolkits that you want to add for the agent, and click Save and next.
(Optional) On the Agent fleet tab, select the sub agents that you want to add for your agent, and click Save.
The Agent fleet tab is visible only when you select the agent type as Supervisor on the Agent summary tab.

To associate the agent with a skill

Log in to BMC Helix Innovation Studio and navigate to the Workspace tab.
From Application Launcher, select HelixGPT Agents Studio.
Select the Skills tab.
From the Application drop-down list, select an application.
The skills available for the application are displayed.
Select a skill that you want to associate.
Click the Agents option and select the agent to which you want to associate the skill.

To test an agent

For information about testing an agent, see Test an agent.

To deploy an agent

For information about testing an agent, see Deploy an agent