Edit scripts to use in playbooks and run in the War Room.
Using or modifying an existing script enables you to quickly leverage proven functionality and save significant time and effort developing a new script from scratch.
For example, you can use scripts from the Base and Common Scripts content packs that provide basic and reusable functions that can streamline your playbook development.
Navigate to → → and in the Scripts Library search for the script you want to use.
Use the free text in the search box to find an existing script. From the search drop-down, you can:
Perform a basic search by Basic (name and tag), Name, or Tag.
Perform an advanced search for specific words In Script or Everywhere (including the script name and tags).
You can search for an exact match of the script name by putting quotation marks around the search text. For example, searching for
"AddKeyToList"returns the script with that name. You can search for more than one exact match by including the logical operator "or" in between your search texts in quotation marks. For example, searching for"AnalyzeTimestampIntervals" or "AddKeyToList"returns the two scripts with those names. Wildcards are not supported in free text search.You can sort the scripts in the library alphabetically, by modified date, by system, or custom, and you can filter for disabled or deprecated scripts.
The Script Helper also provides a list of available alphabetically ordered commands and scripts.
Click Edit. If the script you want to use is locked, you first need to duplicate it.
If a script is installed from a content pack, by default, the script is locked, which means that it is not editable.
In the Agentic Assistant pane, start a conversation with the Automation Engineer agent to edit the script, or manually edit the script code and define the script settings.
For more information, see Use the Automation Engineer agent to accelerate script development and deployment. For details about script settings, see Create a script.
Save the script version.
(Recommended) Validate your script.
Click Test.
In the Arguments section, provide values for any inputs your prompt requires. These inputs are used to simulate how the script will behave in a live playbook, or how the script registered as an Action and assigned to an Agent will run as part of an executed plan.
You can add input values manually.
Click Run.
The scripts are executed in the Playground. Review the output generated by the script to validate its behavior and ensure it produces the expected results. The output is typically a text summary or another structured format that you have defined.
In each run result, you can take the following actions:
Action
Description
Edit
Edit the entry, mark it as a note, preview it, or delete it.
Mark as note
Marks the entry as a note, which can help you understand why certain action was taken and assist future decisions.
When marked as a note, it is highlighted, so you can easily find it in the War Room or the Issue Overview tab.
View artifact in new tab
Opens a new tab for the artifact.
Add tags
Add any relevant tags to use that help you find relevant information.
(Optional) Click
next to the Edit button and select Register new Action to register the script as an action and make it available for agents. For more information, see Manage actions.