Azure OpenAI

Le fournisseur Azure OpenAI, azure utilise les variables d’environnement AZURE_OPENAI_.... Vous pouvez utiliser une identité managée (recommandée) ou une clé API pour vous authentifier auprès du service Azure OpenAI. Vous pouvez également utiliser un principal de service comme documenté dans automation.

script({ model: "azure:deployment-id" });

Astuce

Si vous êtes abonné à Visual Studio, vous pouvez obtenir des crédits Azure gratuits pour essayer le service Azure OpenAI.

Identité managée (Entra ID)

1. Ouvrez votre ressource Azure OpenAI dans le Portail Azure

2. Naviguez vers Contrôle d’accès (IAM), puis Afficher mon accès. Assurez-vous que votre utilisateur ou principal de service dispose du rôle Cognitive Services OpenAI User/Contributor. Si vous obtenez une erreur 401, cliquez sur Ajouter, Ajouter une attribution de rôle et ajoutez le rôle Cognitive Services OpenAI User à votre utilisateur.

3. Naviguez vers Gestion des ressources, puis Clés et point de terminaison.

4. Mettez à jour le fichier .env avec le point de terminaison.

   .env

   AZURE_OPENAI_API_ENDPOINT=https://....openai.azure.com

   Note

   Assurez-vous de supprimer toutes les entrées AZURE_API_KEY, AZURE_OPENAI_API_KEY du fichier .env.

5. Naviguez vers déploiements et assurez-vous que votre LLM est déployé, puis copiez le deployment-id, vous en aurez besoin dans le script.

6. Ouvrez un terminal et connectez-vous avec Azure CLI.

   az login

7. Mettez à jour le champ model dans la fonction script pour correspondre au nom du modèle déployé dans votre ressource Azure.

   script({
       model: "azure:deployment-id",
       ...
   })

Définissez la variable d’environnement NODE_ENV sur development pour permettre à DefaultAzureCredential de fonctionner avec Azure CLI. Sinon, elle utilisera une chaîne de jetons d’informations d’identification incluant env, workload, managed identity, azure cli, azure dev cli, azure powershell, devicecode.

Liste des modèles

Il existe deux façons de lister les modèles dans votre ressource Azure OpenAI : utiliser les API de gestion Azure ou en appelant un point de terminaison personnalisé /models.

Utilisation des API de gestion (méthode courante)

Pour permettre à GenAIScript de lister les déploiements dans votre service Azure OpenAI, vous devez fournir l’ID d’abonnement et vous devez utiliser Microsoft Entra !.

1. Ouvrez la ressource Azure OpenAI dans le Portail Azure, ouvrez l’onglet Vue d’ensemble et copiez l’ID d’abonnement.

2. Mettez à jour le fichier .env avec l’ID d’abonnement.

   .env

   AZURE_OPENAI_SUBSCRIPTION_ID="..."

3. Testez votre configuration en exécutant

   npx genaiscript models azure

   Note

   Cette fonctionnalité ne fonctionnera probablement pas avec AZURE_OPENAI_API_KEY car le jeton n’a pas la portée adéquate pour interroger la liste des déploiements.

Utilisation du point de terminaison /models

Cette approche suppose que vous avez configuré un point de terminaison /models compatible OpenAI dans votre abonnement qui renvoie la liste des déploiements dans un format compatible avec l’API OpenAI.

Vous pouvez définir la variable d’environnement AZURE_OPENAI_API_MODELS_TYPE pour pointer vers openai.

.env

AZURE_OPENAI_API_MODELS_TYPE="openai"

Informations d’identification personnalisées

Dans certaines situations, la chaîne par défaut de recherche des informations d’identification peut ne pas fonctionner. Dans ce cas, vous pouvez spécifier une variable d’environnement supplémentaire AZURE_OPENAI_API_CREDENTIALS avec le type d’informations d’identification qui doit être utilisé.

.env

AZURE_OPENAI_API_CREDENTIALS=cli

Les types sont directement mappés aux types d’informations d’identification de @azure/identity :

• cli - AzureCliCredential
• env - EnvironmentCredential
• powershell - AzurePowerShellCredential
• devcli - AzureDeveloperCliCredential
• workloadidentity - WorkloadIdentityCredential
• managedidentity - ManagedIdentityCredential

Réglez NODE_ENV sur development pour utiliser DefaultAzureCredential avec GenAIScript.

Portées personnalisées de jeton

La portée de jeton par défaut pour l’accès Azure OpenAI est https://cognitiveservices.azure.com/.default. Vous pouvez remplacer cette valeur en utilisant la variable d’environnement AZURE_OPENAI_TOKEN_SCOPES.

.env

AZURE_OPENAI_TOKEN_SCOPES=...

Version de l’API

GenAIScript maintient une version API par défaut pour accéder à Azure OpenAI.

• version actuelle : 2025-04-01-preview

Vous pouvez remplacer cette valeur en utilisant la variable d’environnement AZURE_OPENAI_API_VERSION.

.env

AZURE_OPENAI_API_VERSION=2025-01-01-preview

Vous pouvez également remplacer la version API sur une base par déploiement en définissant la variable d’environnement AZURE_OPENAI_API_VERSION_<deployment-id> (où deployment-id est en majuscules).

.env

AZURE_OPENAI_API_VERSION_GPT-4O=2025-01-01-preview

Clé API

1. Ouvrez votre ressource Azure OpenAI et naviguez vers Gestion des ressources, puis Clés et point de terminaison.

2. Mettez à jour le fichier .env avec la clé secrète (Clé 1 ou Clé 2) et le point de terminaison.

   .env

   AZURE_OPENAI_API_KEY=...
   AZURE_OPENAI_API_ENDPOINT=https://....openai.azure.com

3. Le reste des étapes est identique : trouvez le nom du déploiement et utilisez-le dans votre script, model: "azure:deployment-id".

Aliases

The following model aliases are attempted by default in GenAIScript.

Alias	Model identifier

Limitations

• Ignore prediction of output tokens