Skip to content

Knowledge Documents

Knowledge Documents are the place to put the business knowledge that doesn’t live in rows and columns—taxonomies, campaign-naming conventions, brand voice, KPI definitions, partner contracts, glossaries. Once attached, you can point Aliveo AI to them in Analytics Chat and Automation Agents so it understands your business better.

If you can paste it into a Doc or a Sheet, you can put it in front of the AI.


What You Can Attach

Format Use it for
Google Docs Long-form prose: strategy briefs, brand books, naming conventions
Google Sheets Lookups and taxonomies: market codes, audience definitions, KPI mapping tables
CSV File Same as Sheets, when you’d rather upload a static snapshot
Custom Text Short notes you don’t want to keep in a separate file

You can attach as many documents as you like. Aliveo reads a document only when you @-mention it (see How Documents Get Used).


Scoping Documents

Each document is scoped to one of three levels:

  • Global — applies organization-wide. Good for company glossaries, brand books, KPI charters.
  • Org (short for Organization) — applies to a single business, or line of business. Good for LoB-specific playbooks.
  • Account — applies to a single connected ad account or data source. Good for account-specific contracts, market mappings, or audience definitions.

Documents inherit downward (Global is visible from every business and every account; Org is visible from every account inside that business). Account-attached documents stay account-scoped.


Attaching a Document

Global documents

  1. Open My Account → Global Context.
  2. Under Connected Documents, choose Google Docs, Google Sheets, CSV File, or Custom Text in Select a source, then click Connect Now.
  3. Add a Document Title. It’s optional for Google and CSV sources and required for Custom Text.
  4. Add the content:
    • Google Docs / Google Sheets — share the file (edit access) with the email address shown in the dialog, then paste its URL.
    • CSV File — upload the file.
    • Custom Text — paste or type your text.
  5. Save.

Org-scoped documents

  1. Open My Account → select a business.
  2. Open the Documents tab.
  3. Follow the same flow as above. The document only applies within the active business.

Account-scoped documents

  1. Open My Account → select a business.
  2. In the Platforms tab, click the Account Context icon on the account’s card.
  3. Under Connected Documents, click Connect. Documents you attach here can also be reused across other accounts within the same business via the Applies to these accounts selector.

Viewing and Editing

Each document’s card shows its source and status, and gives you these actions:

  • Edit title — give it a clearer title without re-uploading.
  • Manually sync (Google Docs and Sheets) — pull the latest version of the file.
  • View content and Edit content (Custom Text) — read or change the text inside Aliveo.
  • Delete — erase the document and all its data from Aliveo. To use it again, you have to reconnect it. (The original file in Google Drive is untouched.)

Document status

A document is Pending or Processing while Aliveo reads it, then Completed when it’s ready to use, or Failed if it couldn’t be read. Aliveo also checks every document for unsafe content when it reads it. A document that fails this review shows Blocked: Aliveo doesn’t use it, and you can contact support to restore it.


Referencing Documents in Context

When you write context, you can point to a specific document or dataset by typing @ followed by its name, e.g. “Always consider the latest budget from @BudgetDocument and revenue from @SalesData.” This tells Aliveo exactly which source to use for that rule.


How Documents Get Used

Documents are not stuffed into every prompt. Aliveo reads a document when you @-mention it:

  • In your saved context — the document is used whenever that context applies, in Analytics Chat and Automation Agents.
  • In a chat question — the document is used for that question.
  • In an agent's instructions — the document is used for that step.

When there's a question to answer, Aliveo reads only the passages of the document that best match it.


Best Practices

  • Use real titles. “Brand Voice Guide v3 (Q2 2026)” beats “Untitled Sheet (1).”
  • One concept per document. Smaller, focused docs are picked up more reliably than 200-page mega-docs.
  • Tables work best as Sheets. If your document is a lookup table (market codes, audience IDs), put it in a Sheet, not a Doc.
  • Scope intentionally. Don’t attach an account-specific doc globally—Aliveo may then use it for accounts where it doesn’t apply.
  • Sync after big changes. When a Google Doc or Sheet has materially changed, use Manually sync to pull the latest copy.

A Note on Security

Aliveo reads Google Docs and Sheets through the service account email you share them with. No credentials are stored. CSV uploads and custom text are encrypted at rest in your organization’s storage (see Security and Privacy).