BuildWithHQ PlatformTemplatesSolutionsCalculatorCompare DocsLog inGet started
Permission-Aware AI

Secured AI access: AI that receives only the context the user is allowed to use

BuildWithHQ treats AI as another privileged application capability. The AI layer does not receive a tenant database and attempt to hide unauthorized records afterward. The application resolves the user’s allowed record envelope first, applies location and AI-read filters, and only then assembles RAG context, chat context, insights, or agent instructions.

How Secured AI access fits into BuildWithHQ

BuildWithHQ treats AI as another privileged application capability. The AI layer does not receive a tenant database and attempt to hide unauthorized records afterward. The application resolves the user’s allowed record envelope first, applies location and AI-read filters, and only then assembles RAG context, chat context, insights, or agent instructions.

Platform relationship: This capability uses the same tenant, record, permission, workflow, logging, AI, and extension architecture as the rest of BuildWithHQ.

Access pipeline

User context

Resolve the authenticated tenant user, active account, DataRoles, locations, and AI-read capabilities.

Record filtering

Use secured-record functions to produce only records that the user may provide to AI.

Location filtering

Pass approved location identifiers and the all-locations flag into semantic and structured retrieval.

Field protection

Exclude or separately authorize encrypted and restricted fields.

Context assembly

Build prompts, retrieved chunks, and structured record summaries from the filtered set.

AI workloads

RAG search

Embedding inventory, chunking strategies, vector dimensions, query embeddings, and reranking support controlled knowledge retrieval.

AI insights

Insights are tied to source modules and records, include confidence, severity, evidence, recommended actions, and lifecycle status.

Suggested actions

AI can propose structured actions, but application authorization and workflow rules govern execution.

Chat and agents

Interactive chat and agent sessions can use CRM contacts and record context only when the owning user has AI-read authority.

Background processing

Worker lanes route embedding, reranking, insights, and other workloads according to capability, health, load, and hardware profile.

Auditability

Query logging

AI queries and resulting actions can be recorded with tenant, user, source record, model, and operational context.

Evidence retention

Insights preserve evidence summaries and source-context hashes for review.

Action history

Suggestions, acceptance, modification, rejection, execution, and output can be tracked.

Extension evidence

AI calls through isolated appliances can be logged with request and response hashes, duration, endpoint, and disclosure information.

Security consequences

No browser trust

The client can request an AI operation, but it cannot widen the backend security envelope.

No permission inheritance assumption

Ordinary read access and AI-read access are separate decisions.

No action bypass

Generated output cannot perform a protected write, export, billing action, or approval without the required application permission.