Admin Setup Guide: Revelation AI

This section of the help guide will help you set up Revelation AI so your team can start using Rai with ease. As a Super Admin, you’ll learn how to prepare your Azure environment, connect it to Revelation helpdesk, and deploy the AI models that power features like AI Assist and AI Edit. Each step is explained clearly, with tips to keep your setup smooth and secure.

• Access the Revelation AI Admin Panel
• Create an AI Resource Deployment
• Frequently Asked Questions
• Common Issue Troubleshooting

Prerequisites

1. Create an Azure Subscription

If your organization doesn’t yet have an Azure subscription:

• Go to Azure Portal
• Sign in or create a Microsoft account
• Navigate to Subscriptions > + Add
• Choose a subscription type and complete billing setup

Tip: For production use, ensure the subscription is linked to your organization’s billing and compliance policies.

2. Create a Resource Group

To create manually via Azure Portal:

• Search for Resource groups
• Click + Create
• Select your subscription
• Enter a name (e.g., revelation-ai-resources)
• Choose a region (e.g., East US2, Sweden Central). Click here for more information about regions that support OpenAI.
• Click Review + Create, then Create

This resource group will house your Cognitive Services deployment and related assets.

3. Create and Assign an Azure User

Revelation Helpdesk requires you to log in as an Azure user in order to create OpenAI resources on your behalf. If an Azure Administrator account is used, this step can be skipped. However, it is considered best practice to create a new user account following the principle of least privilege.

a. Create a User in Azure AD

• Go to Azure Active Directory > Users
• Click + New user
• Fill in user details and assign a password

b. Assign Role to Subscription

• Go to Subscriptions > Select your subscription
• Click Access control (IAM) > + Add > Add role assignment
• Role: Cognitive Services Contributor
• Assign to: User
• Select the newly created user
• Click Save

This role allows the user to create and manage Cognitive Services resources without full admin access.

4. Create an Azure Budget

Recommended for cost control and token usage monitoring

To prevent unexpected charges from AI model usage, it’s recommended to set up a budget in the Azure subscription tied to your AI resource group.

Step-by-Step: Create a Budget

1. Go to Azure Portal
   Navigate to: Cost Management + Billing > Budgets
2. Click “+ Add”
   Choose:
   • Scope: Select the subscription and optionally filter by the newly created resource group (e.g., revelation-ai-resources)
   • Name: e.g., revelation-ai-budget
   • Amount: Set a monthly limit (e.g., R5,000 or £250 depending on region)
   • Time period: Monthly is recommended
3. Set Alerts
   Configure thresholds (e.g., 50%, 75%, 90%)
   Choose email recipients or webhook endpoints for automated alerts
4. Review + Create
   Confirm settings and click Create

Notes & Best Practices

• Budgets don’t enforce hard limits — they alert, not block. For stricter control, pair with Azure Spending Limits or custom policy enforcement.