Utiliser vos propres ressources

Lisez cet article si vous souhaitez utiliser Azure Agent Service avec les ressources que vous avez déjà.

Remarque

• Si vous utilisez une ressource AI Services ou Azure OpenAI existante, aucun modèle ne sera déployé. Vous pouvez déployer un modèle sur la ressource une fois l’installation de l’agent terminée.
• Vérifiez que votre ressource Azure OpenAI et votre projet Azure AI Foundry se trouvent dans la même région.

Choisir une configuration d’agent de base ou standard

Pour utiliser vos propres ressources, vous pouvez modifier les paramètres dans les modèles de déploiement fournis. Pour commencer, déterminez si vous souhaitez modifier le modèle de configuration d’agent de base ou le modèle de configuration d’agent standard.

Configuration de base : Les agents utilisent des ressources de recherche et de stockage multilocataires complètement managées par Microsoft. Vous n’avez pas de visibilité ou de contrôle sur ces ressources Azure sous-jacentes. Vous pouvez uniquement utiliser votre propre compte AI Services avec cette option.

Configuration standard : Les agents utilisent des ressources de recherche et de stockage monolocataires appartenant au client. Avec cette configuration, vous disposez d’un contrôle total et d’une visibilité totale sur ces ressources, mais votre utilisation peut engendrer des coûts. Vous pouvez utiliser votre propre compte AI Services, compte de stockage et/ou ressource Recherche Azure AI avec cette option.

Configuration de base de l’agent : utiliser une ressource AI Services/Azure OpenAI existante

Remplacez la valeur du paramètre pour aiServiceAccountResourceId par l’ID de ressource ARM complet de la ressource AI Services ou Azure OpenAI que vous voulez utiliser.

1. Pour obtenir l’ID de ressource du compte AI Services, connectez-vous à Azure CLI et sélectionnez l’abonnement avec votre compte AI Services :

   az login

2. Remplacez <your-resource-group> par le groupe de ressources contenant votre ressource et your-ai-service-resource-name par le nom de votre ressource AI Services, puis exécutez :

   az cognitiveservices account show --resource-group <your-resource-group> --name <your-ai-service-resource-name> --query "id" --output tsv

   La valeur retournée est aiServiceAccountResourceId, que vous devez utiliser dans le modèle.

3. Dans le modèle de fichier d’agent de base, remplacez les espaces réservés suivants :

   aiServiceAccountResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{serviceName}
   
   [Azure OpenAI Only] aiServiceKind: AzureOpenAI
   

   Si vous voulez utiliser une ressource Azure OpenAI existante, vous devez mettre à jour les paramètres aiServiceAccountResourceId et aiServiceKind dans le fichier des paramètres. Le paramètre aiServiceKind doit être défini sur AzureOpenAI.

Configuration standard de l’agent : utiliser une ressource AI Services/Azure OpenAI, de stockage et/ou Recherche Azure AI existante

Utilisez une ressource Recherche IA, de compte de stockage et/ou Recherche Azure AI existante en fournissant l’ID de ressource arm complet dans le modèle de fichier d’agent standard.

Utilisez une ressource AI Services ou Azure OpenAI existante :

1. Suivez les étapes de la configuration d’agent de base pour obtenir l’ID de ressource du compte AI Services.

2. Dans le modèle de fichier d’agent standard, remplacez les espaces réservés suivants :

   aiServiceAccountResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{serviceName}
   
   [Azure OpenAI Only] aiServiceKind: AzureOpenAI
   

Utiliser un compte de stockage existant

1. Pour obtenir votre ID de ressource de compte de stockage, connectez-vous à Azure CLI et sélectionnez l’abonnement avec votre compte de stockage :

   az login

2. Ensuite, exécutez la commande  :

   az search service show --resource-group <your-resource-group> --name <your-storage-account> --query "id" --output tsv

   La sortie est l’aiStorageAccountResourceID que vous devez utiliser dans le modèle.

3. Dans le modèle de fichier d’agent standard, remplacez les espaces réservés suivants :

   aiStorageAccountResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{storageAccountName}
   

Utiliser une ressource Recherche Azure AI existante

1. Pour obtenir votre ID de ressource Recherche Azure AI, connectez-vous à Azure CLI et sélectionnez l’abonnement avec votre ressource de recherche :

   az login

2. Ensuite, exécutez la commande  :

   az search service show --resource-group <your-resource-group> --name <your-search-service> --query "id" --output tsv

3. Dans le modèle de fichier d’agent standard, remplacez les espaces réservés suivants :

   aiSearchServiceResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}
   

Voir aussi

• Découvrez les différents outils que les agents peuvent utiliser.