Usare le proprie risorse (versione classica)

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

Per impostazione predefinita, foundry Agent Service gestisce l'archiviazione per file, conversazioni e archivi vettoriali. Se l'organizzazione richiede la proprietà completa dei dati, le chiavi gestite dal cliente o l'isolamento della rete, è possibile connettere le proprie risorse Azure. Questo articolo illustra come configurare i modelli di distribuzione per l'uso di Azure risorse OpenAI, Archiviazione di Azure, Azure Cosmos DB e Azure AI Search esistenti con il servizio Agent.

Limitazioni

Esistono alcune limitazioni da tenere presenti quando si prevede di usare le risorse esistenti con il servizio agente Foundry.

Se stai utilizzando un progetto basato su hub o Assistenti OpenAI di Azure

Al momento, non esiste alcun percorso di aggiornamento diretto per eseguire la migrazione di agenti esistenti o degli asset di dati associati, ad esempio file, conversazioni o archivi vettoriali da un progetto basato su hub a un progetto Microsoft Foundry. Non esiste anche alcun percorso di aggiornamento per convertire Azure Assistenti OpenAI esistenti in agenti Foundry, né un modo per eseguire automaticamente la migrazione dei file, delle conversazioni o degli archivi vettoriali degli Assistenti.

È possibile riutilizzare le distribuzioni e la quota di modelli esistenti dagli strumenti Foundry o dalle risorse OpenAI di Azure all'interno di un progetto Foundry.

Utilizzo dell'SDK con progetti basati su hub

A partire da maggio 2025, il servizio agente di intelligenza artificiale Azure usa un endpoint per i progetti Foundry invece del stringa di connessione usato per i progetti basati su hub prima di questa volta. Le stringhe di connessione non sono più supportate nelle versioni correnti degli SDK e dell'API REST. È consigliabile creare un nuovo progetto Foundry.

Se si vuole continuare a usare il progetto basato su hub e stringa di connessione, è necessario:

• Utilizzare la stringa di connessione del progetto che si trova sotto Connection string nella panoramica del progetto.

  Uno screenshot che mostra la stringa di connessione legacy per un progetto basato su hub.

• Usare una delle versioni precedenti dell'SDK e il codice di esempio associato:

  • C#: 1.0.0-beta.2 o versioni precedenti
  • Python: 1.0.0b10 o versioni precedenti

Azure Cosmos DB per NoSQL archiviare le conversazioni

• Il Azure Cosmos DB esistente per NoSQL account usato in una configurazione standard deve avere un limite di velocità effettiva totale di almeno 3000 UR/sec. È supportata sia la capacità con provisioning che la capacità serverless.
• Verrà effettuato il provisioning di tre-cinque contenitori nell'account Cosmos DB esistente, ognuno dei quali richiede 1000 UR/sec. Durante il provisioning degli host delle funzionalità ne vengono creati tre e fino ad altri due vengono creati dinamicamente quando si creano agenti che usano l'API Responses.

Prerequisiti

• Sottoscrizione di Azure : Crearne una gratuitamente.

• interfaccia della riga di comando di Azure (versione 2.64 o successiva).

• Verificare che la persona che crea l'account e il progetto abbia il ruolo proprietario dell'account Foundry nell'ambito della sottoscrizione

  Importante

  I ruoli di Controllo degli accessi in base al ruolo di Foundry sono stati recentemente rinominati. Foundry User, Foundry Owner, Foundry Account Owner e Foundry Project Manager erano precedentemente denominati Azure AI User, Azure AI Owner, Azure AI Account Owner e Azure AI Project Manager. È possibile che i nomi precedenti vengano visualizzati in alcune posizioni durante l'esecuzione della ridenominazione. Gli ID ruolo e le autorizzazioni di base sono invariati dalla ridenominazione.

• Se si configura una configurazione standard, la stessa persona deve avere anche le autorizzazioni per assegnare ruoli alle risorse necessarie (Cosmos DB, Ricerca, Archiviazione). Per ulteriori informazioni su RBAC in Foundry, vedi RBAC in Foundry.

  • Il ruolo predefinito necessario è Amministratore degli accessi in base al ruolo.
  • In alternativa, avere il ruolo Proprietario a livello di sottoscrizione soddisfa anche questo requisito.
  • L'autorizzazione chiave necessaria è: Microsoft.Authorization/roleAssignments/write

• Registrare i fornitori. I provider seguenti devono essere registrati:

  • Microsoft.KeyVault
  • Microsoft.CognitiveServices
  • Microsoft.Storage
  • Microsoft.MachineLearningServices
  • Microsoft.Search
  • Microsoft.App
  • Microsoft.ContainerService

Per usare il Grounding con lo strumento ricerca Bing è necessario registrare il provider seguente: Microsoft.Bing

az provider register --namespace 'Microsoft.KeyVault'
az provider register --namespace 'Microsoft.CognitiveServices'
az provider register --namespace 'Microsoft.Storage'
az provider register --namespace 'Microsoft.MachineLearningServices'
az provider register --namespace 'Microsoft.Search'
az provider register --namespace 'Microsoft.App'
az provider register --namespace 'Microsoft.ContainerService'
# only to use Grounding with Bing Search tool
az provider register --namespace 'Microsoft.Bing'

Scegliere la configurazione dell'agente di base o standard

Per usare le proprie risorse, è possibile modificare i parametri nei modelli di distribuzione forniti. Per iniziare, determinare se si vuole modificare il modello di installazione dell'agente di base o il modello di installazione dell'agente standard.

Configurazione di base

Questa configurazione è compatibile con Gli assistenti OpenAI e gestisce gli stati dell'agente usando l'archiviazione predefinita della piattaforma. Include gli stessi strumenti e funzionalità dell'API Assistenti, con il supporto aggiunto per modelli e strumenti non OpenAI, ad esempio Azure AI Search e Bing.

Configurazione standard

Include tutti gli elementi della configurazione di base e il controllo granulare sui dati consentendo di usare le proprie risorse Azure. Tutti i dati dei clienti, inclusi file, conversazioni e archivi vettoriali, vengono archiviati nelle proprie risorse Azure, offrendo la proprietà e il controllo completi.

Configurazione dell'agente di base: usare una risorsa OpenAI Azure esistente

Sostituire il valore del parametro per existingAoaiResourceIdnel modello con l'ID completo della risorsa ARM della risorsa Azure OpenAI da usare.

1. Per ottenere l'ID risorsa dell'account OpenAI Azure, accedere al interfaccia della riga di comando di Azure e selezionare la sottoscrizione con l'account Foundry Tools:

   az login
   

2. Sostituire <your-resource-group> con il gruppo di risorse contenente la risorsa e <your-ai-service-resource-name> con il nome della risorsa Azure OpenAI o AI Services ed eseguire il comando seguente:

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

   Il valore restituito è l'elemento existingAoaiResourceId che è necessario usare nel modello.

3. Nel file modello dell'agente di base sostituire il segnaposto seguente:

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

Configurazione dell'agente standard: usare le risorse del servizio e gli account di archiviazione esistenti

Usare un account esistente di Azure OpenAI, Archiviazione di Azure, un account Azure Cosmos DB per NoSQL e/o una risorsa Azure AI Search specificando l'ID risorsa ARM completo nel file modello standard dell'agente.

Usare una risorsa OpenAI Azure esistente

1. Seguire la procedura descritta nella configurazione di base dell'agente per ottenere l'ID risorsa dell'account degli strumenti Foundry.

2. Nel file modello di agente standard sostituire i segnaposto seguenti:

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

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

1. Per ottenere l'ID risorsa dell'account di archiviazione, accedere al interfaccia della riga di comando di Azure e selezionare la sottoscrizione con l'account di archiviazione:

   az login
   

2. Eseguire quindi il comando :

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

   L'output è l'elemento azureStorageAccountResourceId da usare nel modello.

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

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

Usare un Azure Cosmos DB esistente per NoSQL account per l'archiviazione delle conversazioni

Viene creato un Azure Cosmos DB per NoSQL account per ogni account Foundry.

Per ogni progetto con un account Foundry, vengono distribuiti tre o cinque contenitori nello stesso account Cosmos DB. Ogni contenitore richiede almeno 1000 UR/sec. I nomi dei contenitori sono preceduti dall'ID progetto:

• <project-id>-thread-message-store, <project-id>-system-thread-message-storee <project-id>-agent-entity-store vengono creati durante il provisioning dell'host di funzionalità.
• <project-id>-agent-definitions-v1 e <project-id>-run-state-v1 vengono creati dinamicamente quando viene richiamato il primo agente del progetto che usa l'API Risposte.

Ad esempio, se due progetti vengono distribuiti nello stesso account Foundry e entrambi usano gli agenti API Responses, l'account Cosmos DB deve essere configurato con almeno 10.000 UR/s (5 contenitori × 1000 UR/s × 2 progetti) per garantire una velocità effettiva sufficiente. Se i progetti usano solo agenti classici (API Assistenti), sono sufficienti 6.000 UR/sec.

Sono supportate sia le modalità a throughput provisionato che quelle serverless.

1. Per ottenere l'ID risorsa dell'account Azure Cosmos DB, accedere al interfaccia della riga di comando di Azure e selezionare la sottoscrizione con l'account:

   az login
   

2. Eseguire quindi il comando :

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

   L'output è l'elemento azureCosmosDBAccountResourceId da usare nel modello.

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

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

Usare una risorsa di Azure AI Search esistente

1. Per ottenere l'ID risorsa Azure AI Search, accedere al interfaccia della riga di comando di Azure e selezionare la sottoscrizione con la risorsa di ricerca:

   az login
   

2. Eseguire quindi il comando :

   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:

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

Vedere anche

• Informazioni su come connettere gli agenti agli strumenti usando la casella degli strumenti Foundry.