{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":5131,"path":"conversational-interfaces/virtual-agent/setup-flow-designer-va-properties.md","title":"Add actions or subflows to Virtual Agent topics","bundle":null,"doc_type":null,"release":"australia","body":"\n# Add actions or subflows to Virtual Agent topics\n\nUse the Action utility to integrate ServiceNow Workflow Studio workflows in Virtual Agent topics. The Action utility node triggers the required Workflow Studio workflows used in the Virtual Agent conversation.\n\n## Before you begin\n\nIf you don't already have a Virtual Agent topic, create one. For more information, see [Creating a Virtual Agent topic](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/create-virtual-agent-topic.md).\n\nBecome familiar with the following features:\n\n- Workflow Studio concepts and tasks. For more information, see [Workflow Studio](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/build-workflows/workflow-studio.md).\n- Assistant Designer Asset library utilities, such as the Lookup utility, and the Script Action utility.\n\n Use these utilities to control the actions within the Virtual Agent conversation. For more information about these utilities, see [Assistant Designer utilities](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/va-utilities.md).\n\n- Virtual Agent controls. You may be asked to enter any of the following:\n\n - Text strings\n - Data pills\n - Strings with embedded data pills\n - Scripts that return strings\n For more information, see [Assistant Designer controls](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/virtual-agent-controls.md).\n\n\n**Note:** If you have turned on and set up ServiceNow Otto in Virtual Agent, you can work with conversational actions and subflows from the Assistant Designer Asset library. For more information on conversational actions and subflows, see [Conversational actions](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/build-workflows/conversational-actions.md) and [Conversational subflows](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/build-workflows/conversational-subflows.md). You can still integrate actions and subflows that are not conversational from Workflow Studio into Virtual Agent topics via Assistant Designer Asset library. The following content is only relevant to actions or subflows that can't be made conversational in Workflow Studio.\n\nRole required: virtual\\_agent\\_admin or admin\n\n## Procedure\n\n1. Navigate to **All** > **Conversational Interfaces** > **Assistant Designer**.\n\n2. Select the **Asset library** tab.\n\n3. From the Utilities section of the palette, drag the Action utility icon \\[Omitted image \"action-icon.png\"\\] Alt text: onto the canvas at the appropriate location on the conversation flow.\n\n The Action utility is now a node in the conversation flow, and the Action utility properties panel appears.\n\n4. On the properties sheet, fill in the fields.\n\n\n
\n\nProperty\n\n\n\nDescription\n\n
\n\nNode name\n\n\n\nThe name of this Action node.\n\n
\n\nInvoke Workflow Studio asset\n\n\n\nSelect one of the following Workflow Studio components:\n\n- **Action**: A reusable operation.\n- **Subflow**: An automated process that consists of a sequence of reusable actions, data inputs, and outputs.\n\n\n
\n\nSpoke\n\n\n\nName of the scoped application that contains Workflow Studio content that is dedicated to a particular application or record type.\n\n For a list of default spokes, see [Spokes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/build-workflows/spokes.md).\n\n
\n\nAction/Subflow\n\n\n\nThe Workflow Studio action or subflow to be performed in the instance. The **Input mapping** and **Output mapping** areas change depending on your selection.\n\n For details about the action, select the link beneath your selection to view it in Workflow Studio.\n\n
\n\nWait for response?\n\n\n\nToggle switch that determines whether Virtual Agent waits for a response from the specified action before continuing.\n\n
\n\nInput mapping\n\n\n\nSpecifies the variables to be used as input to the selected action. The contents of this area change according to the action that you selected. Options may include string input, referenced records, scripts, and so on. For options that require a password, enable the **Include a password input** toggle switch to prompt the user for a password. Secure inputs must use the password2 data type. Input is securely masked and not viewable by others.\n\n **Note:** The **Array.Reference** input data type in Virtual Agent Designer corresponds to the **List.\\[Table\\]** input data type in Workflow Studio. For more information, see [Action input and output data types](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/build-workflows/action-inputs-outputs.md).\n\n
\n\nOutput mapping\n\n\n\nSpecifies the variables to be output by the selected action. The contents of this area change according to the action that you selected.\n\n
\n\nAdvanced \\(optional\\)\n\n
\n\nPermissions\n\n
\n\nRun as\n\n\n\nPermissions to use for the action. Select one of the following options:\n\n- **User who initiates session**: When selected, the action runs using the same permissions that the current user has.\n- **System User**: When selected, the action runs using system privileges, some of which may be unavailable to the current user.\n\n\n
\n\nHide this node\n\n
\n\nConditionally show this node if\n\n\n\nNo-code condition statement or low-code script that specifies a condition for presenting this node in the conversation. The condition must evaluate to true.\n\n
5. Select **Save**.\n\n\n**Parent Topic:**[Integrating Virtual Agent with Workflow Studio workflows](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/va-flow-designer-integration.md)\n\n"}}