Ask the assistant
The team's AI over the whole app. Ask it about your data, have it work the conversation you have open, make changes, and use it from Slack and Discord.
The assistant can do what you can do in Median, with your role, and asks before anything that reaches customers or can't be undone. To work a conversation with it step by step, see Use the assistant on a conversation.
Open it
| Where | How |
|---|---|
| Top bar | The Median mark next to the search button opens the assistant sidebar on the right. Press it again to close |
| A link from Slack or Discord | Open in Median on an approval ping opens the page the waiting call is about |
| Slack and Discord | Message or mention the Median app or bot. See In Slack and Discord below |
On a wide window the sidebar sits beside the page and the page makes room for it. Drag its left edge to make it wider or narrower, from 320 to 560 pixels. Double-click the edge to reset it. The width resets when the page reloads. On a window narrower than 1024 pixels it slides over the page. It keeps your chat and any unsent message while closed.
| Button | Where | Does |
|---|---|---|
| Plus | Top of the sidebar | Starts a new chat |
| Clock | Top of the sidebar | Opens Chats, your earlier chats. Press it again to go back |
| Close | Top of the sidebar | Closes the sidebar |
| Plus | Message box | Attaches files |
| Arrow | Message box | Sends. While an answer is arriving it becomes a stop button |
The assistant needs Standard or Pro, and each answer uses credits. On Explore you cannot send, and a line under the box reads Available on Standard and Pro. See Plans.
The open conversation
With a conversation open in the inbox, it shows as a chip over the message box, and every question you send carries it. The assistant reads that conversation before it answers, so you don't have to say which conversation you mean.
| Detail | |
|---|---|
| Chip | The conversation's subject and its number, such as W-12. It changes when you open another conversation |
| Leave it out | The cross on the chip. Applies until you open another conversation, or come back to this one |
| What it reads | The newest 40 messages, notes included, the customer and what is known about them, up to 5 of their other conversations, the signals and tasks filed from it, and the tools that can run on it |
| Your question | Shows the conversation's number and subject above it, linking back to the conversation |
| Message box | Reads Ask about this conversation |
Text in a conversation was written by the customer or the agent. The assistant treats it as what happened, not as instructions. A customer asking for a refund is something it raises with you, not something it does.
Reply drafts
Ask for a draft and the assistant writes it into that conversation's reply box. Nothing reaches the customer until you send it.
| Your reply box | What happens |
|---|---|
| Empty | The draft goes straight in |
| Already has your words, or is set to Note | A Drafted reply chip appears over it. Use switches the box to Reply and puts the draft in place of your words. The cross dismisses it |
- A draft waits for the person who asked for it, and only in that conversation.
- A newer draft replaces the older one.
- Sending a reply clears your draft on that conversation.
- Ask it to send the reply instead and it waits for your approval, as below.
What it can do
Every call runs with your role. If you are a member and ask it to change the agent, the call is refused the same way the page would refuse you. See Roles and permissions.
| Area | Reads | Changes |
|---|---|---|
| Inbox | Conversations and their threads, with the signals and tasks filed from each | Reply, draft a reply, add a note, set status, archive, snooze, mark read or unread, hand a thread to or from the agent, stop the agent's reply, delete |
| Customers | The directory, one customer's history and learned facts | Edit name, email, company, title and location, refresh a profile, reach out, forget a fact, delete a customer |
| Knowledge | Search, documents, folders, the review queue, website imports | Write, edit, move and delete documents. Create, rename, move and delete folders. Approve or dismiss suggestions. Retry a failed document. Start or stop a website import. Sync connected sources |
| Signals | Bugs and suggestions, one report in full | File, edit, set priority and status, merge, delete, open an issue in Linear or GitHub, confirm or dismiss a fix commit |
| Tasks | The board, one card with its commits and comments, requests waiting for a decision, the board's settings | Create, edit, move and delete cards, comment, put a request on the board or decline it, change the board's settings |
| Feedback board | Its boards, statuses and tags, posts, one post and its discussion | Create, edit, approve or hide, move, reply to, merge and delete posts. File a post under a signal |
| Numbers | Headline numbers, conversation volume, satisfaction, signal counts, library health, spend and credits, plan, invoices, API allowance, usage history, the activity log, any explorer dataset | |
| Agent | Profile, behavior, your tools and their endpoints, waiting tool calls, suggested tools | Change profile and behavior, test or run a tool, switch a tool on or off, connect, disconnect or sync an endpoint, approve or deny the agent's waiting calls, mark a suggested tool built or dismiss it |
| Integrations | Email, Slack, Discord, GitHub, docs sites, Notion and Linear settings | Turn email on or off, set the Slack channel, set up Discord channels and the staff role, choose where signal issues go, watch a repository's commits, connect or disconnect a repository for knowledge, set a published docs address |
| Site | Appearance, domain, sign-in, sections, published articles | Change appearance, connect, check or remove a domain, set the sign-in method, put the site up or down, switch sections, publish or unpublish articles |
| Team | The organization, members, invitations, webhooks | Rename the organization, change a role, remove someone, invite someone, send an invitation again, revoke an invitation, add, change or remove a webhook |
| Billing | See Numbers | Show or hide Median branding |
| Keys | Median keys | Revoke a key |
| Web | Search results, and a web page once you approve reading it | |
| Docs | The help center and the developer docs |
It can also ask you to fill in a form, and link you to the page it is talking about.
These stay in the dashboard:
- Installing the Slack app or the Discord bot, and connecting Notion, GitHub or Linear accounts
- Creating Median keys, since a new key is shown in full only once
- Buying a plan, credits or add-ons
- The Customize page's draft and publish, and uploading pictures like the site logo
- The OpenID Connect client secret for site sign-in
- Setting up the feedback board's boards, statuses and tags
- Leaving or deleting the organization
The assistant can do what the MCP server, the CLI and the API can, except create keys. See Capabilities in the developer docs.
Every call that reads or changes your organization's data counts against your organization's API rate limits. Web searches and web page reads do not.
Approvals
These calls wait for your approval.
| Area | Waits for approval |
|---|---|
| Inbox | Sending a reply, adding a note, deleting a conversation |
| Customers | Changing a customer's email, reaching out, forgetting a fact, deleting a customer |
| Knowledge | Deleting a document or folder, approving a suggestion, importing a website |
| Signals | Filing a signal, marking one done, merging, deleting, opening an issue, closing one from a commit |
| Tasks | Moving a card to done or putting a request on the board as done, deleting a card, declining a request, changing the board's settings |
| Feedback board | Every change except filing a post under a signal |
| Site | Every change except checking a domain |
| Agent | Changing profile or behavior, testing or running a tool, switching a tool on or off, connecting or disconnecting an endpoint, deciding the agent's waiting calls, marking a suggested tool built or dismissing it |
| Integrations | Every change |
| Team | Renaming the organization, changing a role, removing someone, inviting someone or sending an invitation again, adding, changing or removing a webhook |
| Billing | Showing or hiding Median branding |
| Keys | Revoking a key |
| Web | Reading a page |
Everything else runs at once. That covers every read, drafting a reply, writing and editing documents, moving things, and changing a conversation's status.
A waiting call shows as a card marked Needs approval under the answer, with what it would make. When one answer parks two or more calls, they share one card headed N actions need your approval, with a row for each.
| Button | Where | Result |
|---|---|---|
| Approve | One call's card, or the check on a row | The call runs. The card becomes one line saying what happened |
| Deny | One call's card, or the cross on a row | Nothing runs. The line reads Denied |
| Approve all | The shared card | Every call still waiting runs, in the order the assistant asked |
| Deny all | The shared card | None of the calls still waiting run |
- The arrow on a row shows what that call would make.
- Decide in the assistant sidebar, or with the buttons in Slack and Discord.
- Only the person who owns the chat can decide.
- The assistant carries on after the last call on an answer is decided.
- A call that fails shows its error, or Did not run.
The agent's own tool calls on customer conversations are a different queue. See Approve tool calls and run tools.
Forms
When a job needs a value it cannot find, the assistant puts a form in the chat.
- Up to 6 fields. Each is one line of text, a paragraph, a choice, or yes or no.
- Send answers. It works once every required field is filled.
- Skip leaves the form unanswered, and the assistant carries on without it.
While a form or an approval waits, the message box reads Answer the question above to continue and cannot send.
Chats
| Rule | Detail |
|---|---|
| Who can see a chat | Only you. Nobody else in the organization can open it, owners included. Another person's link shows Chat not found. |
| Title | The first line of your first message, up to 60 characters |
| Rename | Up to 80 characters |
| History | The clock button at the top of the sidebar opens Chats. It lists your 100 most recent chats. The open chat is highlighted |
| One answer at a time | Sending while an answer is arriving gives "Wait for the reply to finish." |
| Stop | The stop button, a square in place of send, ends the answer and keeps what it wrote |
In Chats, each row's menu has Rename and Delete. While renaming, Enter saves and Esc cancels. Delete asks you to confirm in Delete chat, then removes the chat and all its messages, with no undo.
Attach files
Attach with the plus button, by dropping files on the box, or by pasting.
| Limit | Value |
|---|---|
| Files per message | 6 |
| Size per file | 25 MB |
| Refused types | HTML, XHTML, SVG, XSL |
| File | What the assistant gets |
|---|---|
| PNG, JPEG, WebP or GIF, up to 5 MB | The picture. It sees the 4 newest pictures in the chat, up to 5 MB together |
| Text, up to 256 KB. Plain text, Markdown, CSV, JSON, YAML, XML, logs, config files and source code | The first 6,000 characters of each file, and 12,000 characters across the chat, newest files first |
| Anything else, such as a PDF | The file's name, type and size |
Limits
| Limit | Value |
|---|---|
| Message length | 8,000 characters |
| Chat history it reads per answer | The last 40 messages |
| Steps per answer | 14. Past that it stops with what it has written |
| Messages shown in a chat | The latest 100 |
| Fields per form | 6 |
Errors
| Message | Cause |
|---|---|
| Enter a message before sending. | Empty message and no files |
| This message is too long. Shorten it or send it in parts. | Over 8,000 characters |
| Messages can carry 6 files at most. | More than 6 files |
| "name" is larger than the 25 MB limit. | A file over 25 MB |
| "name" is a kind of file we cannot accept. Send it as a screenshot or a plain text file. | An HTML, SVG or XSL file |
| The response was interrupted. Ask the assistant to continue. | The answer failed partway |
| This needs the Standard or Pro plan. | The assistant was asked from Slack or Discord on Explore |
| Your organization is out of credits. Add more in Settings, Billing. | Credits ran out |
| The assistant returned no response. Try sending your message again. | The answer came back empty |
| This chat is no longer available. Start a new chat. | The chat was deleted |
In Slack and Discord
Slack messages, and mentions in a Discord server, need that workspace or server connected to your organization. Discord direct messages need only a linked account. See Slack and Discord.
| Slack | Discord | |
|---|---|---|
| Start a chat | Message the Median app directly. Each top-level message starts its own chat. Or mention the app in a channel, and it answers in a thread | Mention the bot in a text channel, and it opens a thread named after your message. Or send it a direct message |
| Carry on | Reply in the thread | Reply in the thread. In a direct message, keep typing. New chat under an answer starts over |
| Suggested prompts | A new direct message offers Today, Needs a person, Bugs and The agent | Not available |
| Stop an answer | Not available | Stop under the answer |
| Approvals | A Waiting on you card with Run it and No, plus Open in Median when the call has a page | Same |
| Forms | A One question card. Answer opens the form | Same. A form with more than 5 fields sends you to the app |
- Each thread is an ordinary chat. It shows in Chats with the platform's mark, and you can carry it on in the app.
- The sidebar header shows the Slack or Discord mark. For a thread in a Discord server, the mark links back to the thread.
- Messages are text only. Files posted in Slack or Discord do not reach the assistant.
- On Discord, the bot stays out of ticket channels.
| Reply | Cause |
|---|---|
| This conversation belongs to another Median account. | Someone other than the chat's owner wrote in the thread |
| Only the person who started this request can answer it. | Someone else pressed a button on a card |
| Still working on the last one. Give it a moment. | An answer is still arriving |
| Respond to the request above to continue. | A card is waiting for a decision |
| This server is not connected to Median. Connect it at ... and I can answer here. | The Discord server is not connected to any organization. Slack says "workspace" |
| This server belongs to a different Median organization than your account does. | Your account is linked to another organization |
| I could not open a thread here. Can I make threads in this channel? | The bot lacks permission to create threads |
| Say what you need and I will get on with it. | You mentioned the Discord bot with no message |
| Mention me in a normal text channel and I will open a thread. | You mentioned the Discord bot outside a text channel, such as in a forum or voice channel |
Link your account
The assistant answers only a linked chat account. A Slack account whose email matches a member of the organization that installed the app links itself on the first message. Any other account gets Link my account. Linking, unlinking and the link rules are in Link your account.
In Logs
Admins and owners see the assistant's work in Logs. Filter Done by to Assistant.
| Entry | Records |
|---|---|
| Assistant reply | One per answer, with the tools it used, tokens and credits |
| Changes it made | The same entries a change from the page makes, with Assistant as the actor |
| Tool call approved, Tool call declined | Your decision on one of its waiting calls. Logged with you as the actor, so it shows under Done by → Team, not Assistant |
Log entries never include what was said in a chat.