Invoking an AI agent from the process


Use the Invoke Agent element in Process Designer to trigger an AI agent to perform a specific task as part of the process flow. This element enables application business analysts to automate actions and enhance the business process logic.

The Invoke Agent element is available as a process element in the HelixGPT Agent Studio section in the Process designer, and is visible only if you have deployed the HelixGPT Agent Studio bundle.

To add the Invoke Agent element

  1. Log in to BMC Helix Innovation Studio and navigate to the Workspace tab.
  2. Select the application to which you want to add a process.
  3. On the Processes tab, click the name of the process to which you want to add the Invoke Agent element or click New to create a new process.  
  4. Specify the general details of the process, for example, process name, process variables, and permissions.
    For more information about how to specify the general details of a process, see Defining processes to accomplish business goals
  5. From the HelixGPT Agent Studio section of the Palette, drag the Invoke Agent element to the canvas.
    In the Properties pane, click Settings Settings icon.png, and specify the following properties:
    Element propertyDescriptionExample
    LabelDisplay name of the element.25_3_Invoke_Agent_General_tab.png
    DescriptionElement summary.
    ID Unique identifier automatically assigned to the element instance in the process.
    Run asDetermines whether the agent runs with administrator privileges or with permissions of the user who initiated the process.
    Input MapDefines key-value pairs of input parameters to pass contextual data from the process to the AI agent.25_3_Invoke_Agent_Input_Map.png
    Agent IDUnique identifier of the AI agent to be invoked.
    User IDThe user who triggers the agent.
    MessageEnd user's message.
    X-Forwarded-Access-TokenAuthenticate the user access token. This token is used by BMC Helix AIOps.
    ParametersSet additional parameters to be passed while running the process.
    Output MapMaps the output returned by the agent to process variables.25_3_Invoke_Agent_Output_Map.png
    Multi instance loopSpecify repetition for a process activity.25_3_Invoke_Agent_Loop.png
    Geometry Define the position (X and Y coordinates) of the element on the Process designer canvas for visual layout purposes.25_3_Invoke_Agent_Geometry.png

     

  6. Click Save.

Example: Using the Invoke agent element in a workflow

The following image shows a sample process that uses an Invoke agent element to call an agent in a custom process: 

25_3_Invoke_Agent_Element.png

Related topics

AI agents in BMC HelixGPT

Managing AI agents

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*