Configurare le risorse dell'agente standard (versione classica)

Visualizzazione attuale:Versione del portale Foundry (versione classica) - Passa alla versione per il nuovo portale Foundry

La configurazione dell'agente standard usa risorse di Azure a tenant singolo gestite dal cliente per archiviare lo stato dell'agente e mantenere tutti i dati dell'agente sotto il controllo. Usare la configurazione standard quando è necessaria la sovranità dei dati completa, la conformità ai criteri di sicurezza aziendali o l'isolamento a livello di progetto.

In questa configurazione:

• Gli stati dell'agente (conversazioni, risposte) vengono archiviati nelle proprie risorse Azure.
• Si mantiene il controllo completo sulla residenza e l'accesso dei dati.

Prerequisiti

• Sottoscrizione Azure. Crearne uno gratuitamente.
• Un account Azure Cosmos DB per NoSQL. Per i requisiti di velocità effettiva, vedere Requisiti di velocità effettiva di Cosmos DB.
• Un account Archiviazione di Azure.
• Una risorsa Azure AI Search.
• Risorsa Azure Key Vault per la gestione dei segreti.
• interfaccia della riga di comando di Azure versione 2.50 o successiva. Eseguire az --version per verificare.
• Autorizzazioni sufficienti per assegnare ruoli. È necessario il ruolo Proprietario o Amministratore accesso utenti nel gruppo di risorse.
• Modello compatibile con l'agente distribuito, ad esempio gpt-4o.

Panoramica delle risorse

Tutti i dati elaborati dal servizio Foundry Agent vengono archiviati automaticamente inattivi in queste risorse, consentendo di soddisfare i requisiti di conformità e gli standard di sicurezza aziendali.

Requisiti di velocità effettiva di Cosmos DB

Il Azure Cosmos DB per NoSQL account deve avere un limite di velocità effettiva totale di almeno 3000 UR/s. Sono supportate entrambe le modalità Throughput con provisioning e Serverless.

La configurazione standard effettua il provisioning di tre contenitori nell'account Cosmos DB, ognuno dei quali richiede 1000 UR/sec:

Per più progetti con lo stesso account Foundry, moltiplicare per il numero di progetti. Ad esempio, due progetti richiedono almeno 6000 UR/s (3 contenitori × 1000 UR/s × 2 progetti).

isolamento dei dati a livello progetto

L'installazione standard applica l'isolamento dei dati a livello di progetto per impostazione predefinita. Vengono forniti automaticamente due contenitori di archiviazione blob nel tuo account di archiviazione: uno per i file e uno per i dati di sistema temporanei (blocchi, incorporamenti). Viene effettuato il provisioning di tre contenitori nell'account Cosmos DB: uno per i thread utente, uno per i messaggi di sistema e uno per i dati di configurazione dell'agente, ad esempio istruzioni, strumenti e nomi. Questo comportamento predefinito riduce la complessità della configurazione, applicando comunque limiti di dati rigorosi tra i progetti.

Host di funzionalità

Gli host di funzionalità sono sotto-risorse sia nell'account che nel progetto che consentono l'interazione con il servizio Agent.

• Host della funzionalità dell'account: ha un corpo di richiesta vuoto, ad eccezione del parametro capabilityHostKind="Agents".
• Project capability host: specifica le risorse per l'archiviazione dello stato dell'agente, ovvero risorse multi-tenant gestite da Microsoft (configurazione di base) o risorse a tenant singolo di proprietà del cliente (configurazione standard). L'host delle funzionalità del progetto funziona come le impostazioni del progetto.

Limitazioni

• Non è possibile aggiornare l'host di funzionalità dopo che è impostato per un progetto o un account.

Eseguire l'approvvigionamento delle risorse passo dopo passo

Provisioning manuale

Seguire questa procedura per effettuare manualmente il provisioning di tutte le risorse necessarie per la configurazione dell'agente standard. Attendere circa 30-45 minuti per il processo di provisioning completo.

Fase 1: Creare risorse dipendenti

1. Creare o riutilizzare le risorse seguenti. È possibile creare nuove risorse o passare l'ID risorsa di quelli esistenti:
   • Azure Cosmos DB per l'account NoSQL
   • Account di archiviazione di Azure
   • Azure AI Search risorsa
   • risorsa di Azure Key Vault (usata per la gestione di segreti e stringhe di connessione per l'infrastruttura dell'agente)
   • [Facoltativa] Risorsa di applicazione Azure Insights
   • [Facoltativo] Risorsa Fonderia esistente

Fase 2: Creare le risorse e le connessioni per la foundry

2. Creare una risorsa Microsoft Foundry.
3. Creare connessioni a livello di account:
   • Creare una connessione account alla risorsa di Application Insights.
4. Implementare gpt-4o o un altro modello compatibile con agenti.
5. Creare un progetto.
6. Creare connessioni di progetto:
   • [Se specificato] Collegare la connessione alla risorsa Foundry.
   • Connessione del progetto all'account di Archiviazione di Azure.
   • Connessione del progetto alla risorsa Azure AI Search
   • La connessione del progetto all'account Cosmos DB.

Fase 3: Assegnare ruoli all'identità gestita del progetto

L'identità gestita del progetto include sia l'identità gestita assegnata dal sistema (SMI) che l'identità gestita assegnata dall'utente (UMI).

7. Assegnare l'identità gestita del progetto (per SMI) ai ruoli seguenti:
   • Operatore Cosmos DB a livello di account per la risorsa Cosmos DB.
   • Collaboratore dell'Account di Archiviazione a livello di account per la risorsa Account di Archiviazione.

Fase 4: Configurare gli host di funzionalità

8. Impostare l'host delle funzionalità dell'account con una sezione delle proprietà vuota.
9. Impostare l'host delle capacità del progetto con le connessioni Cosmos DB, Archiviazione di Azure e ricerca AI.

Fase 5: Assegnare autorizzazioni granulari per le risorse

10. Assegnare l'identità gestita del progetto (sia SMI che UMI) ai ruoli seguenti negli ambiti delle risorse specificati:
    • Azure AI Search (assegnare prima o dopo la creazione dell'host di funzionalità):
      • Collaboratore ai dati dell'indice di ricerca
      • Collaboratore servizio di ricerca
    • Archiviazione BLOB di Azure Container: <workspaceId>-azureml-blobstore
      • Collaboratore dei dati di Storage Blob
    • Archiviazione BLOB di Azure Container: <workspaceId>-agents-blobstore
      • Proprietario dei dati dei BLOB di archiviazione
    • Cosmos DB per NoSQL Database: enterprise_memory
      • Contributore dati integrato di Cosmos DB
      • Ambito: livello di database per coprire tutti i contenitori (non è necessaria alcuna assegnazione di ruolo specifica del contenitore).

Fase 6: Concedere l'accesso per sviluppatori

11. Assegnare tutti gli sviluppatori che devono creare o modificare agenti nel progetto il ruolo utente di intelligenza artificiale Azure nell'ambito del progetto.

Usare un modello di Bicep

Usare un account Azure OpenAI, un account Archiviazione di Azure esistente, un account Azure Cosmos DB per NoSQL o una risorsa Azure AI Search specificando l'ID completo della risorsa Azure Resource Manager (ARM) nel file del modello standard dell'agente.

Usare una risorsa OpenAI Azure esistente

1. Seguire la procedura descritta in Configurazione dell'ambiente per ottenere l'ID risorsa dell'account Foundry Tools.

2. Nel file modello di agente standard sostituire il segnaposto seguente:

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

Usare un account di Archiviazione di Azure esistente per l'archiviazione file

1. Accedere al interfaccia della riga di comando di Azure e selezionare la sottoscrizione con l'account di archiviazione:

   az login
   

2. Eseguire il comando seguente per ottenere l'ID risorsa dell'account di archiviazione:

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

   L'output è il aiStorageAccountResourceID valore di cui hai bisogno nel template.

3. Nel file modello di agente standard sostituire il segnaposto seguente:

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

Usare un account esistente di Azure Cosmos DB per NoSQL per l'archiviazione dei thread

Viene creato un Azure Cosmos DB per NoSQL account per ogni account Foundry. Per i requisiti di velocità effettiva e il ridimensionamento multiprogetto, vedere Requisiti di velocità effettiva di Cosmos DB.

1. Accedere al interfaccia della riga di comando di Azure e selezionare la sottoscrizione con l'account Cosmos DB:

   az login
   

2. Eseguire il comando seguente per ottenere l'ID risorsa dell'account Azure Cosmos DB:

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

   L'output è il cosmosDBResourceId valore di cui hai bisogno nel template.

3. Nel file modello di agente standard sostituire il segnaposto seguente:

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

Usare una risorsa di Azure AI Search esistente

1. Accedere al interfaccia della riga di comando di Azure e selezionare la sottoscrizione con la risorsa di ricerca:

   az login
   

2. Eseguire il comando seguente per ottenere l'ID risorsa Azure AI Search:

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

3. Nel file modello di agente standard sostituire il segnaposto seguente:

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

Verificare la configurazione

Dopo aver completato il provisioning, verificare che la configurazione funzioni correttamente:

1. Nel portale di Azure passare al progetto Foundry e verificare che tutte le connessioni (Archiviazione, Cosmos DB, Ricerca di intelligenza artificiale) siano visualizzate nelle impostazioni del progetto.
2. Verificare che lo stato dell'host delle funzionalità sia riuscito sia per l'account che per il progetto.
3. Verificare le assegnazioni di ruolo passando alla pagina Controllo di accesso (IAM) di ogni risorsa e confermando che l'identità gestita del progetto ha i ruoli previsti.
4. Creare un agente di test per confermare la funzionalità end-to-end.

Risolvere i problemi comuni

Contenuto correlato

• Configura l'ambiente per il servizio Foundry Agent
• Host di funzionalità
• Modello Bicep di configurazione standard dell'agente