Agent
Agent is the assistant built into Pluto Ads: ask in plain words, and it does the work with your permissions.
Using Agent is part of your role: every role but Guest has it, and a custom role has it when Use the Agent is ticked (see Members). Without it, Agent doesn't show anywhere.
Open Agent
- Home: type in the box at the top and press Enter. Home turns into the chat, with its own address you can reload or bookmark.
- Agent in the bar at the bottom of every page opens a new chat in a panel over the page you're on. On a chat's own page it takes you to Home to start a new chat.
- Cmd+J (Ctrl+J on Windows) opens or closes the panel from anywhere. On a chat's page, it moves to that chat's box instead.

The panel stays open while you move between pages, and Agent knows where you are: "move these ads to Prospecting, broad US" over a launch means that launch. Expand chat in the panel's header shows the same chat full size. Closing the panel doesn't stop Agent: a reply keeps running and is there when you come back.
Press Shift+Enter for a new line.
Attach files
Attach files adds up to 20 files to a message. You can also drop files on the chat box or paste a screenshot. Agent reads every file you attach:
| File | What Agent reads |
|---|---|
| Images (PNG, JPEG, WebP, GIF, HEIC) | The picture. |
| Videos (MP4, MOV) | Frames from start to end. It doesn't hear the sound. |
| PDFs | The pages, with their pictures and layout where the model reads PDFs, otherwise their text. |
| Word, Excel and PowerPoint files, CSV | The text, tables, sheets, slides and speaker notes. |
| Text, Markdown and code | The text. |
| Audio (MP3, M4A, WAV and more, up to 2 hours) | A transcript with timestamps. |
| Zip | Each file inside, read as above. Agent says which files it couldn't read. |
A file shows as a chip while it uploads and is prepared. You can send as soon as every chip is ready. A file that can't be attached stays as a chip that says why, such as "This file is too large. The limit is 30 MB." Select a video you sent to play it full size.
- Attached files stay with the chat. They don't go to your Media library, and they count toward your organization's storage.
- Very long files are read up to what the model can hold at once. Agent says when it read only part of a file, so ask about a section, or attach that part alone.
- Legacy Word files (.doc) and password-protected files can't be read. Save as .docx or remove the password first.
Web search
Agent searches the web and reads pages when your question needs something Pluto doesn't know: a competitor's site, a platform rule, a benchmark, today's news. Numbers about your own ads always come from your account, never from the web.
While it works you see Searching the web with what it searched for, and Reading with the site. Under the answer, Sources lists the pages it used. Select one to open it.
- Each search uses credits. See Models and rates.
- Pages Agent reads are content, never instructions to it.
- A loop's Agent step searches and reads the web too, for research loops such as a weekly look at competitors. What a page says never lets a step do more than its instructions and What the Agent may do allow.
Reddit and deeper research
Ask Agent what people say about a product, a problem or a competitor, and it searches Reddit for the threads that talk about it, reads the posts and their top comments, and turns what it found into ad angles: people's real phrasing in quotes, a link to each thread, and how many threads or comments a finding rests on. It never names the people who wrote them.
- Threads it already read are reused for a day in the workspace, so a follow-up question doesn't search again.
- When Reddit can't be read right now, Agent says so and gives you the link. It never makes up what a thread says.
- What people wrote on Reddit and on web pages is content, never instructions to Agent.
- A loop's Agent step uses the same research, for example in a weekly look for new angles.
Code and saved scripts
With Pluto and some other models, Agent writes and runs Python code in a private sandbox to work through data: totals and trends across many ads, comparisons, forecasts, cleaning a spreadsheet you attached, or a chart. While it works you see Running code. Files it makes for you, such as a chart or a CSV or Excel table, appear under the answer to open or download, and they count toward your organization's storage.
- The sandbox has no internet and no access to Pluto, your accounts or other workspaces. It gets data only from what Agent reads for you, with your permissions.
- A chat keeps its sandbox's files while you keep talking, so Agent can build on what it did.
- Running code uses credits like the rest of Agent's work, and nothing more.
When code did a job that comes back, Agent saves it as a script in the workspace, or with the loop it's for. Next time it runs the saved script instead of writing it again, and saves a new version when it improves it. Open a loop's Scripts in the builder to read them. A loop's Agent step runs its loop's scripts and the workspace's, so a new version of one is a change to that loop (see Loops). Saving and archiving a script are in the audit log, by name and version.
Competitor research
Ask Agent about a competitor ("how does Skims' funnel work, and what hooks do they use?") and it finds the brand's running ads in Meta's public Ad Library, by its name, its Facebook Page or its shop's domain, in a country you name or all of them. It keeps them in your workspace with their copy, call to action, landing page, start date, how long they've run and their images and videos, and Creative Memory reads the longest-running ones the way it reads your own ads: hooks, offers, claims, proof, visuals and narrative.
Agent then reads the competitor's funnel: each ad as top, middle or bottom of the funnel from its hook, offer, call to action, landing page and what Creative Memory found, the hooks and angles that dominate each stage, their offers, where their ads send people, the ads that have run longest (usually the ones that work), and the angles they use that your own analyzed ads rarely do. The ads it talks about appear under its answer with their pictures; select one to open it in the Ad Library.
- Creative Memory's reading uses your organization's credits like your own ads' analyses: 50 per image and 250 per started minute of video (its first three minutes), so researching a competitor needs a role that spends credits. Reading competitors already researched spends nothing. Agent asks before it starts, unless you chose to run everything. It never holds up the analysis of your own ads, and a creative used in several of the competitor's ads is read once.
- Competitors' ads stay apart from your own: they're never in your media library, your Creative Memory search, rankings or results.
- Some countries' Ad Library pages may not answer Pluto. Agent says so and gives you the link to open yourself.
- Meta's Ad Library API, through your workspace's Meta connection, returns every kind of ad only for ads shown in the EU, and elsewhere only ads about social issues, elections or politics. Meta lets a connection search it once the connected person has confirmed their identity with Meta; until then Agent says what's needed.
- The same search within the hour is answered from what Agent found before. Researching a competitor again refreshes its ads and reads only what wasn't read yet.
- A loop's Agent step reads competitors you researched. With Research competitors on in What the Agent may do, it researches them itself, for example to compare a weekly look for new angles with what competitors run.
What it can do
Agent can do what you can do in the app, and never more than your role allows, in the workspace you're in. For example:
- Find launches, ads, media, loops and results, and answer from your own numbers, per currency. It doesn't estimate: if there's no data for a period, it says so.
- With Pluto Profit connected, answer with real profit instead of ROAS: the store's profit and POAS, what each product left after costs and ad spend, and which ads, ad sets and campaigns made or lost money. Profit per ad is an estimate from the store's margins, and the answer says so.
- Create and edit launches, ad sets and ads in bulk: move, duplicate, archive and restore them.
- Set anything on a launch, an ad set or an ad that you can set in the editor, in plain words: "an ad set for women 25 to 44 in the US and Canada, Reels and Stories only, with a cost cap and 7-day click" becomes those exact settings. Amounts are in the ad account's currency; when you name another one, it asks instead of converting.
- Look at your images and videos, and write or judge copy for them.
- Show you ads right in the answer. Ask "show me the 10 ads with the most spend" or "the 5 hook types with the most spend, with each one's best ad", and the answer shows them as cards. See Ads in an answer.
- Check what stops a launch from publishing. The answer shows a live checklist, each item linked to where you fix it, that updates as you fix them.
- With Creative Memory on Enterprise, search inside your ads and have Creative Memory read a file. Reading uses credits, so Agent asks first. See Media library.
- Build and change loops. A loop made from a chat keeps that chat as its history. See Loops.
- Show you a list the way you ask, such as "only failed loops, grouped by ad account" or "videos sorted by name": it sets the filters, grouping, order and layout of Launches, Media, Analytics, Loops and the Inbox, your page changes as it answers, and it can save what you see as a view.
- Publish, change live budgets and bids, pause and resume, and plan several live changes for you to review.
- Work on LinkedIn as on Meta: build LinkedIn launches in LinkedIn's own fields, read LinkedIn results and change live LinkedIn budgets and delivery. When something isn't available on LinkedIn in Pluto Ads yet, it says so.
- Read every metric LinkedIn reports, such as engagements, qualified leads, open rate and earned (viral) figures, and split LinkedIn's numbers by conversion action, placement, device, serving location, carousel card or day of the week. LinkedIn doesn't allow its demographic data (job titles, companies, industries, seniorities, job functions, company sizes and places) as input to AI, so Agent says it can't read those and points you to Analytics.
- On X, work with what Pluto Ads holds: your launches and drafts, what Pluto did and the IDs of what runs on X. What X reports, such as names, statuses, results, leads and replies, isn't shared with Agent: X's terms keep it in the app, where you read it. Agent never writes a reply on X, since X needs a person to write each one.
Meta usually takes 50 ads per ad set. When Agent fills an ad set past 50 ads, it leaves the ads there and offers to split it into balanced copies with the same settings; it splits only if you want it, and Meta decides when you publish. A split divides the budget in proportion to the ads, so the total never changes. If a part would fall below Meta's minimum budget, it doesn't split and tells you the budget needed. A LinkedIn ad set isn't split: LinkedIn runs up to 15 ads per ad set, and the checklist names one with more, so you move some to another ad set.
While it works, Agent shows the step it's on, such as "Moving 12 ads to Prospecting, broad US". When it's done, the steps fold into one line that sums them up, such as "Read 3 sources, took a step": select it to see each one. Launches, ads, media and loops it mentions are links. Use the thumbs under an answer to tell us whether it helped. Copy under it copies the whole answer: pasted into a document it keeps its headings, lists, tables and charts, and as plain text it's Markdown, with each chart as a table of its numbers and each ad as its linked picture and name.
Ads in an answer
When you ask to see ads, creatives or examples, or Agent ranks ads for you (the top 10 by spend, the best ad per hook type), it shows them as cards, in the order it ranked them:
- Each card has the ad's picture, or its video. Select the video to play it right there. When the answer points at a moment in it, such as a hook Creative Memory found at 0:12-0:18, that moment is written under the ad's name and the video starts there. Nothing is written over the picture.
- Under it are the ad's name and its spend, ROAS and cost per purchase (CPA) for the period the answer is about, shown over the cards. An ad without delivery in that period says so.
- Selecting a card opens the ad in Pluto Ads (⌘-click or Ctrl-click opens a new tab). An ad no launch manages opens its file next to what Creative Memory found in it, or the ad in Ads Manager.
- An ad without a file in your media library shows its name alone.
The cards show only ads of the workspace you're in. Copied or downloaded, each card is the ad's picture linked to it and its name. Loop reports show the same cards, in the Inbox. See Loops.

Agent is for owners, admins and members. Guests don't have it.
Guidance, skills and models
SettingsAgent (Settings, then Agent) starts with your own settings. They're only for you, in this workspace.
Your guidance, memory and skills apply in your own chats. A loop's own chat is the same for everyone who can see the loop and writes there: Agent uses nobody's own guidance or memory in it. When a chat of yours built a loop and you share it with the people who can see that loop, yours is taken out of that chat.
- Guidance: instructions and context Agent follows when it answers you, such as your brands, targets and how you like numbers reported. Up to 4,000 characters, saved as you type.
- Skills: reusable procedures: the steps, the data to pull and how the result should look. Select
New skill, give it a name, fill in When should the Agent use it? and write its instructions. Agent picks a
skill up when a request matches, or when you name it ("run my weekly review"). To run one yourself, type
/at the start of a message, for example/weekly-creative-report. Owners and admins can share a skill with the whole workspace. Something that should run on its own, on a schedule or when something happens, is a loop instead. A loop's AI steps use the skills shared with the workspace, never one that's only yours. See Skills in loops. - Memory: what Agent remembers between chats. See Memory.

Agent runs on Pluto 1, Pluto's model built for ads, unless you pick another in the chat box. Models under My account in Settings decides which models your picker shows. Owners and admins choose which models the workspace allows in Models under Workspace. See Models and rates.
Memory
Agent remembers what you teach it, one thing per entry, so you don't repeat yourself in every chat:
| Type | For |
|---|---|
| Preference | How you like answers and work done, such as "spend per ad, never per ad set". |
| Rule | What Agent may and may not do, such as "ask before raising a budget more than 20%". |
| Fact | Your business: products, margins, goals, who your customers are. |
| Reference | Where something lives, such as your naming scheme or the dashboard finance uses. |
When you correct Agent, confirm an approach it suggested, or tell it something lasting about your business, it offers to remember it with one line under its answer. Save keeps it, Edit lets you change it first and Dismiss drops it. When something is already remembered, Agent offers to update that entry instead of adding another, and it always asks before forgetting one. It doesn't offer for one-off questions or for what it can read from your data.
Turn on Save automatically under SettingsAgent (Settings, then Agent) to have Agent keep your own preferences, rules, facts and references without asking. It only does that for what you said yourself in the chat.
SettingsAgentMemory (Settings, then Agent, then Memory) lists everything Agent remembers, with search and a filter by type. Each entry shows where it came from, such as a chat you can open again. Owners and admins can add entries for the whole workspace, which Agent uses in everyone's chats.
Rules Pluto enforces
Most entries guide how Agent works. Two kinds of rule are also enforced by Pluto, whatever Agent writes:
- Budget raises: a rule with a limit, in percent or an amount in a currency, makes Agent ask before raising a budget or bid by more, even with Act without asking. A workspace rule applies to loops too: a larger raise waits for approval.
- Ask before: a rule can make Agent always ask before publishing, budget changes, pausing or resuming, deleting, comment replies or loop changes.
Memory never changes your permissions, what needs approval, or how Agent describes itself. An entry that asks for that is ignored.
Choosing when Agent asks
Under Approvals, Ask before acting is your own choice in this workspace, on every device.
| Choice | What Agent does |
|---|---|
| Ask for risky actions (the default) | Asks before it spends, deletes, sends or changes settings. Drafts, tags, folders and archiving run directly. |
| Ask every time | Asks before every change. Reading never asks. |
| Act without asking | Acts without asking, within your permissions and the workspace's limits. |
Risky actions spend money or change what's live in Meta, change people, credentials, integrations, billing or settings, send something outside Pluto Ads, such as a reply to a comment, or can't be undone.
Even with Act without asking, Agent always asks before it:
- raises a budget or bid, or starts new spend such as publishing, above the workspace's budget guardrail;
- changes usage limits, an ad account's spending limit, or who may run without approvals;
- invites or removes people, or changes their roles;
- creates an API key, agent credential or webhook;
- deletes a workspace.
Owners and admins set two rules under Workspace:
- Run without approvals: All members (the default) or Only owners and admins.
- Budget guardrail: Largest budget increase without approval is a percent, +50% unless changed. Largest amount without approval adds an amount per change in one currency. Decreases and pauses never count.
Loops don't follow this setting: each loop asks according to its own steps.
Answering Agent's questions
When Agent needs a choice from you, its question opens just above the chat box with numbered answers. Select one, or press its number. Something else lets you answer in your own words, and Skip or the close button puts the question away so you can type in the chat box instead. When several things wait, 1 of 2 and the arrows move between them. Once you've answered, the chat keeps one line with the question and your answer.
When Agent proposes a list to confirm, such as which Pages stay on, tick the ones you want and confirm. If it also says Confirming also approves, confirming the list exactly as proposed is your approval of that change, and Agent doesn't ask again. If you change the list, nothing is approved, and Agent asks before it acts. Agent never attaches a change that spends money to a list.
Approving an action
When Agent needs your yes, the action opens above the chat box with Approve and Reject (or press 1 or 2). Several actions of the same kind are one decision, such as Turn off 86 Pages: Show the 86 lists them, and Approve all 86 runs them all and lets Agent continue once. The details show the action's exact effect: for a publish, the launch, the ad account and every budget in the account's currency.

- Approve runs the action once, as you. Approving twice, or on two devices, never runs it twice.
- If the launch changed after the approval appeared, or nobody approved it within 24 hours, it fails and says why. Ask again for a fresh one.
- An action your role doesn't include still shows, but only someone whose role includes it can approve or reject it. It says who it needs, for example: Needs someone whose role includes "Publish and launch ads to the platform".
- Proposed in your own chat, it goes to the Inbox of everyone in the workspace whose role includes it. They see the action, what it acts on and that you asked, never your chat. When one of them approves or rejects it, your chat shows the outcome, as it does for your own approvals, and Agent continues. See Collaboration.
- In a loop's shared chat it stays in the chat, where an organization owner or admin decides it.
- Agent never proposes billing, the organization and its people, API keys, agents and webhooks, spending credits, exports, or reading what your role doesn't show. Ask for one and it says in one line that your role doesn't include it.
- Sending a new message closes any open approval in that chat without running it, except one that went to other people's Inbox: it stays open for them.
- A new API key's or webhook's secret shows once, right after you approve. Select Copy: the chat doesn't keep it.
Reviewing a plan of changes
When a request changes several live budgets, bids or delivery statuses at once, such as "pause the ads under 1% CTR and move their budget to the winners", Agent proposes a plan. It shows in the chat with totals per ad account.
- Approve and apply applies the version you see. Nothing changes before you approve.
- Open in Inbox shows every change with its current and new value and Agent's reason. Edit a value, remove a change, send Reply with changes for a new version, or Reject it.
- After it's applied, Undo sets a change back where that's safe, such as pausing again or lowering a budget.
You decide how far one change moves a budget when you approve it; a budget never goes to 0. A change that fails a check is left out, with the reason. A plan waits a limited time and says when it expires. Loops and connected agents propose plans the same way.
Your chats
Your chats are private: nobody else in the workspace sees them, admins included, until you share one. They follow you to every device. Only an action Agent proposes that your role doesn't include reaches anyone else: its card goes to the Inbox of the people who can approve it, without the chat.
The bar at the bottom keeps your two latest chats as tabs. A chat that's working shows it on its tab. Close a tab with its close button; the chat stays in your history. Right-click a tab for Open chat as page and Close tab.
The history button opens every chat, grouped by Today, This week and Older, with a dot on unread replies. Search by title. To rename or delete a chat, open it and choose Rename chat or Delete chat in the menu next to its title. Deleting a chat keeps the changes Agent made.
- The stop button, or Esc in the chat box, stops Agent. Steps already done stay done.
- If a reply fails, Regenerate runs the same request again.
- To change something you asked, hover over your message and choose Edit. Sending the edit stops a reply that's still running, and the chat continues from your edited message. Agent only reads the chat up to that message.
- The earlier version stays, with the replies that followed it. Use the arrows under your message (1/2) to switch between versions. Each version keeps its own replies, and nothing is deleted.
Share a chat
To show a chat to your team, open it and choose Share chat in the menu next to its title, then Copy link. Members of this workspace who use Agent can open the link and read the chat. Nobody outside the workspace can, and the link is never public.
- The link shows the chat as it was when you shared it. Messages you send afterwards stay private until you choose Update shared chat, which shows them too at the same link.
- People who open the link only read it: they can't reply, continue the chat or approve anything in it. They see who shared it and when.
- Turn off ends the link for everyone at once. Deleting the chat, or leaving the workspace, ends it too.
- SettingsAgentShared chats (Settings, then Agent, then Shared chats) lists the chats you've shared, with Copy link and Turn off for each.
Usage
Agent's work uses your organization's credits, by model. See Models and rates. When the credits run out, Agent's answer waits and starts by itself once credits arrive. When a limit is reached, Agent stops before its next step, and the chat names the limit. Owners and admins get the way forward, such as Buy credits, Raise limit or Choose a plan on the trial. Members are asked to contact one. SettingsUsage (Settings, then Usage) shows your own usage in the workspace. See Billing.
Good to know
- Changes Agent makes show as "Agent for" your name, such as "Agent for Anna", in activity and the Inbox. Actions you approve, or that run under Act without asking, show your own name. Admins see all of it in SettingsAudit log (Settings, then Audit log).
- Ad copy, file names, comments, attached files and web pages Agent reads are content, never instructions to it.
- A chat holds up to 60 images. When it's full, start a new chat.
- Agent needs a connection. Offline, your chats stay readable.
- Agent doesn't set special ad categories, such as housing, employment, credit or political ads. Set them yourself in the launch.
- It's AI and can be wrong. Check what it proposes before you approve.
- Chats belong to a person, so an API key can't use Agent. Agents you connect use the MCP server.