Appearance
The assistant
Ask about anything you can read in the workspace. The assistant searches, reads pages and follows links for you, then answers and says which pages the answer came from. It can change pages as you could — asking you first, unless you have told it not to — or suggest a change, which waits in Review for somebody to accept.
Open it from the Assistant tab in the right-hand panel. If a page is open, "this page" means that one.
What it can do
- Read — search, find pages by name, read a page or a page and everything under it, read a named block, run a saved view, see what links to a page and what changed recently.
- Suggest — propose a new version of a page. The page is not changed: the suggestion goes to the people who look after it, block by block, and they decide.
- Write — change a page's text, add to the end of one, make a page, rename or move one, set a property, add a task or tick one.
- Remove — move a page to the trash.
It works as you. It can read only what you can read, and it can never do more than you could. A page somebody has not shared with you is one your assistant cannot find either, and a page you may only read is one it cannot change, whatever you answer.
While it works, the panel says what it is doing — Searched for “retries”, Read a page, Suggested a change — and Stop ends it.
Asking first
What it may do without asking you is yours to choose, in Settings → Account → Assistant:
| Writing | Removing | |
|---|---|---|
| Ask me first (the default) | shown, then done only if you say so | always |
| Without asking | done, then shown with Undo | — never |
| Never | not offered to it at all | not offered to it at all |
When it asks, the panel shows exactly what would change — the lines it would add and take away — with Apply, Apply, and don't ask again here (for the rest of that conversation), and Don't. If you say no, it is told not to try another way. A question nobody answers within five minutes is a no.
Undo takes a change back by merging the page from what the assistant wrote to what it read, so anything somebody else wrote since stays. Where that clashes, nothing is changed and the page's History is the way back. A page it moved to the trash comes back from the trash.
Your workspace may allow less than you choose: its administrators set the most a member may let it do without asking.
In the timeline, what it wrote is yours — it wrote it for you — and marked with the assistant, until you change it yourself.
Writing up a draft
Write something rough (notes from a call, a list of points), then choose Write this page up with the assistant in the palette. The assistant treats the page as a draft. It works out where the writing belongs, such as a new page under a related one or the end of a page you started, and writes it in the workspace's own terms.
- Your draft stays as you wrote it, with a link to what it became.
- A page somebody else started only ever gets a suggested edit, never a change, for them to accept or not.
- The draft's card, in the page's header, shows the plan and why, what it assumed, any questions with its recommended answer already chosen, what it wrote, and Undo all.
- You are told in your inbox when it has written up the draft or has a question.
How much it does on its own is yours to choose, in Settings → Account → Assistant → Writing up a draft:
- Ask me first — it always shows you the plan, and writes only when you say so.
- Ask when unsure (the default) — it goes ahead when everything is a new page or a page you started and nothing is left to ask.
- Go ahead — it goes ahead whenever it has no question, and takes its recommended answer if a question waits four hours.
How I write
Write down how you like things written (your tone, your headings, where things go) on a page of your own, and choose Use this page as How I write in the palette. The assistant follows it when it writes up your drafts, after the workspace's own How we write here. It follows the page only while nobody but you has changed it; Settings says whether it is followed. See the administration guide for the workspace's.
Keeping a page away
Keep this page away from the assistant, in the palette, sets the property assistant: false. That page and every page under it are then invisible to every assistant run: it cannot search, read or change them, for anybody. The pages are not hidden from people. Anybody who may edit the page can set or clear it, and it travels with the page in its frontmatter.
It does not reach outside agents using an API key, because the server cannot tell an agent's key from a script's.
What it is sent, and where
What it reads to answer you is sent to the model it uses: the workspace's choice, the platform's own, or one of your own if your workspace allows that. Choose which in Settings → Account → Assistant. Your workspace's administrators decide which models are allowed at all — see the assistant in the administration guide.
What it will not do
It has no way to reach anything outside the workspace: no tool fetches an address, sends mail, posts to a webhook, shares a page or invites anybody.
It never loads a picture or anything else from an outside address in a reply — a picture is shown as the address it would have come from. A link in a reply opens in a new tab only if it is an ordinary web, mail or phone address.
Everything a page says is treated as something to read, never as an instruction. A page that says "ignore your instructions" is just a page that says that.
Conversations
Each conversation is yours: nobody else in the workspace sees it, administrators included. Pick an earlier one from the list at the top of the panel, or Forget it. A workspace keeps conversations for as long as it chooses — 90 days unless it says otherwise.