---
auto_generated: true
created: 2026-05-18
manual_updated_at: 2026-05-18
modified: 2026-05-18
name: User_Manual
status: active
tags:
- client/oliver
- domain/ai
- domain/security
- status/active
- tech/azure-ad
- tech/fastapi
- tech/postgresql
- tech/react
- tech/redis
- type/sop
type: sop
---

# Enterprise AI Hub Nexus - User Manual

## Overview
Enterprise AI Hub Nexus is a secure, enterprise-grade AI platform designed for OLIVER Agency. It provides intelligent knowledge management, a RAG-based chat interface, and integration with Microsoft 365 productivity tools. The platform allows users to interact with company data securely using natural language, with responses contextualized by department and region.

## Who Uses It?
- **All Employees**: To access company knowledge, ask questions, and get AI-driven answers.
- **Content Managers**: To upload, manage, and index documents in the knowledge base.
- **Super Admins**: To manage system settings, user roles, and security configurations.

## How to Access
The platform is accessible via the public URL: **https://ai-sandbox.oliver.solutions**

### Authentication
- **Provider**: Microsoft Entra ID (Azure AD).
- **Flow**: PKCE (Public Client) SPA flow. No client secret is required for the frontend.
- **Login**: Click "Sign In" and use your corporate Microsoft 365 credentials.
- **Token Lifetime**: JWT tokens last for 8 hours.

## Main Workflows

### 1. RAG Chat (Ask a Question)
Nexus answers questions based on your company's knowledge base with source citations.

1. Navigate to the **Chat** tab.
2. Type your question in natural language (e.g., "What is the policy on remote work?").
3. Click **Send**.
4. Review the AI-generated response, which includes:
   - The direct answer.
   - Source citations (links to the original documents).
   - Language matching (ask in any language; reply in the same language).

### 2. Personal Assistant (Microsoft 365 Integration)
Access read-only data from your Microsoft 365 account.

1. Navigate to the **Assistant** tab.
2. Request information such as:
   - **Emails**: "Show my latest emails from [Sender]."
   - **Calendar**: "What are my meetings today?"
   - **Files**: "Find documents in OneDrive named [Keyword]."
   - **SharePoint**: "List recent files in [Site Name]."
3. *Note*: Integration is **read-only** for security.

### 3. Knowledge Base Management (Admins & Content Managers)
Manage the documents that fuel the AI's answers.

1. Navigate to the **Admin** > **Knowledge Base** section.
2. **Upload**: Click "Upload Document" to add new files (PDF, DOCX, TXT, etc.).
3. **Manage**: Edit metadata, tag by department/region, or delete existing documents.
4. **Re-index**: Trigger a re-indexing process to update the vector database with new/updated content.

## FAQ

**Q: Why can't I edit documents in SharePoint via Nexus?**
A: The Microsoft Graph integration is configured for **read-only** access to protect data integrity.

**Q: Is my data shared externally?**
A: No. All data processing happens within the Enterprise AI Hub Nexus infrastructure (GCE VM + Google Cloud Run). External AI APIs (OpenAI, Anthropic) are used solely for inference, not storage.

**Q: How is my content scoped?**
A: Content is filtered by **Department** and **Region** to ensure you only see relevant information for your team.

**Q: What if I forget my password?**
A: Since authentication is handled by Microsoft Entra ID, reset your password via the standard Microsoft 365 password reset flow.

## Related
- [[01 Projects/Oliver-ai-bot_2.0/USER_MANUAL]]
- [[01 Projects/Oliver-ai-bot_2.0/USER_MANUAL.md]]
- [[01 Projects/enterprise-ai-hub-nexus/USER_MANUAL.md]]
- [[01 Projects/Oliver-ai-bot_2.0/DEVELOPER_MANUAL.md]]