Skip to main content

🤖 Ask (Name) - AI Assistant

Get instant AI-powered answers about your CC&Rs and bylaws.

Once documents are uploaded and indexed, Vlge's AI-powered assistant can instantly answer questions about your community's rules, CC&Rs, bylaws and other topics you've updated to include guidance. No more searching through lengthy documents!

👉 You can name the AI Assistant for your community in General Settings in the lower left navigation - look for "Preferences".

What AI Can Help With

  • CC&R Questions - "What are the fence height restrictions?"

  • Bylaw Clarifications - "How many board members do we need for a quorum?"

  • Process Questions - "How do I submit an ACC request?"

  • Deadline Information - "When is the next board meeting?"

  • General Community Questions - "What amenities are available?"

How to Use The Assistant

  1. Click on "Ask [Name]" in the Community Home page

  2. Type your question in natural language

  3. The assistant will search your "indexed" community's documents

  4. You'll receive an answer with source citations

  5. Ask follow-up questions if needed

Tips for Best Results

  • Be specific - "What color can I paint my fence?" works better than "fence rules"

  • Ask one question at a time - For complex topics, break into multiple questions

  • Check the sources - Rose cites the documents where answers come from

What AI Can't Do

  • Make decisions for the board or ACC/ARB/DRB

  • Submit requests on your behalf

  • Access private or financial information

  • Provide legal advice


👉 How to view your AI Source information (Admins)

Visit General Settings from the left nav and find AI chat Guidance.

Open that page.

Under Document Knowledge, it will show you exactly what documents have been indexed. In the sections just above, you will have a chance to enter general guidance or topic-specific guidance. Information and guidance entered there by you or your board will be used for answers by the AI agent

You can then Add Documents to be indexed by the AI agent for additional use in answering prompts from you and your users.


Document Knowledge: Frequently Asked Questions

Adding documents

What documents does the AI assistant learn from? The assistant uses several sources together:

  • Key Documents. Your CC&Rs, Bylaws, and other governing documents. Every Key Document is included automatically unless you exclude it.

  • Community Documents you choose. Add them under General Settings → AI Chat Guidance → Document Knowledge → Add Documents.

  • Published FAQs. Included automatically. Draft and archived FAQs are left out.

  • Your guidance. General Guidance, Topic-Specific Guidance, and your ACC/ARB Guidance Items.

  • Community meetings. Listed under "Other Knowledge" on the AI Chat Guidance page, which shows exactly what is included.

Do I need to add my Key Documents to the AI? No. Every Key Document is indexed automatically as soon as it's uploaded. The "Add Documents" button is only for Community Documents.

Why can't I find a document in the "Add Documents" list? The list for the main assistant only shows Community Documents in folders open to all members. Board-only and admin-only folders are left out so residents never get answers drawn from documents they can't open. Folders limited to specific people or groups are also left out. To use board-only documents, add them to Board Help AI-Specific Knowledge instead.

What does the greyed-out "Already added" label mean in the picker? That document is already in this index, so it can't be selected again. An open, clickable checkbox means the document hasn't been added yet. The Document Knowledge index and the Board Help index are tracked separately, so a file can be "Already added" in one and open in the other.

What file types are supported?

  • PDF (best results with digital PDFs; scanned PDFs are covered in the next question)

  • Word (.docx)

  • Plain text (.txt), Markdown (.md), and CSV (.csv)

Older Word (.doc), Excel, PowerPoint, and image files (JPG, PNG) aren't indexed. Save them as PDF or .docx first. If you add an unsupported file, the table shows a message naming the file type.

How and when indexing happens

What does "indexing" actually do? The AI doesn't read the whole file every time someone asks a question. When a document is indexed, Vlge:

  1. Extracts the text from the file.

  2. Checks how much readable text it found. This decides the status: Indexed, Limited, or Failed.

  3. Splits the text into short passages of a few paragraphs each, keeping section headings with their text where possible.

  4. Stores those passages so the assistant can search them quickly.

When a resident asks a question, the assistant searches all of these passages and pulls the most relevant ones, usually up to about ten, to write its answer.

When are documents indexed?

  • Key Documents: automatically, in the background, right after upload.

  • Community Documents: right after you click "Add and Index Selected". A progress box in the lower right shows each file as it's processed, then shows "Complete".

  • Replaced files: if you replace the file on a Community Document that's already in the AI index, it's re-indexed automatically.

  • FAQs and guidance: these don't need indexing. Edits are available to the assistant immediately.

How long does indexing take? Most digital PDFs and Word files take a few seconds each. Long or scanned PDFs can take up to a minute or more, because scans need text recognition (OCR). You can keep working, or leave the page, while the progress box runs. Only closing or reloading the browser tab interrupts it.

What happens with scanned PDFs? Vlge first tries to read the text directly. If it finds no usable text, which is typical for a scan, it automatically runs text recognition (OCR). How well that works depends on the scan: crooked, blurry, handwritten, or marked-up pages produce less usable text. See "Regarding Document Quality" above for how to get the best results.

When should I click "Re-index Documents"? You rarely need to anymore, because new and replaced documents are indexed automatically. Re-indexing is useful when:

  • A document shows Failed or Out of date and you want to try again.

  • You want to refresh everything after a large batch of changes.

Re-index processes all of your Key Documents, except excluded ones, plus every Community Document already in that index. It doesn't add new documents; use "Add Documents" for that.

Understanding the status column

Status

What it means

Indexed

Good text was extracted and the assistant can use the whole document.

Limited

Only some text could be read, usually because the file is a scan or low quality. The assistant can use what was read, but may miss parts.

Failed

No usable text was found. The assistant can't use this document.

Out of date

The file changed after it was indexed. Click Re-index to update it.

Not indexed

The document hasn't been processed yet, or processing didn't finish. Click Re-index.

Excluded from AI

An admin turned this Key Document off for the AI.

The "chars · chunks" line under a status shows how much text was read and how many searchable passages it produced. A long document showing very few characters is a sign the text didn't come through well.

⭐️ Removing & Excluding Documents

How do I remove a Community Document from the AI? Click Remove next to it in the Document Knowledge table. Its indexed text is deleted and the assistant stops using it right away. The document itself stays in Community Documents.

How do I stop the AI from using an old or superseded Key Document? Key Documents can't be removed from the AI, but they can be excluded. Either:

  • Click the eye icon next to the document in the Document Knowledge table, or

  • Open the Key Document's edit form and check Exclude from AI.

The assistant stops using it immediately and its indexed text is deleted. The document stays in Key Documents for your records. To use it again, click the eye icon again or uncheck the box, and it's re-indexed automatically.

👉 Tip: When you adopt an amended CC&R or Bylaw, upload the new version and exclude the old one. Otherwise the assistant may quote outdated language.

What happens if I delete a document or change its folder's access?

  • A deleted document stops being used by the assistant right away.

  • If a folder is changed from all-members to board-only or admin-only, the main assistant stops using its documents automatically. Board Help can still use them if you've added them there.

Answers and sources

Why does an answer show a particular source, or none at all? When the assistant answers, it reports which documents, FAQs, or guidance it actually used, and only those appear under "Sources used for this answer". If the answer came from general knowledge rather than your community's material, no sources are shown. Click a source to see the passage it came from.

Why does the source text look different from my document? The viewer shows the extracted text, not the original page layout. Text from scanned documents is cleaned up for reading, but tables, columns, and formatting may not appear exactly as on the page.

The assistant gave a wrong or incomplete answer. What should I check?

  1. Status of the relevant document. If it's Limited or Failed, the assistant may not have the text it needed. Upload a cleaner digital version.

  2. Older versions. An outdated version may still be in the index. Exclude old Key Documents and remove old Community Documents.

  3. Wording. The assistant searches for passages that match the words in the question. If your documents use different terms than residents do (for example "architectural modification" vs. "fence"), add a Topic-Specific Guidance rule or an FAQ that connects them.

  4. Common questions. For questions that come up often, an FAQ or guidance rule gives the most consistent answer.

Board Help

How is Board Help's knowledge different? Board Help uses everything the main assistant uses, plus any documents added under Board Help AI-Specific Knowledge. Those can come from board-only or admin-only folders. Documents added there are never used by the resident-facing assistant.

Customizing the chat

Can I change the assistant's greeting? Yes. Go to General Settings → AI Chat Guidance → Chat Greeting. You can edit:

  • The first message residents see.

  • The hint text inside the question box.

Leave either field blank to use the default. The {assistantName} and {accName} placeholders keep the text correct if those names change later.

🛟 Need more help? Just ask!

Did this answer your question?