Add a script to an AI agent

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:3分
  • Create a script to add it to an AI agent in AI Agent Studio. With scripts, you can use the scriptable APIs and back-end integration to support the AI agent.

    始める前に

    Role required: sn_aia.admin

    手順

    1. Navigate to All > AI Agent Studio > Create and manage > AI agents.
    2. Open the AI agent that you want to add a script to and navigate to the Add tools and information section.
    3. In the Add tool drop-down list, select Script.
    4. On the form, fill in the fields.
      表 : 1. Add a script form
      Fields Description
      Select a type of record operation to add If you select An existing one, you can select a record operation tool used by the current AI agent or any other AI agent. You can make changes to the settings of that tool to fit the needs of your specific AI agent.
      Name

      Name that you want to specify for your script.

      Description Description of the script and what it's going to do to assist your AI agent.
      注:
      This description is sent to the large language model (LLM).
      Script inputs Input name and description to use in the script. The LLM uses the name and description to determine what value should be used at runtime.

      Example: Input name is task_record_sys_id and description is sys_id of the Task Record, this is mandatory.

      Script JavaScript code that includes an object class or a function for your script.
      注:
      For improved security, use GlideRecordSecure instead of GlideRecord and addUserEncodedQuery() instead of addEncodedQuery().
      Execution mode Mode of execution for your script:
      • Supervised: Inputs from your human agent are required during the execution of this tool while the AI agent runs.
      • Autonomous: Doesn't require any input from your live agent during the execution of this tool while the AI agent runs.
      Display output Permission to display the output of the tool 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 as it passes information between tools and to other agents.
      • None
      • Concise
      • Paragraph
      • Verbose
      • Custom
    5. Select Add.
      A script tool is added in the Scripts section on the Add tools and information page.