AI instructions
How owners turn on AI writing, write the rules every AI follows here, preview what AI tools receive, and let AI tools write pages.
AI instructions, in Settings, is where owners decide how AI tools write in this knowledge base. It has two tabs: Set up and Instructions. Members don't see this page.
Turn on AI writing
Until writing is set up, AI tools can read but not save. Choose Set up AI writing once. It adds:
- writing rules that publish ordinary saves (Notes and pages) right away;
- a Note record type for things you ask your AI to remember;
- the guidance every AI reads before it writes.
The tab then confirms that AI writing is set up. It also shows what an AI tool needs: the MCP server URL and the Knowledge base ID (your AI can usually find the knowledge base by name). Then connect a tool with Read and write. See Connect your AI.
The tab may show something else instead:
- Finish setting up AI writing: setup stopped part way. Choose it to add what's missing.
- Finish your AI instructions: choose Open AI instructions, review the rules and save.
- Let AI tools write pages: this knowledge base was set up before page writing was a default. AI tools can save Notes, but they can't add to the inbox, add to a page or compile. Choose Open AI permissions and turn on Add new pages and Edit pages, then Save.
Your rules
- Rules for every save: plain sentences every AI tool follows here. For example: "Write dates as YYYY-MM-DD." "Never record personal phone numbers." "Customer names go in the Customer record, not in Notes." These are advice. Baffin enforces permissions and review on its own.
- Turning notes into pages and Pages AI tools keep up to date: how inbox notes become pages and records. See The inbox and compiling.
- Advanced: Baffin's own guidance on how to write well and how to compile. Keep Use the Baffin default (recommended), or choose Customize and Compare with default. When Baffin publishes a newer default, this section offers to compare it with yours. Baffin's fixed steps and a summary of your write policy are shown here too, and can't be edited.
Preview what AI tools see shows the exact instructions an AI tool receives, on the Everyday write and Compile run tabs, including your unsaved edits. Choose Save in the bar that appears to apply your changes. Every save is kept under Saved versions, and Restore brings back an earlier one.
If you see "Your AI writing instructions use the old format", review the page and save once to switch.
What AI tools may change
Your instructions say how to write well. AI permissions say what AI tools are allowed to do. To change them, open Settings, then AI permissions, change what you need, and choose Save:
- When an AI tool saves something: Publish right away or Always wait for my review.
- What AI tools can change: a switch for each kind of change, such as Add new pages, Edit pages or Add records. At least one stays on.
- Folders that always need your review: AI changes to pages in these folders wait for your review. Choose Choose a folder and pick one, or type a folder such as wiki/sops/ or a single page.
- New kinds of records: Off, I approve each one, or Add them automatically; see Record types.
If someone has unpublished changes to these rules under Data structure, AI permissions shows the current rules read-only until those changes are published or discarded.
Choose Save once: the new rules take effect and your AI instructions update in the same step.
With more than one knowledge base
AI instructions belong to one knowledge base: each knowledge base has its own rules, write policy and setup, and an AI tool follows the ones of the knowledge base it is saving to. Your AI picks that knowledge base from its What goes here, asks when two fit or none does, and says where it saved. Set up AI writing in each knowledge base you want AI tools to save to. See Multiple knowledge bases.
To tell AI tools which outside system holds what, see Information locations.