Skip to main content

Project AI Knowledge

Every project has an AI Knowledge tab in its settings popup. It is where you give that one project the material the assistant should work from: the specs it can look up, and the rules it has to follow.

The tab appears once AI is licensed and enabled for the installation. Any collaborator on the project can use it — adding a document or a Skill needs no AI permission.

Two sections, and they behave differently:

SectionSubtitle in the UIWhat it is
DocumentsRead for reference, never obeyed.Reference material the assistant can search when a question calls for it
SkillsInstructions the AI follows on this project.Written instructions the assistant applies while it works

Decide which one you need

A Skill is followed. A document is only read.

That is the whole distinction, and it decides everything else. A vendor's implementation guide is reference material — the assistant will quote it, but it will never treat it as an order. A house rule you want complied with belongs in a Skill.

Put it inWhenExample
A documentReference material the AI should be able to look upAn HL7 v2 implementation guide, an X12 837 companion guide, a FHIR profile, a vendor API PDF, a customer mapping workbook, an OpenAPI spec
A SkillA rule or procedure you want followedOur field naming conventions, our error-handling standard, how we structure an adapter, which code sets to use

Put the vendor's 200-page guide in Documents. Put the three paragraphs of "and this is how we do it" in a Skill.

How the assistant uses them

Documents are searched on demand. Adding one does not push it into the prompt. When the conversation has a project in scope and the question calls for it, the assistant searches that project's documents and pulls the passages it needs. What it read shows up in the answer's evidence list, so you can check where a claim came from. No project in scope means no document search — see Modes and Project Scope.

Skills are applied according to their activation. An Always Skill is in every request for the project. An Apply when needed Skill is matched from the wording of the request. A Manual one waits until someone names it with /.

A chat attachment is a third, throwaway thing

The paperclip in the composer attaches a file to one conversation. It is yours only, it is never indexed, and it disappears with the conversation. Use it for a screenshot, a sample message, or one log excerpt — not for the spec the whole team relies on. See Attachments, Skills and Context.

Start here

I want toGo to
Let the assistant answer from a vendor spec or a mapping workbookProject Documents
Make the assistant follow this project's conventionsProject Skills
Write a rule that applies to every project, not oneOrganization Skills
Change the document count or size capsAI Policy and Limits
Attach a screenshot or a sample message to one chatAttachments, Skills and Context

Next