Add a flow action to an AI agent

  • Release version: Xanadu
  • Updated January 30, 2025
  • 1 minute to read

    • Add a flow action to an AI agent in AI Agent Studio. Define the flow action to use it as a reusable operation in automating the ServiceNow AI Platform features without having to write code.

    Before you begin

    When an AI agent uses a flow action tool, the user the AI agent is running as must pass the ACL of the flow action. Ensure that the security configurations for the flow action are met by the AI agent and agentic workflow. For more information, see Security for AI agents.

    Role required: sn_aia.admin

    Procedure

    1. Navigate to All > AI Agent Studio > Create and manage > AI agents.
    2. Open the AI agent that you want to add a flow action to and navigate to the Add tools and information section.
    3. In the Add tool drop-down list, select Flow action.
    4. On the form, fill in the fields.
      Table 1. Add a flow action form
      Fields Description
      Name

      Name that you want to specify for your selected flow action.
      Description Description of the flow action and what it’s going to do to assist your AI agent.
      Note:
      This description is sent to the large language model (LLM).
      Select flow action Existing automated process to be selected from the list.
      Inputs Flow action inputs. The values are filled in by the LLM at runtime unless you specify a value override.
      Note:
      If the agent uses multiple tools, you can choose to use another tool's output as an input value override. Select the data picker icon (Data picker icon.) to review the available options.
      Execution mode Mode of execution for your selected flow action:
      • Supervised: Inputs from your live agent are required during the execution of this flow action while the AI agent runs.
      • Autonomous: Doesn't require any input from your live agent during the execution of this flow action while the AI agent runs.
      Display output Permission to display the output of the execution in the Now Assist panel or in Virtual Agent:
      • Yes
      • No
      Processing message Message to display to users when the tool is running.
      Output transformation strategy Style for the LLM to present the results.
      • None
      • Concise
      • Paragraph
      • Verbose
    5. Select Add.
      A flow action is added in the Flow actions list on the Add tools and information page.