Add actions to a Guide-only agent

Add actions generates actions for a Web Agent that was created to teach people the app. A Guide-only agent answers questions and points at the screen, and never acts for the user. With actions, the same agent also does the work when the user asks for it.

Before you begin

The agent was created with the goal Teach people to use the app, so its Actions tab is empty.
Your workspace's model provider is working. Generating actions uses tokens the way an analysis does, and the amount depends on the modules you select.
For an agent built from a ZIP, the uploaded code is still stored. If it was deleted, upload it again first. See Upload a ZIP instead of a repository.

Add the actions

To generate actions:

In the portal, go to Web Agents and select your agent.
Select the Actions tab, then Add actions.
Under Choose what the agent will be able to do, select the modules. Each module becomes a set of actions. All selects every module.
Select the button that reads Add followed by the number of modules, such as Add 2 modules.
Wait while Generating the actions runs. Faustine reads the code again, then writes each module's actions. You can leave the page and come back.
When the last step reads Your agent does the work now, it shows how many actions were written and in how many modules. Select Review the actions.

The Actions tab opens with the new modules.

If the agent has no modules on record, the first step has one button, Discover and choose. The run finds the modules first, then stops for you to select them.

Review and publish

The new actions are in the draft. The Guide keeps working as before, and the agent's persona, look, knowledge and app map are not changed.

Before you publish:

Turn off the actions the agent should not run. See Turn an action on or off and test it.
Check which actions ask the user first. See Require confirmation for an action.

Then publish a version. See Publish a version.

Troubleshooting

Symptom	Cause	Fix
The last step reads Not finished	The run failed or was cancelled. Nothing changed in the agent's actions.	Select Try again.
Add actions is disabled	The agent was built from a ZIP and the stored code was deleted.	Upload the code again from the Actions menu in the header.
The modules you selected were not kept	The modules found this time differ from the ones on record.	Select them again in the list the page shows.

Next steps

Actions: how actions run and what the tab shows.
The Guide: what the agent does when it guides.
Turn an action on or off and test it: try an action before users do.

Last updated November 13, 2026