Skip to content

Azure AI Foundry Setup

Overview

This guide covers how to configure Azure AI Foundry deployments with Raikoo. There are two methods depending on which Azure service type you're using:

  1. Azure AI Services - Use the OpenAI-Compatible provider in Raikoo.
  2. Azure OpenAI - Use the Azure OpenAI provider in Raikoo.

Prerequisites

  • An active Azure subscription
  • Access to Azure AI Foundry
  • A deployed model in Azure AI Foundry
  • Admin or appropriate permissions in Raikoo to configure AI providers

Option 1: Azure AI Services (OpenAI-Compatible)

Use this method when working with Azure AI Services deployments.

Step 1: Get Your Credentials from Azure

  1. Navigate to https://ai.azure.com/
  2. Select your project and deployment
  3. In the Basic code sample section, locate and copy the endpoint URL
  4. In the Endpoint section, copy the API key

Step 2: Configure Raikoo

  1. Navigate to your Raikoo AI provider settings
  2. Add a new provider with the following configuration:
Field Value
Provider Type OpenAI-Compatible
Base URL Your endpoint URL from Step 1
API Key Your API key from Step 1
  1. Save the configuration

Option 2: Azure OpenAI

Use this method when working with Azure OpenAI Service deployments.

Step 1: Get Your Credentials from Azure

  1. Navigate to https://ai.azure.com/
  2. Select your project and deployment
  3. In the Endpoint section, locate and copy the endpoint URL
  4. Modify the URL to include the deployments path:
    • Original: https://your-resource.openai.azure.com/
    • Modified: https://your-resource.openai.azure.com/openai/deployments
  5. In the Endpoint section, copy the API key

Step 2: Configure Raikoo

  1. Navigate to your Raikoo AI provider settings
  2. Add a new provider with the following configuration:
Field Value
Provider Type Azure OpenAI
Base URL Your modified endpoint URL from Step 1
API Key Your API key from Step 1
Default Model IDs Your deployment IDs (e.g., gpt-4o, gpt-4o-mini)
  1. Save the configuration

Troubleshooting

Authentication Errors

Cause: Invalid or expired API key.

Solution:

  • Verify the API key is copied correctly without extra spaces
  • Generate a new key in Azure AI Foundry if needed
  • Ensure the key has not been rotated or revoked

Model Not Found Errors

Cause: Incorrect deployment ID or Base URL.

Solution:

  • For Azure OpenAI, verify the Base URL includes /openai/deployments
  • Confirm the deployment ID matches exactly what's shown in Azure
  • Check that the deployment is active and not in a failed state

Connection Timeouts

Cause: Network or endpoint issues.

Solution:

  • Verify the endpoint URL is correct
  • Check if your network allows outbound connections to Azure
  • Confirm the Azure service is not experiencing an outage

Getting Help

If you encounter issues not covered here:

  1. Check the Azure AI Foundry documentation
  2. Contact your Azure administrator
  3. Reach out to Raikoo support with:
    • Your provider configuration (excluding API keys)
    • Any error messages received
    • Screenshots if applicable