Condividi tramite


Prerequisiti per lo sviluppo di competenza di analisi dei documenti finanziari per gli agenti (anteprima)

Importante

Questa è una funzionalità di anteprima. Queste informazioni si riferiscono a una funzionalità non definitiva che potrebbe essere sostanzialmente modificata prima del rilascio. Microsoft non offre alcuna garanzia, esplicita o implicita, relativamente alle informazioni fornite.

Prima di distribuire l'analisi dei documenti finanziari competenza per gli agenti, assicurati che ambiente soddisfi tutti i prerequisiti necessari:

  • È necessario disporre del ruolo di Proprietario per l'abbonamento Azure.

  • Abilitare l'identità gestita assegnata dal sistema per la risorsa Azure OpenAI . Per ulteriori informazioni, consulta la pagina Abilita l'identità gestita.

  • Assegnare il ruolo Cognitive Services OpenAI contributore alla risorsa Azure OpenAI , come spiegato in Assegnare un ruolo alla OpenAI risorsa.

  • Configurare l'account di archiviazione come segue:

  • Configurare il contenitore BLOB da cui vengono acquisiti i documenti.

  • Registrare l'app, come spiegato in Creare la registrazione dell'app.

  • Prima della distribuzione, assicurati di disporre di sufficienti risorse Premium v3 P1mv3 nel tuo abbonamento. Se hai bisogno di risorse aggiuntive, apri un ticket di supporto dalla sezione Aiuto + supporto , Seleziona Quota e richiedi un aumento. Contattare l'assistenza per ricevere assistenza. Per maggiori informazioni sui limiti più comuni, vedere Azure limiti, quote e vincoli per abbonamenti e servizi. Microsoft Azure

Attività preliminari

Prima di distribuire l'analisi dei documenti finanziari per gli agenti, è necessario eseguire alcune operazioni competenza.

Assegna un ruolo alla risorsa OpenAI

  1. Accedi al portale Azure con il ruolo di Proprietario.

  2. Nel menu di navigazione, Seleziona Controllo accessi (IAM).

Screenshot della pagina Controllo Accessi (IAM).

  1. Seleziona Aggiungi > Aggiungi assegnazione di ruolo.

  2. Seleziona Servizi cognitivi OpenAI contributore and Seleziona Avanti.

Screenshot della pagina per aggiungere assegnazioni di ruolo.

  1. Nella scheda Membri , Seleziona Identità gestita, seguita da + Seleziona membri.

  2. Seleziona la tua OpenAI risorsa e poi Seleziona Avanti, come mostrato nell'immagine seguente:

Screenshot della pagina per aggiungere membri per un ruolo.

  1. Seleziona Revisione + assegnazione, come mostrato nell'immagine seguente:

Screenshot della pagina per rivedere e assegnare il ruolo.

  1. Verificare che il ruolo specifico sia stato assegnato.

    a. Ritorna alla pagina Panoramica delle risorse. OpenAI

    b. Nel menu di navigazione, Seleziona Gestione risorse > Identità.

    c. Seleziona Azure assegnazioni di ruolo per vedere tutti i ruoli assegnati.

    Screenshot della pagina Identità con l'opzione di assegnazione del ruolo Azure.

    d. Nella pagina delle assegnazioni dei ruoli Azure, verificare se il ruolo Servizi cognitivi OpenAI contributore è assegnato alla OpenAI risorsa.

    Screenshot della pagina per verificare l'assegnazione del ruolo alla OpenAI risorsa.

Creare la registrazione dell'app

Importante

Per creare la registrazione dell'app è necessario disporre del ruolo Applicazione amministratore. Per ulteriori informazioni, consulta la sezione Assegnazione Microsoft Entra dei ruoli agli utenti.

  1. Accedi al portale di Azure.

  2. Seleziona Microsoft Entra ID, come mostrato.

Screenshot dell'opzione per Seleziona Microsoft Entra ID

  1. Nel menu di navigazione, Seleziona Gestisci > Registrazioni app, seguito da + Nuova registrazione.

Screenshot della pagina per creare una nuova registrazione dell'app

  1. Inserisci un nome univoco per l'app, quindi Seleziona Registrati.

Screenshot della pagina per registrare un'app

  1. Vai alla pagina Registrazione app per l'app che hai registrato e Seleziona Esponi un'API.

Screenshot della pagina per esporre un'API

  1. Seleziona + Aggiungi un ambito e aggiungi DocQnA.Users. Questo valore distingue tra maiuscole e minuscole.

  2. Seleziona Aggiungi un'applicazione client, inserisci 04b07795-8ddb-461a-bbee-02f9e1bf7b46 come ID client e Seleziona la casella di controllo sotto Ambiti autorizzati. Il Client ID è l'Application ID della CLI Azure.

    Nota

    Se vuoi che l'app riceva il token per conto di un utente, devi anche aggiungere l'ID client della tua app back-end.

  3. Seleziona Ruoli app e aggiungi il ruolo Utenti . Questo ruolo è fondamentale per accedere all'API Document Insights.

Screenshot della pagina per aggiungere i ruoli degli utenti

  1. Nel menu di navigazione, Seleziona Gestisci > Manifesto e modifica il valore requestedAccessTokenVersion nel file manifesto in 2.

Screenshot del file manifesto

  1. Torna alla pagina Panoramica e Seleziona Applicazione gestita nella directory locale per fornire agli utenti e ai gruppi le autorizzazioni per utilizzare la registrazione dell'app.

Screenshot della pagina di panoramica con l'opzione Applicazione gestita evidenziata

  1. Aggiungere gli utenti e i gruppi che necessitano delle autorizzazioni per accedere all'API.

Screenshot della pagina per aggiungere utenti e gruppi

  1. Per le autorizzazioni dell'applicazione, è necessario fornire le autorizzazioni API e aggiungere l'applicazione con l'autorizzazione pertinente.

Screenshot della pagina per aggiungere i permessi API

Passaggio successivo

Distribuisci l'analisi dei documenti finanziari competenza per gli agenti