With Google Workspace Studio, people in your organization can create agents to automate work across Workspace and third-party services they’re allowed to connect to. These agents can make people more productive by automating routine tasks, but they can sometimes work in unexpected or unwanted ways.
You usually discover unwanted agent activity from reports from users or in Workspace event logs, such as:
- High frequency activity—For example, more messages sent in Gmail or Google Chat, or more changes to a file, or more files created than normal or possible for a human being. Tip: Chat messages sent by Studio agents have a chip next to the sender’s name showing they were sent by a Studio agent.
- Unwanted activity that happens on a regular schedule—For example, it might repeat approximately every hour at all times of day. Note: Agents have built-in stagger so the interval may not be exactly the same for each repeat.
To stop an agent, first you figure out which agent is causing the problem, then send a request to Support to stop it.
Step 1: Find which agent is causing the problem
- Follow the instructions in Workspace Studio log events to search the Studio logs using the Audit and investigation tool or Security investigation tool. Try the following attribute filters:
- Actor—Set as the user’s email address.
- Event—If you know when the problem occurred, filter by Step complete and look for a step that finished at about the same time. You might also be able to filter by Step app if you know the activity happened in Gmail, Chat, or another Workspace app.
- When you find the agent, in the results list, make a note of the Agent ID.
Step 2: Stop a user’s agent
- Contact Google Workspace support with the Agent ID for the agent you want to stop. Support will stop the agent for you.
- If you need to stop an agent immediately and can’t wait for support, you can stop all of the owner’s agents.
Important: These steps turn off all the user’s agents. Make sure that they don’t have any business critical agents before you continue.
- Add an organizational unit. Set the user’s current organizational unit as the parent.
- Move the user to the new organizational unit.
-
In the Google Admin console, go to Menu
Apps
Google Workspace
Workspace Studio.
Requires having the Service Settings administrator privilege.
- Click Service status.
- At the left, select the new organizational unit.
- Change Service status to Off.
- Click Override.
- After the agent is stopped by Support, you can move the user back to their original organizational unit so they can use Workspace Studio again. The agent remains off until the user turns it back on.