Call Agentic Virtual Agent action
- Virtual Agent enabled in your organization. For more information, contact your designated Customer Success Manager.
- AI Studio permissions for agentic virtual agents. For more information about all the required permissions, see AI Studio permissions.
Use the Call Agentic Virtual Agent action in a bot flow or digital bot flow that is enabled with Virtual Agent to invoke the AI agent. You can solely use the agent or mix and match the agent with conventional flow-based elements as necessary to implement a hybrid workflow.
- The AI Studio category and the Call Agentic Virtual Agent action are available only when you enable Virtual Agent.
- When you add a Call Agentic Virtual Agent action to a flow in Architect, the flow type changes to Agentic Virtual Agent and it is indicated by the following badge at the top-right corner:
To access the Call Agentic Virtual Agent action, follow these steps:
- From the Architect home page, click or hover over the Flows menu and select a bot flow or digital bot flow.
- Create a new flow or select an existing one. The flow's configuration page opens. Note: The flow must have Virtual Agent enabled.
- From the Toolbox, expand the AI Studio category and drag a Call Agentic Virtual Agent action to the desired location in the flow.
- In the Name box, type a meaningful name for the action. This name becomes the name of the Call Agentic Virtual Agent action in the flow.
- From the Agentic Virtual Agent list, choose a published agent.
- Continue building your flow based on your business needs.
| Field | Description |
|---|---|
| Name | Type a distinctive name for the Call Agentic Virtual Agent action. The label you enter here becomes the action's name displayed in the flow structure. |
| Agentic Virtual Agent | Select the name of the agent that the flow must invoke. Click Open Agentic Virtual Agent in New Tab to open the agent in AI Studio. Notes:
|
| Version | The flow always executes the latest published version of the agent. |
| Inputs | Lists the input variables that you defined in the selected agentic virtual agent. Assign a value (literal or expression) that you want to send to the selected agentic virtual agent as the starting context. |
| Outputs | Lists the output variables that you defined in the selected agentic virtual agent. These are output values that the agentic virtual agent sends to the Architect flow after the interaction ends. Assign a variable name to each output variable for further use in the flow. |
| Exit Reason | Indicates the reason that caused the agentic virtual agent to exit. Assign a variable name to the exit reason for further use in the flow. The exit reason can be one of the following string values:
|
| Name | Description |
|---|---|
| Success | This path indicates that the action successfully executed the agentic virtual agent. Drag the appropriate action below the Success path to follow the route you want the interaction to take. |
| Failure | This path indicates that there was an error in executing the action. Drag the appropriate action below the Failure path to follow the route you want the interaction to take. |
| Timeout | This path indicates that the action has exceeded the specified amount of time to execute the action. Drag the appropriate action below the Timeout path to follow the route you want the interaction to take. Note: Actions use either the default timeout or the flow author's specified timeout. If the action times out, the flow follows the route specified below the Timeout path. This feature ensures that the user does not wait too long for the path to continue. It is recommended that you set the timeout duration to less than 30 seconds. |
[NEXT] Was this article helpful?
Get user feedback about articles.