Agent

Overview#

The Agent panel is a conversation with your project. Instead of clicking through the Timeline and Inspector yourself, you describe the change you want — "add a CTA overlay at the end of the intro scene", "make the countdown timer hide the button when it reaches zero" — and the agent makes it, the same way you would: reading the project first, then saving a change that shows up in your project's ordinary version history.

Open it from the right-hand panel tabs in the main editor. The panel stays open across the rest of your session, and your conversation is saved per project — leave and come back, and the history is still there.

Asking#

Type your request in plain language at the bottom of the panel and press Enter (Shift+Enter for a new line). The panel's header shows a context line — the project revision you're on, and, when the checkbox below it is on, what you currently have selected and where your playhead is.

Leave "Include what I'm looking at" checked to let the agent take your current selection and playhead position into account as context for your request — useful for something like "make this bigger" where "this" is whatever overlay you have selected. Turn it off for a request that has nothing to do with what's on screen.

Following a run#

Once you send a request, the panel shows what the agent is doing as it happens: your request appears as a bubble, followed by a running status line and short notes on its progress. You can keep working in the editor the whole time — the run continues in the background.

Sometimes the agent needs more information before it can continue. It will ask a question directly in the panel, with quick-pick options when there's a short list of likely answers, and a text box for anything else. Answer either way and the agent picks up where it left off.

If you change your mind partway through, Cancel stops the agent where it is. Anything it already saved stays saved — only the rest of the request is abandoned.

Changes#

Every change the agent saves appears as its own card: a short description of what changed, plus chips for the scene groups, scenes, layers, and overlays it touched — plus variables, rules, object groups and plugins, which are listed but not clickable. Click a chip to jump straight to that element in the editor, exactly as if you had selected it yourself. A chip for something the agent removed is listed but not clickable either: there is nothing left to select.

Each of these changes is a normal revision in your project's version history, alongside the ones you make by hand — there is nothing agent-specific about how they're stored.

Which plugins the agent may use#

Your account has a plugin policy: the setting that decides which marketplace plugins the agent may put in your project. It is set per account by an MP4E administrator, and every run on your projects uses it. There are three values:

• official — only the plugins MP4E itself publishes (the mp4e namespace). This is the default for every account.
• signed — official plugins, plus any published plugin whose signature verifies against a signer MP4E trusts. Only the MP4E platform signer is trusted, so today this offers the same plugins official does.
• any — every published plugin in the marketplace, including ones shared by the community.

The policy shapes both halves of the agent's view at once: plugins outside it are left out of the catalogue the agent is given, so it never suggests one it could not use, and an install it attempts anyway is refused. A run cannot widen the policy — asking for a plugin outside it in your request does not change what the agent may install, and the agent will say so rather than reach past the setting.

Undo#

A change card offers an Undo button while it is still safe to use: only for the latest change of a run that has finished, and only if nothing else has been saved to the project since. Undoing creates a new revision that reverses that one — it does not rewrite history.

Working while the agent works#

You never have to stop editing while the agent is thinking. Your unsaved edits are never silently overwritten: if the agent saves a change while you have edits of your own that aren't saved yet, the panel shows a banner instead of reloading the project underneath you.

From that banner you choose: discard your edits and load the agent's newer revision, or keep your edits and deal with it later. If you keep editing and then try to save, you get the same reload prompt Studio already shows whenever the project has moved on since you last loaded it.

Export#

Once a run finishes, its card offers an Export button that opens the same export dialog you'd use anywhere else in the editor — there is no separate export path for changes the agent made.