Usare le proprie risorse

Usare questo articolo se si vuole usare il servizio Agente di Azure con le risorse già disponibili.

Nota

• Se si usa una risorsa del servizio di intelligenza artificiale o del servizio OpenAI di Azure esistente, non verrà distribuito alcun modello. È possibile distribuire un modello nella risorsa al termine dell'installazione dell'agente.
• Assicurarsi che la risorsa OpenAI di Azure e il progetto Azure AI Foundry si trovino nella stessa area.

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: gli agenti usano risorse di ricerca e archiviazione multi-tenant completamente gestite da Microsoft. Non si ha visibilità o controllo su queste risorse di Azure sottostanti. È possibile usare solo il proprio account di servizi di intelligenza artificiale con questa opzione.

Configurazione standard: gli agenti usano risorse di ricerca e archiviazione a tenant singolo di proprietà del cliente. Con questa configurazione, si ha il controllo completo e la visibilità su queste risorse, ma si comportano costi in base all'utilizzo. È possibile usare un account di servizi di intelligenza artificiale, un account di archiviazione e/o una risorsa di Ricerca intelligenza artificiale di Azure con questa opzione.

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

Sostituire il valore del parametro per aiServiceAccountResourceId con l'ID risorsa arm completo della risorsa ai Services o di Azure OpenAI che si vuole usare.

1. Per ottenere l'ID risorsa dell'account dei servizi di intelligenza artificiale, accedere all'interfaccia della riga di comando di Azure e selezionare la sottoscrizione con l'account dei servizi di intelligenza artificiale:

   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 del servizio di intelligenza artificiale ed eseguire:

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

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

3. Nel file modello dell'agente di base sostituire i segnaposto seguenti:

   aiServiceAccountResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{serviceName}
   
   [Azure OpenAI Only] aiServiceKind: AzureOpenAI
   

   Se si vuole usare una risorsa OpenAI di Azure esistente, è necessario aggiornare aiServiceAccountResourceId e i aiServiceKind parametri nel file dei parametri. Il parametro aiServiceKind deve essere impostato su AzureOpenAI.

Configurazione dell'agente standard: usare una risorsa di Ricerca di intelligenza artificiale esistente/Azure OpenAI, archiviazione e/o Ricerca di intelligenza artificiale di Azure

Usare una risorsa di ricerca di intelligenza artificiale, un account di archiviazione e/o una risorsa di Ricerca di intelligenza artificiale di Azure specificando l'ID risorsa arm completo nel file del modello dell'agente standard.

Usare un servizio di intelligenza artificiale esistente o una risorsa OpenAI di Azure:

1. Seguire la procedura descritta nella configurazione dell'agente di base per ottenere l'ID risorsa dell'account ai Servizi di intelligenza artificiale.

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

   aiServiceAccountResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{serviceName}
   
   [Azure OpenAI Only] aiServiceKind: AzureOpenAI
   

Usare un account di archiviazione esistente

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

   az login

2. Eseguire quindi il comando :

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

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

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

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

Usare una risorsa di Ricerca intelligenza artificiale di Azure esistente

1. Per ottenere l'ID risorsa di Ricerca intelligenza artificiale di Azure, accedere all'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 i segnaposto seguenti:

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

Vedi anche

• Informazioni sui diversi agenti degli strumenti che è possibile usare.