Review agent setup changes
Set an agent up by talking to it, agree with a yes and put each change back. A Setup changes card appears only for requests from your own assistant.
You can ask an agent to work differently without opening its Settings. Say what you want in a chat with it. The agent describes the change in plain text, and your yes applies it. This page is for the owner of the agent, member or admin.
Only the owner of an agent can ask for these changes and agree to them. Other people who talk to the agent cannot.
What the agent can change from the chat
- Its name (Name) and goal (Goal).
- Visibility, either Only me or Organization.
- Skills: assign an existing skill, or remove one. Use any other skill is On or Off.
- The four tools: Search the web, Run code and work with files, Talk to other agents and Create and change routines.
- Routines: create, edit or pause one.
App accounts are not changed from the chat. Add or remove them in the Settings of the agent, see Connect apps for agents, or ask your own assistant, which uses a card (see When your assistant asks).
Ask for a change
Ask in your own chat
Open Agents, pick the agent and say what you want, for example that it should also search the web. The agent only acts on what you write in the chat, not on files, other agents or tool results.
Read the proposal
The agent writes one proposal with the change, such as a new name and goal and any routine, and ends with one question.
Answer yes
Nothing changes until you do. Sharing the agent with the whole organization, and removing or turning off a tool or skill, each need a clear yes to that exact question. A general yes to the setup is not enough.
You should see a line under the agent's reply for each change. A tool, skill or goal change starts from your next message.
Set up an agent that has no goal
An agent your assistant created can have no goal yet. The agent form in the app asks for Name and Goal. In your chats with an agent that has no goal, it has one job: to find out what work it should do and set itself up. Describe the work.
- It proposes a name and a goal, and a routine if you want one, then asks you to confirm.
- For a morning routine without a time, it proposes every day at 09:00. It states the time zone, which is your organization's setting or UTC when it has none, so you can correct it.
- After your yes it saves the name and goal first, even when an app the work needs is not connected yet. It tells you what is saved and what is still missing, for example an app an admin must turn on.
- Saving the goal starts a test on a real request from your chat. The agent reports the real result, and a test that is still running is not a success.
- When you accept the first successful result, the agent stops guiding setup. Ask it again whenever you want to change how it works.
Read the change lines
Each applied change appears as a line under the agent's reply.
| Line | Meaning |
|---|---|
| "Changed" and the name of the piece, such as "Changed Name" or "Changed Goal" | Click View changes to see Before and After. |
| "Turned on" or "Turned off" and the tool name | The tool changes from the next message. |
| "Assigned the skill" or "Removed the skill" and its name | The skill list changed. |
| "Created the routine" and its name, "paused until you turn it on" | The routine exists but does not run yet. Click Open routine to open the agent's Routines. |
| "Paused the routine" and its name | The routine stopped. |
| "Changed the routine" and its name | The routine was edited. Click View changes to see Before and After. |
| "Changed assigned apps" | The apps assigned to the agent changed. Click View changes to see Before and After. |
| "Changed assigned skills" | The skills assigned to the agent changed. |
| "Created skill" or "Updated skill" and its name | The agent saved a skill. |
When an assignment fails, the line starts "Couldn't assign" and gives the reason.
Turn on a routine
A routine the agent saves starts paused. In Routines, use the switch on its row to turn it on. Running it once first is up to you.
A routine that changes websites needs one run you review. Its row reads "Run it once and review the result before turning this on".
- Click Run once, or Run again after a run that failed or was stopped.
- Read the result. If the run showed website changes, the panel lists them.
- Click Looks good, turn on. With website changes, the button reads Allow changes and turn on and lets the routine repeat those changes by itself. Decline and keep paused leaves it paused. You can revoke the permission in the agent's settings under Tools, then Saved permissions.
If such a routine is turned on without that review, its first scheduled run does not make the change, and the routine pauses. On Desk, a card reading "Routine “[name]” is waiting for you to review its run" has a Review run button.
Put changes back
Click Put it back on a line to undo that one change. The line then says, for example, "Put back: Search the web is off again.", "Put back: Name is as it was before.", "Put back: the routine 'name' is archived." for a created routine, "is running again." for a paused one, or "is as it was before." for an edited one. Other lines read "Put back: assigned apps are as they were before.", "Put back: assigned skills are as they were before.", "Put back: the skill 'name' is archived." for a created skill and "Put back: the skill 'name' is as it was before." for an updated one. Only the owner of the agent sees Put it back.
The Settings of the agent also keep a Changes list. Edits the agent made show "proposed by the agent", each with its own Put it back.
When your assistant asks
When a change reaches the agent from your own assistant through Gurusup's MCP, the agent proposes a card titled Setup changes instead of asking in text. The web chat never shows this card. The card can hold Name, Goal, Visibility, Skills, Use any other skill, the four tools and app accounts.
Each change has a checkbox, a title, the value before and after (for example Off → On) and a one-line reason. All checkboxes start ticked. You should see each change marked Applied or Not applied: followed by the reason.
A goal
A goal change shows a short preview. Click View changes to see Before and After. Click View test to see the Example and the Reply. Before proposing a goal, the agent tries it on a real message from your conversation, and the test shows as "Testing this goal…" while it runs. If it did not finish, the card says "The test didn't finish."
If the test has not succeeded, the checkbox Apply without a test appears. Without a successful test or that checkbox, the goal is not applied. The test is a "Goal test" conversation that only you can see.
Apps
An app change is titled "Add [app] · [account]" or "Remove [app] · [account]", with Not assigned → Assigned or the reverse. When you add a personal account to a shared agent, the card warns "Anyone who talks to this shared agent can act with your personal account."
A row titled "Connect a [app] account" has a link, Open Apps, and no checkbox. It is not a change: the agent has no usable account for that app yet. Connect one, then ask for a new card.
The buttons
| Button | What it does |
|---|---|
| Approve all | Applies every change on the card, ticked or not. |
| Approve selected | Applies only the ticked changes. It appears only when some, but not all, are ticked. |
| Not now | Applies nothing. The card then says "Not applied". |
A change you leave out is not applied and is not kept: ask for a new card if you want it later. The card shows "Expires in" a number of hours, or minutes near the end, and lasts 24 hours. After that it says "Approval expired. The action was not executed." If the task behind it was stopped, it says "This task was stopped. This approval is closed." Someone who cannot decide the card sees "Waiting for [name] to decide." when the card has a person to name, or "Only the person this chat belongs to can decide this." when it does not.
| Change | When it starts |
|---|---|
| Name, goal, visibility, skills and tools | "Saved. This takes effect from the next message." |
| An app added | "Assigned. Available from the next request." |
| An app removed | "Removed. Access ended immediately." |
Once changes are applied, the card shows Put it back. Only the owner sees it, and it works once for each card. It undoes every change applied from that card, apps included. Each change then reads its title followed by "Put back", or the reason it could not be put back, for example "This agent's app access changed. Review its Apps settings."
If it does not work
| Message | What to do |
|---|---|
| Only the agent's owner can decide on its setup changes. Ask them to review this card. | Ask the owner of the agent to review it. |
| Ask for these changes in your main conversation with the agent. | Open your own chat with the agent and ask there. |
| Not selected. Ask for another card if you want to change this setting. | You left it unticked. Ask for a new card. |
| Changed since this card was proposed. Review the current setting before changing it again. | Someone edited that setting after the card appeared. Look at the current value and ask again if you still want it. |
| This goal wasn't tested yet. Wait for its test to finish, or choose to apply it without a test. | Wait for the test, or tick Apply without a test on a new card. |
| This agent already has the maximum number of accounts. Remove an account first. | Remove an account from the agent, then ask again. |
| This account is no longer available. Review it in Apps. | Open Connect apps and check the account. |
| This card has closed because the agent or conversation changed. Ask the current owner to review its settings. | Ask the current owner of the agent for a new card. |
| The change was not made. Run the routine once, review the website changes it shows and turn it back on. | A routine that changes websites ran without a reviewed run. Follow Turn on a routine. |
| We could not put this change back. Your current settings are safe. Contact support for help. | Contact support. Your settings were not changed. |