What to document
Document what an AI model, or a newcomer, can’t know about your organization:What to leave out
- Generic troubleshooting. Any model already knows how to flush the DNS cache or what an error code generally means. Pages that repeat it make it harder to find what’s actually specific to your organization.
- What’s happening right now. An ongoing incident, such as “since the October update Outlook hangs on eleven laptops in Madrid”, isn’t a page: it goes out of date within hours. Agents get the current state of devices from the platform’s live data.
- Passwords, keys and other secrets. Store them in the Vault and link to them from the page.
How agents interpret a page
Flexxible Assist agents read the knowledge base as a set of facts and rules, not as a script to run blindly:- Rules are binding. If a page says something must not be done, the agent respects it even if its own diagnosis points in another direction.
- Fixes are hints. The agent checks them against what it observes on the device. If the fix doesn’t match what it sees, it follows what it sees and reports that the page wasn’t correct.
- What’s missing is reported. When the knowledge base doesn’t have what they needed, or has it wrong, agents report it in Missing from the KB. They don’t create or rewrite pages on their own.
How to write a useful page
Below the title, each page shows a one- or two-sentence summary, In short, which Teammate writes from the content and updates after each change. People and agents also get it in search results. If the summary doesn’t reflect what’s important, improve the page: the summary corrects itself.
Keep the knowledge base up to date
- Fix it on the spot. When a procedure changes, edit the page or tell Teammate: “The VPN client is now GlobalProtect 6.4.0”.
- Review Missing from the KB. It gathers what agents needed and didn’t find, sorted by weight.
- Check each page’s usage. Each page shows how much people and agents have used it in the last 30 days and how many of the sessions that used it were resolved without escalating. See Page usage.
- Delete what no longer applies. An outdated page alongside a newer one produces contradictory instructions. A deleted page can be restored.