Mentions, slash commands and attachments
Point the agent at accounts, campaigns and files with @, / and attachments.
The composer understands three shortcuts: @ to point at an account or campaign, / for ready-made requests, and the attach button for files and creatives. The placeholder reminds you: Ask about your campaigns... try @ or /.
Mention an account or campaign
Type @ in the composer, then start typing a name.
Pick from the list with the arrow keys and Enter or Tab, or click it. Results are grouped into Ad accounts, Batches, Campaigns, Ad sets and Ads.
The mention becomes a chip in your message. Mentions matter most when the chat box's account picker is on All accounts and no campaign is open: the agent uses your mention to know exactly which one you mean instead of guessing. To keep the agent on one account for the whole chat, pick it in the account picker instead.
Use a slash command
Type /, pick a command and send. The command drops in as a chip and sends a fixed request.
| Command | What it asks for |
|---|---|
/account-triage | What needs your attention today, ranked |
/scale-finder | Winners ready to scale today |
/change-recap | What changed across the account in the last 24 hours |
/creative-winners | Your best-performing creatives |
/creative-generation | New ad images in your brand's style. See Create ad images with the agent |
/client-summary | A client-ready performance summary |
/pacing-forecast | Where spend lands by month-end |
/today's-pulse | Today's daily account briefing |
/creative-fatigue-audit | Ads that are tired and need a refresh |
/team-report | Your team's activity over the last 7 days |
/apply-template | Apply a structure template to this campaign |
/template-from-campaign | Turn this campaign into a reusable structure template |
/new-pipeline-ticket | Create a new pipeline ticket |
The first nine are the one-click reports. The last three work with structure templates and the Pipeline.
Attach files and creatives
Select the + button (tooltip Attach) in the composer and pick a source:
| Option | What it does |
|---|---|
| Attach files | Uploads images, videos, PDFs, Word documents, .txt or .md files from your computer. Documents can be up to 25MB. |
| Creatives library | Picks creatives you already have in Koast. |
| References | Picks ads for the agent to base new images on, from the Meta Ad Library, Pinterest or Cosmos. |
| Connectors | Opens a second list with your file sources: Google Drive, Dropbox and Frame.io pick files from there, and Higgsfield imports images you made in Higgsfield. Select Connectors at the top of the list to go back. |
If Google Drive, Dropbox or Frame.io isn't connected yet, you'll see a message such as Connect Google Drive to continue and Koast opens the integrations settings so you can connect it.
You can also paste an image straight into the composer (⌘V, or Ctrl+V on Windows), for example one you copied from a website. It's attached the same way as a file you upload.
Attachments stay available for the whole chat. You don't need to attach a creative again later in the conversation.
When the chat works on one ad account, the agent sees the images you attach or pick, not just their names, up to 12 per message. For a video, it sees the video's thumbnail, not the video itself.
Sending
- Enter sends your message.
- Shift+Enter starts a new line.
- If an attachment is still uploading when you press Enter, the message waits and sends as soon as the upload finishes.
- While the @ or / list is open, Enter picks the highlighted item instead, and Esc closes the list.
- When the message box is empty after an answer, it can show the agent's first suggested follow-up in grey. Tab fills it in without sending, and Esc hides it.
Send messages while the agent works
You don't have to wait for the agent to finish. While it works, Enter sends and ⌘+Enter queues for later.
| Do this | What happens |
|---|---|
| Press Enter | Your message shows in the chat right away, with Send now under it. The agent reads it as soon as its current step is done and carries on with it in mind, without dropping what it was making. Once it has read it, the message moves into its reply where it was read. |
| Select Send now | Stops the current step at once, and the agent reads your waiting messages straight away. |
| Press ⌘+Enter (Ctrl+Enter on Windows) | Queues the message for when the agent finishes. It waits in a 1 message queued bar above the message box; select the arrow in the bar to send it now instead. |
| Select the stop button (it takes the send button's place while the agent works) | Stops the agent. Messages it hadn't read yet stay in the chat marked Not sent, with Send to send one and × to remove it. Nothing goes out unless you send it. |
Send several messages and each one stays its own message; the agent reads and acts on every one of them, in order.
Good to know
- Google Drive, Dropbox and Frame.io each have to be connected before you can pick from them. Koast opens the right settings tab if they aren't.
- Documents go up to 25MB. Koast takes PDFs, plain text, CSV, Markdown,
.docxand.xlsx. The Dropbox picker allows larger files, up to 1000MB. - A creative imported from Drive or Frame.io is matched back to your message by its file name, so two creatives with near-identical names can be mixed up.
- View Only teammates can't send messages to the agent, unless they're also an organization admin.