Partager via

Conditions préalables au déploiement de la compétence d’analyse de documents financiers pour les agents (version préliminaire)

  • Article

Important

Cette fonctionnalité est en version préliminaire. Ces informations concernent une fonctionnalité en préversion qui peut être considérablement modifiée avant son lancement. Microsoft n’offre aucune garantie, expresse ou implicite, concernant les informations fournies ici.

Avant de déployer l’analyse des documents financiers compétence pour les agents, assurez-vous que votre environnement répond à tous les prérequis nécessaires :

  • Vous devez avoir le rôle Propriétaire sur l’abonnement Azure.

  • Activez l’identité gérée attribuée par le système pour la ressource Azure OpenAI . Pour en savoir plus, consultez Activer l’identité gérée.

  • Affectez le rôle Cognitive Services OpenAI collaborateur à la ressource Azure OpenAI , comme expliqué dans Attribuer un rôle à la OpenAI ressource.

  • Configurez le compte de stockage comme suit :

  • Configurez le conteneur blob à partir duquel les documents sont ingérés.

  • Enregistrez l’application, comme expliqué dans Créer l’enregistrement de l’application.

  • Assurez-vous que vous disposez de suffisamment de ressources Premium v3 P1mv3 dans votre abonnement avant le déploiement. Si vous avez besoin de ressources supplémentaires, ouvrez un ticket d’assistance depuis la section Aide + support , Sélectionner Quota, et demandez une augmentation. Contactez le support pour obtenir de l’aide. Pour plus d’informations sur les limites les plus courantes, consultez Microsoft Azure Limites, quotas et contraintes d’abonnement et de service Azure .

Tâches prérequises

Vous devez effectuer quelques opérations avant de déployer l’analyse des documents financiers compétence pour les agents.

Attribuer un rôle à la OpenAI ressource

  1. connectez-vous au portail Azure avec le rôle Propriétaire.

  2. Dans le menu de navigation, Sélectionner Contrôle d’accès (IAM).

Capture d’écran de la page Contrôle d’accès (IAM).

  1. Sélectionnez Ajouter > Ajouter une attribution de rôle.

  2. Sélectionner Services cognitifs OpenAI collaborateur and Sélectionner Suivant.

Capture d’écran de la page permettant d’ajouter des attributions de rôles.

  1. Dans l’onglet Membres , Sélectionner Identité gérée, suivi de + Sélectionner membres.

  2. Sélectionner votre OpenAI ressource puis Sélectionner Suivant, comme indiqué dans l’image suivante :

Capture d’écran de la page pour ajouter des membres pour un rôle.

  1. Sélectionner Révisez + attribuez, comme indiqué dans l’image suivante :

Capture d’écran de la page pour réviser et attribuer le rôle.

  1. Vérifiez que le rôle particulier est attribué.

    a. Retourner à la page de présentation de la ressource. OpenAI

    b. Dans le menu de navigation, Sélectionner Gestion des ressources > Identité.

    c. Sélectionner Azure attributions de rôles pour voir tous les rôles attribués.

    Capture d’écran de la page Identité avec l’option d’attribution de rôle Azure.

    d. Sur la page d’attribution des rôles Azure, vérifiez si le rôle Cognitive Services OpenAI collaborateur est attribué à la OpenAI ressource.

    Capture d’écran de la page permettant de vérifier l’attribution du rôle à la OpenAI ressource.

Créer l’inscription d’application

Important

Vous devez disposer du rôle Application Administrateur pour créer l’enregistrement de l’application. Pour en savoir plus, consultez la section Attribuer Microsoft Entra des rôles aux utilisateurs.

  1. Connectez-vous au portail Azure.

  2. Sélectionner Microsoft Entra ID, comme indiqué.

Capture d’écran de l’option d’identification Sélectionner Microsoft Entra

  1. Dans le menu de navigation, Sélectionner Gérer > les inscriptions d’applications, suivi de + Nouvelle inscription.

Capture d’écran de la page pour créer une nouvelle inscription d’application

  1. Saisissez un nom unique pour l’application, puis Sélectionner Inscrivez-vous.

Capture d’écran de la page pour enregistrer une application

  1. Accédez à la page d’inscription des applications pour l’application que vous avez enregistrée et Sélectionner Exposez une API.

Capture d’écran de la page pour exposer une API

  1. Sélectionner + Ajoutez un Scope et ajoutez DocQnA.Users. Cette valeur est sensible à la casse.

  2. Sélectionner Ajoutez une application cliente, entrez 04b07795-8ddb-461a-bbee-02f9e1bf7b46 comme ID client et Sélectionner la case à cocher sous Étendues autorisées. L’ID client est l’ID d’application de la CLI Azure.

    Note

    Vous devez également ajouter l’ID client de votre application back-end si vous souhaitez que l’application reçoive le jeton au nom d’un utilisateur.

  3. Sélectionner Rôles d’application et ajoutez le rôle Utilisateurs . Ce rôle est essentiel pour accéder à l’API Document Insights.

Capture d’écran de la page pour ajouter les rôles des utilisateurs

  1. Dans le menu de navigation, Sélectionner Gérer > Manifeste et modifiez la requestedAccessTokenVersion valeur dans le fichier manifeste à 2.

Capture d’écran du fichier manifeste

  1. Revenez à la page Présentation et à Sélectionner Application gérée dans le répertoire local pour fournir aux utilisateurs et aux groupes des autorisations pour utiliser l’enregistrement de l’application.

Capture d’écran de la page d’aperçu avec l’option Application gérée mise en surbrillance

  1. Ajoutez les utilisateurs et les groupes qui ont besoin d’autorisations pour accéder à l’API.

Capture d’écran de la page pour ajouter des utilisateurs et des groupes

  1. Pour les autorisations d’application, vous devez fournir les autorisations API et ajouter l’application avec l’autorisation appropriée.

Capture d’écran de la page pour ajouter des autorisations API

Étape suivante

Déployer l’analyse des documents financiers compétence pour les agents