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

# APAC Ops Bot - User Manual

## What This Tool Does
The APAC Ops Bot is a secure, web-based conversational interface designed for the Asia-Pacific operations team. It allows users to:
- Chat with an AI assistant for operational support, data retrieval, and automation guidance.
- Manage conversation history (save, archive, delete, rename).
- Monitor token usage and API costs (Admin/Superadmin only).
- Administer user access and system configuration (Admin/Superadmin only).

## Who Uses It
- **End Users**: Operations staff who need AI assistance for daily tasks.
- **Administrators**: IT or DevOps personnel who manage user accounts, view system metrics, and configure the bot.

## How to Access
1. Navigate to the APAC Ops Bot URL provided by your IT department.
2. You will be presented with a login screen.
3. **Authentication**:
   - If your organization uses Microsoft Azure AD, you can log in with your corporate credentials (SSO).
   - Alternatively, if configured for internal testing, you may use simple username/password login (check with your admin if available).
4. After successful login, you will land on the chat interface.

## Main Workflows

### Starting a New Conversation
1. Click the **"New Chat"** button in the left sidebar.
2. A new conversation thread will open automatically.
3. Type your question or request in the input box at the bottom.
4. Press **Enter** to send, or **Shift + Enter** to add a new line.

### Managing Conversations
- **Select a Conversation**: Click any title in the left sidebar to view its history.
- **Rename a Conversation**:
  1. Hover over a conversation title in the sidebar.
  2. Click the **edit (pencil)** icon.
  3. Type the new title and press Enter or click outside.
- **Archive a Conversation**:
  1. Hover over a conversation title.
  2. Click the **three-dot menu** (\u22ee).
  3. Select **Archive**.
- **Delete a Conversation**:
  1. Hover over a conversation title.
  2. Click the **three-dot menu** (\u22ee).
  3. Select **Delete** and confirm.

### Copying Message Content
1. Hover over any message in the chat.
2. Click the **copy icon** that appears.
3. The content is copied to your clipboard. A brief confirmation will appear.

### Viewing Token Usage (Admins Only)
1. Click the **Admin Panel** link in the header or navigate to `/admin`.
2. Select the **Token Usage** tab.
3. View charts and tables detailing token consumption by user and date.

### Managing Users (Admins Only)
1. Navigate to `/admin`.
2. Use the user management panel to:
   - View registered users.
   - Assign roles (User, Admin, Superadmin).
   - Disable/enable accounts.

## FAQ

**Q: What happens if my session expires?**
A: You will be redirected to the login screen. Your conversations are saved on the server, so you can resume them after logging back in.

**Q: Can I export my chat history?**
A: Currently, there is no direct export feature. You can copy individual messages. Please contact your admin if bulk export is required.

**Q: Why is my message not sending?**
A: Ensure you have an active internet connection. If you see an error message, it may indicate a server issue or invalid input. Try again later or contact support.

**Q: Is my data private?**
A: Yes. Conversations are tied to your user account and are only accessible to you and your administrators (if they have audit permissions). Do not share sensitive personal information.

**Q: How do I log out?**
A: Click your user name/avatar in the top right corner and select **Logout**.