Baffin

Help

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:

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:

Your rules

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:

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.

All help articles