Skip to main content
The OpalScript AI assistant writes and edits scripts from a plain-language description. Tell it what the automation should do, and it drafts the script, checks it against OpalScript’s built-ins, dry-runs it, and proposes the result as a diff you can accept or discard. You can also ask it questions about the script you have open.
Only Opal Admins can use the assistant. Read-only Admins can open the editor but not the assistant.

​
Write a script with the assistant

  1. Navigate to Admin > OpalScript > Editor, open a script, then select Assistant at the top right of the editor. The OpalScript editor with the OpalScript assistant panel open on the right. The script "AI Assistant Demo" holds only the placeholder comment. The panel reads "Describe the script you want and I'll write it, checking the built-ins and validating as I go." above three suggested prompts: Auto-approve low risk, Require justification, and Time-box access. A message box at the bottom reads "Describe the script you want…".
  2. Describe what you want, or pick one of the suggested prompts. For example: “Deny requests with no reason given.”
  3. When the assistant changes the script, the editor shows a Proposed change diff. Select Accept to load the change into the editor, or Discard to drop it. The editor showing a Proposed change diff with Discard and Accept buttons. The placeholder comment is removed, and the added lines read the request's reason and call actions.deny when the reason is missing or blank. In the assistant panel, the prompt "Deny requests with no reason given." is followed by "Validated script · no issues", "Ran a dry run · 0 context items", a Proposed script card with a Review changes link, and a summary of what the script does.
  4. Accepting doesn’t save. Test the script, then select Save.
Keep refining in the same conversation, for example: “Also allow requests under 2 hours without a reason.”

​
What the assistant does while it works

The assistant doesn’t just generate text. As it works, it uses tools against your organization and shows each step in the panel:

​
Suggested prompts

The prompts the assistant offers depend on the type of script you have open:

​
Conversations

Each conversation belongs to one script and one user. It picks up where you left off, even on another device. To start over, select the trash icon (Clear conversation) at the top of the assistant panel. You can resize the assistant panel by dragging its edge. The editor remembers whether you left it open.

​
Tips for good results

  • Say what should happen in every branch. “Approve if X, deny if Y, otherwise leave it for a human” produces a more predictable script than “approve if X.”
  • Name real things. Mention the resource, group, tag, or user by name, and the assistant looks up its ID for you.
  • Mention outside systems and secrets. If the script should call an API, name the service and the secret that holds its credential. The host must be on the egress allowlist.
  • Always review and test. The assistant validates and dry-runs its work, but you own the script. Read the diff, then use a test run before you save.
Last modified on October 11, 2026