Configurer des ressources d’agent standard

La configuration de l’agent standard utilise des ressources Azure client gérées par le client pour stocker l’état de l’agent et conserver toutes les données de l’agent sous votre contrôle. Utilisez la configuration standard lorsque vous avez besoin d’une souveraineté complète des données, de la conformité avec les stratégies de sécurité d’entreprise ou de l’isolation au niveau du projet.

Dans cette configuration :

• Les états de l’agent (conversations, réponses) sont stockés dans vos propres ressources Azure.
• Vous conservez un contrôle total sur la résidence et l’accès aux données.

Conditions préalables

• Un abonnement Azure. Créez-en un gratuitement.
• Un Azure Cosmos DB pour NoSQL compte. Pour connaître les exigences en matière de débit, consultez les exigences de débit Cosmos DB.
• Un compte stockage Azure.
• Ressource Recherche Azure AI.
• Ressource Azure Key Vault pour la gestion des secrets.
• Azure CLI version 2.50 ou ultérieure. Exécutez az --version pour vérifier.
• Autorisations suffisantes pour attribuer des rôles. Vous avez besoin du rôle Propriétaire ou Administrateur de l’accès utilisateur sur le groupe de ressources.
• Modèle déployé compatible avec un agent (par exemple, gpt-4o).

Vue d’ensemble des ressources

Toutes les données traitées par le service Foundry Agent sont automatiquement stockées au repos dans ces ressources, ce qui vous aide à répondre aux exigences de conformité et aux normes de sécurité d’entreprise.

Exigences en matière de débit Cosmos DB

Votre Azure Cosmos DB pour NoSQL compte doit avoir une limite de débit totale d’au moins 3000 RU/s. Les modes débit approvisionné et serverless sont tous deux pris en charge.

La configuration standard provisionne trois conteneurs dans votre compte Cosmos DB, chacune nécessitant 1 000 RU/s :

Pour plusieurs projets sous le même compte Foundry, multipliez par le nombre de projets. Par exemple, deux projets nécessitent au moins 6 000 RU/s (3 conteneurs × 1 000 RU/s × 2 projets).

Isolation des données au niveau du projet

La configuration standard applique l’isolation des données au niveau du projet par défaut. Deux conteneurs de stockage blob sont automatiquement attribués dans votre compte de stockage : un pour les fichiers et un pour les données système intermédiaires (blocs, embeddings). Trois conteneurs sont provisionnés dans votre compte Cosmos DB : un pour les threads utilisateur, un pour les messages système et un pour les données de configuration de l’agent, comme les instructions, les outils et les noms. Ce comportement par défaut réduit la complexité de la configuration tout en appliquant des limites de données strictes entre les projets.

Hôtes de capacité

Les hôtes de capacité sont des sous-ressources du compte et du projet qui permettent l’interaction avec le Service d'Agent.

• Hôte de fonctionnalité de compte : possède un corps de requête vide, à l’exception du paramètre capabilityHostKind="Agents".
• hôte de capacité Project : spécifie les ressources pour le stockage de l’état de l’agent, soit les ressources multilocataires gérées par Microsoft (configuration de base) ou les ressources monolocataires appartenant au client (configuration standard). L’hôte de capacité du projet fonctionne comme paramètres du projet.

Limitations

• Vous ne pouvez pas mettre à jour l’hôte de fonctionnalité une fois qu’il a été défini pour un projet ou un compte.

Provisionner des ressources étape par étape

Approvisionnement manuel

Suivez ces étapes pour provisionner manuellement toutes les ressources nécessaires à la configuration de l’agent standard. Laissez environ 30 à 45 minutes pour le processus d’approvisionnement complet.

Phase 1 : Créer des ressources dépendantes

1. Créez ou réutilisez les ressources suivantes. Vous pouvez créer de nouvelles ressources ou transmettre l’ID de ressource des ressources existantes :
   • Azure Cosmos DB pour NoSQL compte
   • compte stockage Azure
   • ressource Recherche Azure AI
   • Azure Key Vault ressource (utilisée pour la gestion des secrets et des chaînes de connexion pour l’infrastructure de l’agent)
   • [Facultatif] ressource Azure Application Insights
   • [Facultatif] Ressource Foundry existante

Phase 2 : Créer des ressources et des connexions de fonderie

2. Créez une ressource Microsoft Foundry.
3. Créer des connexions au niveau du compte :
   • Créez une connexion de compte à la ressource Application Insights.
4. Déployez gpt-4o ou un autre modèle compatible agent.
5. Créez un projet.
6. Créer des connexions de projet :
   • [Si fourni] Connexion du projet à la ressource Foundry.
   • Connexion projetée au compte de stockage Azure.
   • Project connexion à la ressource Recherche Azure AI.
   • Projet de connection au compte de Cosmos DB.

Phase 3 : Attribuer des rôles à l’identité managée du projet

L’identité managée du projet inclut à la fois l’identité managée affectée par le système (SMI) et l’identité managée affectée par l’utilisateur (UMI).

7. Attribuez l’identité managée du projet (pour SMI) aux rôles suivants :
   • Opérateur Cosmos DB au niveau du compte pour la ressource Cosmos DB.
   • Contributeur de compte de stockage au niveau du compte de stockage pour la ressource compte de stockage.

Phase 4 : Configurer des hôtes de capacité

8. Définissez l’hôte de fonctionnalité de compte avec une section de propriétés vide.
9. Définissez l’hôte de capacité de projet avec les connexions Cosmos DB, stockage Azure et AI Search.

Phase 5 : Attribuer des autorisations de ressources granulaires

10. Attribuez à l’identité managée du projet (SMI et UMI) les rôles suivants sur les étendues de ressources spécifiées :
    • Recherche Azure AI (attribuer avant ou après la création de l'hôte de fonctionnalités) :
      • Contributeur aux données d’index de recherche
      • Contributeur de service de recherche
    • conteneur Stockage Blob Azure : <workspaceId>-azureml-blobstore
      • Contributeur de données Blob de stockage
    • conteneur Stockage Blob Azure : <workspaceId>-agents-blobstore
      • Propriétaire des blobs de stockage
    • Cosmos DB pour NoSQL base de données : enterprise_memory
      • Contributeur de données intégré Cosmos DB
      • Étendue : Niveau de la base de données pour couvrir tous les conteneurs (aucune attribution de rôle spécifique à un conteneur n’est nécessaire).

Phase 6 : Accorder l’accès aux développeurs

11. Attribuez à tous les développeurs qui doivent créer ou modifier des agents dans le projet le rôle Azure utilisateur IA sur l’étendue du projet.

Utiliser un modèle Bicep

Utilisez un compte OpenAI existant, un compte stockage Azure, un compte Azure Cosmos DB pour NoSQL, ou une ressource Recherche Azure AI en fournissant l'ID de ressource complet d'Azure Resource Manager (ARM) dans le fichier de modèle d'agent standard.

Utiliser une ressource OpenAI Azure existante

1. Suivez les étapes de configuration de l’environnement pour obtenir l’ID de ressource du compte Foundry Tools.

2. Dans le fichier de modèle d’agent standard, remplacez l’espace réservé suivant :

   existingAoaiResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{serviceName}
   

Utiliser un compte stockage Azure existant pour le stockage de fichiers

1. Connectez-vous au Azure CLI et sélectionnez l’abonnement avec votre compte de stockage :

   az login
   

2. Exécutez la commande suivante pour obtenir l’ID de ressource de votre compte de stockage :

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

   La sortie est la aiStorageAccountResourceID valeur dont vous avez besoin dans le modèle.

3. Dans le fichier de modèle d’agent standard, remplacez l’espace réservé suivant :

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

Utiliser un compte Azure Cosmos DB pour NoSQL existant pour le stockage de threads

Un Azure Cosmos DB pour NoSQL compte est créé pour chaque compte Foundry. Pour connaître les exigences en matière de débit et la mise à l’échelle de plusieurs projets, consultez les exigences en matière de débit Cosmos DB.

1. Connectez-vous au Azure CLI et sélectionnez l’abonnement avec votre compte Cosmos DB :

   az login
   

2. Exécutez la commande suivante pour obtenir votre ID de ressource de compte Azure Cosmos DB :

   az cosmosdb show --resource-group <your-resource-group> --name <your-cosmosdb-account> --query "id" --output tsv
   

   La sortie est la cosmosDBResourceId valeur dont vous avez besoin dans le modèle.

3. Dans le fichier de modèle d’agent standard, remplacez l’espace réservé suivant :

   cosmosDBResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{cosmosDbAccountName}
   

Utiliser une ressource Recherche Azure AI existante

1. Connectez-vous au Azure CLI et sélectionnez l’abonnement avec votre ressource de recherche :

   az login
   

2. Exécutez la commande suivante pour obtenir votre ID de ressource Recherche Azure AI :

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

3. Dans le fichier de modèle d’agent standard, remplacez l’espace réservé suivant :

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

Vérifier votre configuration

Une fois l’approvisionnement terminé, vérifiez que l’installation fonctionne correctement :

1. Dans le portail Azure, accédez à votre projet Foundry et vérifiez que toutes les connexions (Stockage, Cosmos DB, Recherche IA) apparaissent sous les paramètres du projet.
2. Vérifiez que l’état de l’hôte de capacité s’affiche comme Réussi pour le compte et le projet.
3. Vérifiez les attributions de rôles en accédant à la page contrôle d’accès (IAM) de chaque ressource et en confirmant que l’identité managée du projet a les rôles attendus.
4. Créez un agent de test pour confirmer la fonctionnalité de bout en bout.

Résoudre les problèmes courants

Contenu connexe

• Configurer votre environnement pour Foundry Agent Service
• Hôtes de capacité
• Modèle Bicep de configuration de l'agent standard