What the assistant can run
The assistant can only read. Before anything is sent to a device, Alabai checks the command against a list of allowed commands in its own code. The AI cannot change that list, and a command that fails the check is never sent.
Allowed commands
showpingtraceroutedirshowpingtracerouteping6traceroute6dirshowpingtracerouteping6traceroute6dirEvery other command is refused: configure, copy, write, reload, clear, debug, more and the rest. sh and sho are written out as show, and a short filter like | sec as | section; any other command must be spelled in full.
Output filters
After a |, only filters that narrow the output. Ones that can write or run something, such as redirect, append, tee and tclsh, are refused.
includeexcludebeginsectioncountincludeexcludebeginsectioncountheadlastjsonxmlincludeexcludebeginsectionjsonChecks on top
- Pings and traceroutes go to an IP address
- Only to a unicast IP address, with an optional VRF and source. No repeat count, packet size or other options, so a ping sends the device’s default few packets. A broadcast, multicast or host name target is refused.
- A host name waits for you
- A command with a host name in it, like show ip route x.example.com, waits for your approval even in Auto-approve show, because the device may look the name up in DNS.
- No file servers, no file commands
- dir cannot point at a server (tftp:, ftp:, http:, https:, scp:, sftp:, rcp:). show commands that print a file, like show file on NX-OS or show archive config on IOS, and anything with to-file, are refused. So is show monitor capture on IOS and IOS-XE, which prints the contents of captured packets.
- One command at a time
- No line breaks, control keys or separators such as ; inside a command, so nothing can ride along after an allowed one. A command longer than 250 characters is refused.
- Only at the normal prompt
- A command is sent only when the device sits at its normal prompt, like R1#. Never in configuration mode, at a --More-- or [confirm] prompt, or while you are typing.
- Only on a device with its platform set
- You set each device’s platform yourself. On a device without one, the assistant runs nothing.
Who approves
- Ask for approval (the default)
- Every command stops at a card showing the exact text and the device it is for, and runs only when you click Approve.
- Auto-approve show
- show commands run without asking. ping, traceroute and dir still wait for you.
On a card you can also allow that command for the session, for the device, or for every device of that platform. A permission never covers another platform.
Configuration
The assistant never sends configuration. When a change is the answer, it writes the configuration out in the chat, and you review it and paste it yourself.