| Table of Contents | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
Prerequisites
The prerequisites comes come in two groups:
System prerequisites - Obtaining the required subscription rights to do the installation
Admin user prerequisites - Obtaining the required user permissions to run the install process
...
Obtain an Azure Subscription
One must have an active Azure subscription. If one don't have one, one can sign up for an Azure subscription on the Azure website.
At times, Microsoft may impose subscription type specific limitations on their OpenAI services, particularly concerning the amount of data (referred to as the token quota) that can be exchanged during chat interactions. Please see this Microsoft documentation on token quotas for details on which subscription types that may have such restrictions. Changing to another subscription type would normally solve this.
If one has a contract directly with Ayfie (aka. private plan) please send the Subscription Id to your Ayfie contact
Get Azure OpenAI Approval
The Azure subscription needs to be approved for Azure Open AI. How to do that is described in Ayfie Personal Assistant - How to Request Access to the Azure OpenAI Service.
Enable two Providers
In the Azure subscription settings, ensure that one enables the two providers below. How to do that is described in Ayfie Personal Assistant - How to Add Providers to an Azure Subscription.
Microsoft.App: Required for deploying applications within Azure.
Microsoft.ContainerService: Required for managing container-based services within Azure.
...
Select the subscription from the dropdown, and create a new resource group or select an existing one (circled in purple above)
Select one of these alternative locations regions from the dropdown menu (circled in orange). Technically it does not matter, but This selection determines what LLM that will be used and what laws that will be applied. EU customers should for legal reasons select one of the two EU regions listed at the top :and if one want to use GPT-4o (what at the time of this writing is considered the most accurate model) Sweden,
France Central (GPT-4 1106-Preview)
Sweden Central (GPT-4o)
UK South (GPT-4 1106-Preview)
Canada East (GPT-4 1106-Preview)
East US (GPT-4o)
Check the checkbox to verify you have been granted access to Azure OpenAI with selected subscription (circled in yellow above)
Click the white Next or the blue Review + create button. This will take one to the Review + create page.
...
One can use a Service Principal that already exists or create a new one
Depending on which of the two options one chose, clicking the Make selection link will either bring up a search pane with existing Service Principals to choose from, or a form to register a new Service Principal. The screenshot above shows the case of creating a new one.
Give the Service Principal (the Entra ID application) a name, for instance AyfiePersonalAssistantApp as done in the example above.
Select the single tenant option (this would cover the case of all users being employees of the customer)
Click the Register button. This will take one away from the page. To get back, use the path at the top of the page as indicated by the green arrow.
Verify that one has created or selected a Service Principal by checking of the check box
Click Next (circled in red) to get to the Authentication page
...