Account Microsoft.CognitiveServices 2017-04-18
Definizione di risorsa Bicep
Il tipo di risorsa account può essere distribuito con operazioni destinate a:
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato risorsa
Per creare una risorsa Microsoft.CognitiveServices/accounts, aggiungere il bicep seguente al modello.
resource symbolicname 'Microsoft.CognitiveServices/accounts@2017-04-18' = {
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {
clientId: 'string'
principalId: 'string'
}
}
}
kind: 'string'
location: 'string'
name: 'string'
properties: {
apiProperties: {
aadClientId: 'string'
aadTenantId: 'string'
eventHubConnectionString: 'string'
qnaAzureSearchEndpointId: 'string'
qnaAzureSearchEndpointKey: 'string'
qnaRuntimeEndpoint: 'string'
statisticsEnabled: bool
storageAccountConnectionString: 'string'
superUser: 'string'
websiteName: 'string'
}
customSubDomainName: 'string'
encryption: {
keySource: 'string'
keyVaultProperties: {
keyName: 'string'
keyVaultUri: 'string'
keyVersion: 'string'
}
}
networkAcls: {
defaultAction: 'string'
ipRules: [
{
value: 'string'
}
]
virtualNetworkRules: [
{
id: 'string'
ignoreMissingVnetServiceEndpoint: bool
state: 'string'
}
]
}
privateEndpointConnections: [
{
location: 'string'
properties: {
groupIds: [
'string'
]
privateEndpoint: {}
privateLinkServiceConnectionState: {
actionsRequired: 'string'
description: 'string'
status: 'string'
}
}
}
]
publicNetworkAccess: 'string'
userOwnedStorage: [
{
resourceId: 'string'
}
]
}
sku: {
name: 'string'
}
tags: {
{customized property}: 'string'
}
}
Valori delle proprietà
CognitiveServicesAccountApiProperties
| Nome | Descrizione | Valore |
|---|---|---|
| aadClientId | (Solo Advisor metriche) ID client di Azure AD (ID applicazione). | corda Vincoli: Lunghezza massima = 500 |
| aadTenantId | (Solo Advisor metriche) ID tenant di Azure AD. | corda Vincoli: Lunghezza massima = 500 |
| eventHubConnectionString | (Solo personalizzazione) Flag per abilitare le statistiche di Ricerca Bing. | corda Vincoli: Lunghezza massima = 1000 Pattern = ^( *)Endpoint=sb://(.*);( *)SharedAccessKeyName=(.*);( *)SharedAccessKey=(.*)$ |
| qnaAzureSearchEndpointId | (solo QnAMaker) ID endpoint di Ricerca di Azure di QnAMaker. | corda |
| qnaAzureSearchEndpointKey | (solo QnAMaker) Chiave dell'endpoint di Ricerca di Azure di QnAMaker. | corda |
| qnaRuntimeEndpoint | (solo QnAMaker) Endpoint di runtime di QnAMaker. | corda |
| statisticsEnabled | (Solo ricerca Bing) Flag per abilitare le statistiche di Ricerca Bing. | Bool |
| storageAccountConnectionString | (Solo personalizzazione) Stringa di connessione dell'account di archiviazione. | corda Vincoli: Lunghezza massima = 1000 Pattern = ^(( *)DefaultEndpointsProtocol=(http|https)( *);( *))?AccountName=(.*)AccountKey=(.*)EndpointSuffix=(.*)$ |
| superutente | (Solo Advisor metriche) Utente con privilegi avanzati di Advisor metriche. | corda Vincoli: Lunghezza massima = 500 |
| websiteName | (Solo Advisor metriche) Nome del sito Web di Advisor metriche. | corda Vincoli: Lunghezza massima = 500 |
CognitiveServicesAccountProperties
| Nome | Descrizione | Valore |
|---|---|---|
| apiProperties | Proprietà api per API speciali. | CognitiveServicesAccountApiProperties |
| customSubDomainName | Nome sottodominio facoltativo usato per l'autenticazione basata su token. | corda |
| codifica | Proprietà di crittografia per questa risorsa. | encryption |
| networkAcls | Raccolta di regole che regolano l'accessibilità da percorsi di rete specifici. | NetworkRuleSet |
| privateEndpointConnections | Connessione dell'endpoint privato associato all'account servizi cognitivi. | PrivateEndpointConnection[] |
| publicNetworkAccess | Indica se l'accesso all'endpoint pubblico è consentito per questo account. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled' | 'Disabilitato' 'Enabled' |
| userOwnedStorage | Account di archiviazione per questa risorsa. | UserOwnedStorage[] |
CognitiveServicesAccountTags
| Nome | Descrizione | Valore |
|---|
Codifica
| Nome | Descrizione | Valore |
|---|---|---|
| keySource | Enumera il valore possibile di keySource per la crittografia | 'Microsoft.CognitiveServices' 'Microsoft.KeyVault' |
| keyVaultProperties | Proprietà di KeyVault | KeyVaultProperties |
Identità
| Nome | Descrizione | Valore |
|---|---|---|
| digitare | Tipo di identità del servizio gestito. | 'Nessuno' 'SystemAssigned' 'UserAssigned' |
| userAssignedIdentities | Elenco di identità assegnate dall'utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
| Nome | Descrizione | Valore |
|---|
IpRule
| Nome | Descrizione | Valore |
|---|---|---|
| valore | Intervallo di indirizzi IPv4 nella notazione CIDR, ad esempio "124.56.78.91" (indirizzo IP semplice) o "124.56.78.0/24" (tutti gli indirizzi che iniziano con 124.56.78). | stringa (obbligatorio) |
KeyVaultProperties
| Nome | Descrizione | Valore |
|---|---|---|
| keyName | Nome della chiave da KeyVault | corda |
| keyVaultUri | Uri dell'insieme di credenziali delle chiavi | corda |
| keyVersion | Versione della chiave da KeyVault | corda |
Microsoft.CognitiveServices/accounts
| Nome | Descrizione | Valore |
|---|---|---|
| identità | Identità dell'account servizi cognitivi. | identity |
| gentile | Tipo di risorsa. | corda |
| ubicazione | Posizione della risorsa | corda |
| nome | Nome della risorsa | corda Vincoli: Lunghezza minima = 2 Lunghezza massima = 64 Pattern = ^[a-zA-Z0-9][a-zA-Z0-9_.-]*$ (obbligatorio) |
| proprietà | Proprietà dell'account servizi cognitivi. | CognitiveServicesAccountProperties |
| Sku | SKU dell'account servizi cognitivi. | sku |
| Tag | Tag delle risorse | Dizionario di nomi e valori di tag. Vedere tag nei modelli |
NetworkRuleSet
| Nome | Descrizione | Valore |
|---|---|---|
| defaultAction | Azione predefinita quando nessuna regola da ipRules e da virtualNetworkRules corrispondono. Questa proprietà viene utilizzata solo dopo la valutazione della proprietà bypass. | 'Consenti' 'Deny' |
| ipRules | Elenco delle regole degli indirizzi IP. | IpRule [] |
| virtualNetworkRules | Elenco delle regole di rete virtuale. | VirtualNetworkRule[] |
PrivateEndpoint
| Nome | Descrizione | Valore |
|---|
PrivateEndpointConnection
| Nome | Descrizione | Valore |
|---|---|---|
| ubicazione | Posizione della connessione all'endpoint privato | corda |
| proprietà | Proprietà delle risorse. | PrivateEndpointConnectionProperties |
PrivateEndpointConnectionProperties
PrivateLinkServiceConnectionState
| Nome | Descrizione | Valore |
|---|---|---|
| actionsRequired | Messaggio che indica se le modifiche apportate al provider di servizi richiedono aggiornamenti sul consumer. | corda |
| descrizione | Motivo dell'approvazione/rifiuto della connessione. | corda |
| stato | Indica se la connessione è stata approvata/rifiutata/rimossa dal proprietario del servizio. | 'Approvato' 'Disconnesso' 'In sospeso' 'Rejected' |
Sku
| Nome | Descrizione | Valore |
|---|---|---|
| nome | Ottiene o imposta il nome dello SKU. Obbligatorio per la creazione dell'account, facoltativo per l'aggiornamento. | stringa (obbligatorio) |
UserAssignedIdentity
| Nome | Descrizione | Valore |
|---|---|---|
| clientId | ID app client associato a questa identità. | corda |
| principalId | ID entità di Azure Active Directory associato a questa identità. | corda |
UserOwnedStorage
| Nome | Descrizione | Valore |
|---|---|---|
| resourceId | ID risorsa completo di una risorsa Microsoft.Storage. | corda |
VirtualNetworkRule
| Nome | Descrizione | Valore |
|---|---|---|
| Id | ID risorsa completo di una subnet di rete virtuale, ad esempio "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1". | stringa (obbligatorio) |
| ignoreMissingVnetServiceEndpoint | Ignorare o meno l'endpoint del servizio di rete virtuale mancante. | Bool |
| stato | Ottiene lo stato della regola di rete virtuale. | corda |
Esempi di utilizzo
Moduli verificati di Azure
Per distribuire questo tipo di risorsa, è possibile usare moduli verificati di Azure.
| Modulo | Descrizione |
|---|---|
| di Servizi cognitivi di Azure | Modulo di risorse AVM per Servizi di intelligenza artificiale di Azure (Servizi cognitivi) |
Esempi di avvio rapido di Azure
I modelli di avvio rapido di Azure seguenti contengono esempi Bicep per la distribuzione di questo tipo di risorsa.
| Bicep File | Descrizione |
|---|---|
| configurazione di base di Azure AI Studio | Questo set di modelli illustra come configurare Azure AI Studio con la configurazione di base, ovvero con l'accesso a Internet pubblico abilitato, le chiavi gestite da Microsoft per la crittografia e la configurazione delle identità gestite da Microsoft per la risorsa di intelligenza artificiale. |
| configurazione di base di Azure AI Studio | Questo set di modelli illustra come configurare Azure AI Studio con la configurazione di base, ovvero con l'accesso a Internet pubblico abilitato, le chiavi gestite da Microsoft per la crittografia e la configurazione delle identità gestite da Microsoft per la risorsa di intelligenza artificiale. |
| configurazione di base di Azure AI Studio | Questo set di modelli illustra come configurare Azure AI Studio con la configurazione di base, ovvero con l'accesso a Internet pubblico abilitato, le chiavi gestite da Microsoft per la crittografia e la configurazione delle identità gestite da Microsoft per la risorsa di intelligenza artificiale. |
| con restrizioni di rete di Azure AI Studio | Questo set di modelli illustra come configurare Azure AI Studio con collegamento privato e uscita disabilitato, usando chiavi gestite da Microsoft per la crittografia e la configurazione delle identità gestite da Microsoft per la risorsa di intelligenza artificiale. |
| con restrizioni di rete di Azure AI Studio | Questo set di modelli illustra come configurare Azure AI Studio con collegamento privato e uscita disabilitato, usando chiavi gestite da Microsoft per la crittografia e la configurazione delle identità gestite da Microsoft per la risorsa di intelligenza artificiale. |
| Azure AI Studio con l'autenticazione dell'ID di Accesso Microsoft | Questo set di modelli illustra come configurare Azure AI Studio con l'autenticazione CON ID Entra di Microsoft per le risorse dipendenti, ad esempio Servizi di intelligenza artificiale di Azure e Archiviazione di Azure. |
| delle chiavi API di installazione dell'agente di base | Questo set di modelli illustra come configurare il servizio Azure AI Agent con la configurazione di base usando l'autenticazione delle chiavi API per la connessione al servizio di intelligenza artificiale/AOAI. Gli agenti usano risorse di ricerca e archiviazione multi-tenant completamente gestite da Microsoft. Non si avrà visibilità o controllo su queste risorse di Azure sottostanti. |
| di configurazione dell'agente di base | Questo set di modelli illustra come configurare il servizio Azure AI Agent con la configurazione di base usando l'autenticazione dell'identità gestita per la connessione al servizio di intelligenza artificiale/AOAI. Gli agenti usano risorse di ricerca e archiviazione multi-tenant completamente gestite da Microsoft. Non si avrà visibilità o controllo su queste risorse di Azure sottostanti. |
| Distribuire una risorsa multiservizio di Servizi di intelligenza artificiale di Azure | Questo modello distribuisce una risorsa dei servizi di intelligenza artificiale di Azure per portare l'intelligenza artificiale in portata di ogni sviluppatore senza richiedere competenze di Machine Learning. Tutto ciò che serve è una chiamata API per incorporare la possibilità di visualizzare, ascoltare, parlare, cercare, comprendere e accelerare il processo decisionale nelle app. |
| Distribuire una risorsa di Azure AI Translator | Questo modello distribuisce una risorsa di Azure AI Translator per portare l'intelligenza artificiale in portata di ogni sviluppatore senza richiedere competenze di Machine Learning. |
| Distribuire una risorsa di Visione artificiale di Azure | Questo modello distribuisce una risorsa di Visione artificiale di Azure per portare l'intelligenza artificiale in portata di ogni sviluppatore senza richiedere competenze di Machine Learning. |
| Distribuire Secure Azure AI Studio con una rete virtuale gestita | Questo modello crea un ambiente sicuro di Azure AI Studio con forti restrizioni di sicurezza di rete e identità. |
| agente protetto dalla rete con identità gestita dall'utente | Questo set di modelli illustra come configurare il servizio Agente di intelligenza artificiale di Azure con isolamento della rete virtuale usando l'autenticazione dell'identità gestita dall'utente per la connessione al servizio di intelligenza artificiale/AOAI e i collegamenti di rete privata per connettere l'agente ai dati sicuri. |
| configurazione dell'agente standard | Questo set di modelli illustra come configurare il servizio Azure AI Agent con la configurazione standard, ovvero con l'autenticazione dell'identità gestita per le connessioni di progetto/hub e l'accesso a Internet pubblico abilitato. 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. |
Definizione di risorsa del modello di Resource Manager
Il tipo di risorsa account può essere distribuito con operazioni destinate a:
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato risorsa
Per creare una risorsa Microsoft.CognitiveServices/accounts, aggiungere il codice JSON seguente al modello.
{
"type": "Microsoft.CognitiveServices/accounts",
"apiVersion": "2017-04-18",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
"clientId": "string",
"principalId": "string"
}
}
},
"kind": "string",
"location": "string",
"properties": {
"apiProperties": {
"aadClientId": "string",
"aadTenantId": "string",
"eventHubConnectionString": "string",
"qnaAzureSearchEndpointId": "string",
"qnaAzureSearchEndpointKey": "string",
"qnaRuntimeEndpoint": "string",
"statisticsEnabled": "bool",
"storageAccountConnectionString": "string",
"superUser": "string",
"websiteName": "string"
},
"customSubDomainName": "string",
"encryption": {
"keySource": "string",
"keyVaultProperties": {
"keyName": "string",
"keyVaultUri": "string",
"keyVersion": "string"
}
},
"networkAcls": {
"defaultAction": "string",
"ipRules": [
{
"value": "string"
}
],
"virtualNetworkRules": [
{
"id": "string",
"ignoreMissingVnetServiceEndpoint": "bool",
"state": "string"
}
]
},
"privateEndpointConnections": [
{
"location": "string",
"properties": {
"groupIds": [ "string" ],
"privateEndpoint": {
},
"privateLinkServiceConnectionState": {
"actionsRequired": "string",
"description": "string",
"status": "string"
}
}
}
],
"publicNetworkAccess": "string",
"userOwnedStorage": [
{
"resourceId": "string"
}
]
},
"sku": {
"name": "string"
},
"tags": {
"{customized property}": "string"
}
}
Valori delle proprietà
CognitiveServicesAccountApiProperties
| Nome | Descrizione | Valore |
|---|---|---|
| aadClientId | (Solo Advisor metriche) ID client di Azure AD (ID applicazione). | corda Vincoli: Lunghezza massima = 500 |
| aadTenantId | (Solo Advisor metriche) ID tenant di Azure AD. | corda Vincoli: Lunghezza massima = 500 |
| eventHubConnectionString | (Solo personalizzazione) Flag per abilitare le statistiche di Ricerca Bing. | corda Vincoli: Lunghezza massima = 1000 Pattern = ^( *)Endpoint=sb://(.*);( *)SharedAccessKeyName=(.*);( *)SharedAccessKey=(.*)$ |
| qnaAzureSearchEndpointId | (solo QnAMaker) ID endpoint di Ricerca di Azure di QnAMaker. | corda |
| qnaAzureSearchEndpointKey | (solo QnAMaker) Chiave dell'endpoint di Ricerca di Azure di QnAMaker. | corda |
| qnaRuntimeEndpoint | (solo QnAMaker) Endpoint di runtime di QnAMaker. | corda |
| statisticsEnabled | (Solo ricerca Bing) Flag per abilitare le statistiche di Ricerca Bing. | Bool |
| storageAccountConnectionString | (Solo personalizzazione) Stringa di connessione dell'account di archiviazione. | corda Vincoli: Lunghezza massima = 1000 Pattern = ^(( *)DefaultEndpointsProtocol=(http|https)( *);( *))?AccountName=(.*)AccountKey=(.*)EndpointSuffix=(.*)$ |
| superutente | (Solo Advisor metriche) Utente con privilegi avanzati di Advisor metriche. | corda Vincoli: Lunghezza massima = 500 |
| websiteName | (Solo Advisor metriche) Nome del sito Web di Advisor metriche. | corda Vincoli: Lunghezza massima = 500 |
CognitiveServicesAccountProperties
| Nome | Descrizione | Valore |
|---|---|---|
| apiProperties | Proprietà api per API speciali. | CognitiveServicesAccountApiProperties |
| customSubDomainName | Nome sottodominio facoltativo usato per l'autenticazione basata su token. | corda |
| codifica | Proprietà di crittografia per questa risorsa. | encryption |
| networkAcls | Raccolta di regole che regolano l'accessibilità da percorsi di rete specifici. | NetworkRuleSet |
| privateEndpointConnections | Connessione dell'endpoint privato associato all'account servizi cognitivi. | PrivateEndpointConnection[] |
| publicNetworkAccess | Indica se l'accesso all'endpoint pubblico è consentito per questo account. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled' | 'Disabilitato' 'Enabled' |
| userOwnedStorage | Account di archiviazione per questa risorsa. | UserOwnedStorage[] |
CognitiveServicesAccountTags
| Nome | Descrizione | Valore |
|---|
Codifica
| Nome | Descrizione | Valore |
|---|---|---|
| keySource | Enumera il valore possibile di keySource per la crittografia | 'Microsoft.CognitiveServices' 'Microsoft.KeyVault' |
| keyVaultProperties | Proprietà di KeyVault | KeyVaultProperties |
Identità
| Nome | Descrizione | Valore |
|---|---|---|
| digitare | Tipo di identità del servizio gestito. | 'Nessuno' 'SystemAssigned' 'UserAssigned' |
| userAssignedIdentities | Elenco di identità assegnate dall'utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
| Nome | Descrizione | Valore |
|---|
IpRule
| Nome | Descrizione | Valore |
|---|---|---|
| valore | Intervallo di indirizzi IPv4 nella notazione CIDR, ad esempio "124.56.78.91" (indirizzo IP semplice) o "124.56.78.0/24" (tutti gli indirizzi che iniziano con 124.56.78). | stringa (obbligatorio) |
KeyVaultProperties
| Nome | Descrizione | Valore |
|---|---|---|
| keyName | Nome della chiave da KeyVault | corda |
| keyVaultUri | Uri dell'insieme di credenziali delle chiavi | corda |
| keyVersion | Versione della chiave da KeyVault | corda |
Microsoft.CognitiveServices/accounts
| Nome | Descrizione | Valore |
|---|---|---|
| apiVersion | Versione dell'API | '2017-04-18' |
| identità | Identità dell'account servizi cognitivi. | identity |
| gentile | Tipo di risorsa. | corda |
| ubicazione | Posizione della risorsa | corda |
| nome | Nome della risorsa | corda Vincoli: Lunghezza minima = 2 Lunghezza massima = 64 Pattern = ^[a-zA-Z0-9][a-zA-Z0-9_.-]*$ (obbligatorio) |
| proprietà | Proprietà dell'account servizi cognitivi. | CognitiveServicesAccountProperties |
| Sku | SKU dell'account servizi cognitivi. | sku |
| Tag | Tag delle risorse | Dizionario di nomi e valori di tag. Vedere tag nei modelli |
| digitare | Tipo di risorsa | 'Microsoft.CognitiveServices/accounts' |
NetworkRuleSet
| Nome | Descrizione | Valore |
|---|---|---|
| defaultAction | Azione predefinita quando nessuna regola da ipRules e da virtualNetworkRules corrispondono. Questa proprietà viene utilizzata solo dopo la valutazione della proprietà bypass. | 'Consenti' 'Deny' |
| ipRules | Elenco delle regole degli indirizzi IP. | IpRule [] |
| virtualNetworkRules | Elenco delle regole di rete virtuale. | VirtualNetworkRule[] |
PrivateEndpoint
| Nome | Descrizione | Valore |
|---|
PrivateEndpointConnection
| Nome | Descrizione | Valore |
|---|---|---|
| ubicazione | Posizione della connessione all'endpoint privato | corda |
| proprietà | Proprietà delle risorse. | PrivateEndpointConnectionProperties |
PrivateEndpointConnectionProperties
PrivateLinkServiceConnectionState
| Nome | Descrizione | Valore |
|---|---|---|
| actionsRequired | Messaggio che indica se le modifiche apportate al provider di servizi richiedono aggiornamenti sul consumer. | corda |
| descrizione | Motivo dell'approvazione/rifiuto della connessione. | corda |
| stato | Indica se la connessione è stata approvata/rifiutata/rimossa dal proprietario del servizio. | 'Approvato' 'Disconnesso' 'In sospeso' 'Rejected' |
Sku
| Nome | Descrizione | Valore |
|---|---|---|
| nome | Ottiene o imposta il nome dello SKU. Obbligatorio per la creazione dell'account, facoltativo per l'aggiornamento. | stringa (obbligatorio) |
UserAssignedIdentity
| Nome | Descrizione | Valore |
|---|---|---|
| clientId | ID app client associato a questa identità. | corda |
| principalId | ID entità di Azure Active Directory associato a questa identità. | corda |
UserOwnedStorage
| Nome | Descrizione | Valore |
|---|---|---|
| resourceId | ID risorsa completo di una risorsa Microsoft.Storage. | corda |
VirtualNetworkRule
| Nome | Descrizione | Valore |
|---|---|---|
| Id | ID risorsa completo di una subnet di rete virtuale, ad esempio "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1". | stringa (obbligatorio) |
| ignoreMissingVnetServiceEndpoint | Ignorare o meno l'endpoint del servizio di rete virtuale mancante. | Bool |
| stato | Ottiene lo stato della regola di rete virtuale. | corda |
Esempi di utilizzo
Modelli di avvio rapido di Azure
I modelli di avvio rapido di Azure seguenti distribuire questo tipo di risorsa.
| Sagoma | Descrizione |
|---|---|
configurazione di base di Azure AI Studio
|
Questo set di modelli illustra come configurare Azure AI Studio con la configurazione di base, ovvero con l'accesso a Internet pubblico abilitato, le chiavi gestite da Microsoft per la crittografia e la configurazione delle identità gestite da Microsoft per la risorsa di intelligenza artificiale. |
|
configurazione di base di Azure AI Studio
|
Questo set di modelli illustra come configurare Azure AI Studio con la configurazione di base, ovvero con l'accesso a Internet pubblico abilitato, le chiavi gestite da Microsoft per la crittografia e la configurazione delle identità gestite da Microsoft per la risorsa di intelligenza artificiale. |
|
configurazione di base di Azure AI Studio
|
Questo set di modelli illustra come configurare Azure AI Studio con la configurazione di base, ovvero con l'accesso a Internet pubblico abilitato, le chiavi gestite da Microsoft per la crittografia e la configurazione delle identità gestite da Microsoft per la risorsa di intelligenza artificiale. |
|
con restrizioni di rete di Azure AI Studio
|
Questo set di modelli illustra come configurare Azure AI Studio con collegamento privato e uscita disabilitato, usando chiavi gestite da Microsoft per la crittografia e la configurazione delle identità gestite da Microsoft per la risorsa di intelligenza artificiale. |
|
con restrizioni di rete di Azure AI Studio
|
Questo set di modelli illustra come configurare Azure AI Studio con collegamento privato e uscita disabilitato, usando chiavi gestite da Microsoft per la crittografia e la configurazione delle identità gestite da Microsoft per la risorsa di intelligenza artificiale. |
|
Azure AI Studio con l'autenticazione dell'ID di Accesso Microsoft
|
Questo set di modelli illustra come configurare Azure AI Studio con l'autenticazione CON ID Entra di Microsoft per le risorse dipendenti, ad esempio Servizi di intelligenza artificiale di Azure e Archiviazione di Azure. |
|
delle chiavi API di installazione dell'agente di base
|
Questo set di modelli illustra come configurare il servizio Azure AI Agent con la configurazione di base usando l'autenticazione delle chiavi API per la connessione al servizio di intelligenza artificiale/AOAI. Gli agenti usano risorse di ricerca e archiviazione multi-tenant completamente gestite da Microsoft. Non si avrà visibilità o controllo su queste risorse di Azure sottostanti. |
|
di configurazione dell'agente di base
|
Questo set di modelli illustra come configurare il servizio Azure AI Agent con la configurazione di base usando l'autenticazione dell'identità gestita per la connessione al servizio di intelligenza artificiale/AOAI. Gli agenti usano risorse di ricerca e archiviazione multi-tenant completamente gestite da Microsoft. Non si avrà visibilità o controllo su queste risorse di Azure sottostanti. |
|
Distribuire una risorsa multiservizio di Servizi di intelligenza artificiale di Azure
|
Questo modello distribuisce una risorsa dei servizi di intelligenza artificiale di Azure per portare l'intelligenza artificiale in portata di ogni sviluppatore senza richiedere competenze di Machine Learning. Tutto ciò che serve è una chiamata API per incorporare la possibilità di visualizzare, ascoltare, parlare, cercare, comprendere e accelerare il processo decisionale nelle app. |
|
Distribuire una risorsa di Azure AI Translator
|
Questo modello distribuisce una risorsa di Azure AI Translator per portare l'intelligenza artificiale in portata di ogni sviluppatore senza richiedere competenze di Machine Learning. |
|
Distribuire una risorsa di Visione artificiale di Azure
|
Questo modello distribuisce una risorsa di Visione artificiale di Azure per portare l'intelligenza artificiale in portata di ogni sviluppatore senza richiedere competenze di Machine Learning. |
|
Distribuire Secure Azure AI Studio con una rete virtuale gestita
|
Questo modello crea un ambiente sicuro di Azure AI Studio con forti restrizioni di sicurezza di rete e identità. |
|
agente protetto dalla rete con identità gestita dall'utente
|
Questo set di modelli illustra come configurare il servizio Agente di intelligenza artificiale di Azure con isolamento della rete virtuale usando l'autenticazione dell'identità gestita dall'utente per la connessione al servizio di intelligenza artificiale/AOAI e i collegamenti di rete privata per connettere l'agente ai dati sicuri. |
|
configurazione dell'agente standard
|
Questo set di modelli illustra come configurare il servizio Azure AI Agent con la configurazione standard, ovvero con l'autenticazione dell'identità gestita per le connessioni di progetto/hub e l'accesso a Internet pubblico abilitato. 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. |
Definizione di risorsa Terraform (provider AzAPI)
Il tipo di risorsa account può essere distribuito con operazioni destinate a:
- gruppi di risorse
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato risorsa
Per creare una risorsa Microsoft.CognitiveServices/accounts, aggiungere il comando Terraform seguente al modello.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.CognitiveServices/accounts@2017-04-18"
name = "string"
identity = {
type = "string"
userAssignedIdentities = {
{customized property} = {
clientId = "string"
principalId = "string"
}
}
}
kind = "string"
location = "string"
sku = {
name = "string"
}
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
apiProperties = {
aadClientId = "string"
aadTenantId = "string"
eventHubConnectionString = "string"
qnaAzureSearchEndpointId = "string"
qnaAzureSearchEndpointKey = "string"
qnaRuntimeEndpoint = "string"
statisticsEnabled = bool
storageAccountConnectionString = "string"
superUser = "string"
websiteName = "string"
}
customSubDomainName = "string"
encryption = {
keySource = "string"
keyVaultProperties = {
keyName = "string"
keyVaultUri = "string"
keyVersion = "string"
}
}
networkAcls = {
defaultAction = "string"
ipRules = [
{
value = "string"
}
]
virtualNetworkRules = [
{
id = "string"
ignoreMissingVnetServiceEndpoint = bool
state = "string"
}
]
}
privateEndpointConnections = [
{
location = "string"
properties = {
groupIds = [
"string"
]
privateEndpoint = {
}
privateLinkServiceConnectionState = {
actionsRequired = "string"
description = "string"
status = "string"
}
}
}
]
publicNetworkAccess = "string"
userOwnedStorage = [
{
resourceId = "string"
}
]
}
})
}
Valori delle proprietà
CognitiveServicesAccountApiProperties
| Nome | Descrizione | Valore |
|---|---|---|
| aadClientId | (Solo Advisor metriche) ID client di Azure AD (ID applicazione). | corda Vincoli: Lunghezza massima = 500 |
| aadTenantId | (Solo Advisor metriche) ID tenant di Azure AD. | corda Vincoli: Lunghezza massima = 500 |
| eventHubConnectionString | (Solo personalizzazione) Flag per abilitare le statistiche di Ricerca Bing. | corda Vincoli: Lunghezza massima = 1000 Pattern = ^( *)Endpoint=sb://(.*);( *)SharedAccessKeyName=(.*);( *)SharedAccessKey=(.*)$ |
| qnaAzureSearchEndpointId | (solo QnAMaker) ID endpoint di Ricerca di Azure di QnAMaker. | corda |
| qnaAzureSearchEndpointKey | (solo QnAMaker) Chiave dell'endpoint di Ricerca di Azure di QnAMaker. | corda |
| qnaRuntimeEndpoint | (solo QnAMaker) Endpoint di runtime di QnAMaker. | corda |
| statisticsEnabled | (Solo ricerca Bing) Flag per abilitare le statistiche di Ricerca Bing. | Bool |
| storageAccountConnectionString | (Solo personalizzazione) Stringa di connessione dell'account di archiviazione. | corda Vincoli: Lunghezza massima = 1000 Pattern = ^(( *)DefaultEndpointsProtocol=(http|https)( *);( *))?AccountName=(.*)AccountKey=(.*)EndpointSuffix=(.*)$ |
| superutente | (Solo Advisor metriche) Utente con privilegi avanzati di Advisor metriche. | corda Vincoli: Lunghezza massima = 500 |
| websiteName | (Solo Advisor metriche) Nome del sito Web di Advisor metriche. | corda Vincoli: Lunghezza massima = 500 |
CognitiveServicesAccountProperties
| Nome | Descrizione | Valore |
|---|---|---|
| apiProperties | Proprietà api per API speciali. | CognitiveServicesAccountApiProperties |
| customSubDomainName | Nome sottodominio facoltativo usato per l'autenticazione basata su token. | corda |
| codifica | Proprietà di crittografia per questa risorsa. | encryption |
| networkAcls | Raccolta di regole che regolano l'accessibilità da percorsi di rete specifici. | NetworkRuleSet |
| privateEndpointConnections | Connessione dell'endpoint privato associato all'account servizi cognitivi. | PrivateEndpointConnection[] |
| publicNetworkAccess | Indica se l'accesso all'endpoint pubblico è consentito per questo account. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled' | 'Disabilitato' 'Enabled' |
| userOwnedStorage | Account di archiviazione per questa risorsa. | UserOwnedStorage[] |
CognitiveServicesAccountTags
| Nome | Descrizione | Valore |
|---|
Codifica
| Nome | Descrizione | Valore |
|---|---|---|
| keySource | Enumera il valore possibile di keySource per la crittografia | 'Microsoft.CognitiveServices' 'Microsoft.KeyVault' |
| keyVaultProperties | Proprietà di KeyVault | KeyVaultProperties |
Identità
| Nome | Descrizione | Valore |
|---|---|---|
| digitare | Tipo di identità del servizio gestito. | 'Nessuno' 'SystemAssigned' 'UserAssigned' |
| userAssignedIdentities | Elenco di identità assegnate dall'utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
| Nome | Descrizione | Valore |
|---|
IpRule
| Nome | Descrizione | Valore |
|---|---|---|
| valore | Intervallo di indirizzi IPv4 nella notazione CIDR, ad esempio "124.56.78.91" (indirizzo IP semplice) o "124.56.78.0/24" (tutti gli indirizzi che iniziano con 124.56.78). | stringa (obbligatorio) |
KeyVaultProperties
| Nome | Descrizione | Valore |
|---|---|---|
| keyName | Nome della chiave da KeyVault | corda |
| keyVaultUri | Uri dell'insieme di credenziali delle chiavi | corda |
| keyVersion | Versione della chiave da KeyVault | corda |
Microsoft.CognitiveServices/accounts
| Nome | Descrizione | Valore |
|---|---|---|
| identità | Identità dell'account servizi cognitivi. | identity |
| gentile | Tipo di risorsa. | corda |
| ubicazione | Posizione della risorsa | corda |
| nome | Nome della risorsa | corda Vincoli: Lunghezza minima = 2 Lunghezza massima = 64 Pattern = ^[a-zA-Z0-9][a-zA-Z0-9_.-]*$ (obbligatorio) |
| proprietà | Proprietà dell'account servizi cognitivi. | CognitiveServicesAccountProperties |
| Sku | SKU dell'account servizi cognitivi. | sku |
| Tag | Tag delle risorse | Dizionario di nomi e valori di tag. |
| digitare | Tipo di risorsa | "Microsoft.CognitiveServices/accounts@2017-04-18" |
NetworkRuleSet
| Nome | Descrizione | Valore |
|---|---|---|
| defaultAction | Azione predefinita quando nessuna regola da ipRules e da virtualNetworkRules corrispondono. Questa proprietà viene utilizzata solo dopo la valutazione della proprietà bypass. | 'Consenti' 'Deny' |
| ipRules | Elenco delle regole degli indirizzi IP. | IpRule [] |
| virtualNetworkRules | Elenco delle regole di rete virtuale. | VirtualNetworkRule[] |
PrivateEndpoint
| Nome | Descrizione | Valore |
|---|
PrivateEndpointConnection
| Nome | Descrizione | Valore |
|---|---|---|
| ubicazione | Posizione della connessione all'endpoint privato | corda |
| proprietà | Proprietà delle risorse. | PrivateEndpointConnectionProperties |
PrivateEndpointConnectionProperties
PrivateLinkServiceConnectionState
| Nome | Descrizione | Valore |
|---|---|---|
| actionsRequired | Messaggio che indica se le modifiche apportate al provider di servizi richiedono aggiornamenti sul consumer. | corda |
| descrizione | Motivo dell'approvazione/rifiuto della connessione. | corda |
| stato | Indica se la connessione è stata approvata/rifiutata/rimossa dal proprietario del servizio. | 'Approvato' 'Disconnesso' 'In sospeso' 'Rejected' |
Sku
| Nome | Descrizione | Valore |
|---|---|---|
| nome | Ottiene o imposta il nome dello SKU. Obbligatorio per la creazione dell'account, facoltativo per l'aggiornamento. | stringa (obbligatorio) |
UserAssignedIdentity
| Nome | Descrizione | Valore |
|---|---|---|
| clientId | ID app client associato a questa identità. | corda |
| principalId | ID entità di Azure Active Directory associato a questa identità. | corda |
UserOwnedStorage
| Nome | Descrizione | Valore |
|---|---|---|
| resourceId | ID risorsa completo di una risorsa Microsoft.Storage. | corda |
VirtualNetworkRule
| Nome | Descrizione | Valore |
|---|---|---|
| Id | ID risorsa completo di una subnet di rete virtuale, ad esempio "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1". | stringa (obbligatorio) |
| ignoreMissingVnetServiceEndpoint | Ignorare o meno l'endpoint del servizio di rete virtuale mancante. | Bool |
| stato | Ottiene lo stato della regola di rete virtuale. | corda |
Esempi di utilizzo
Moduli verificati di Azure
Per distribuire questo tipo di risorsa, è possibile usare moduli verificati di Azure.
| Modulo | Descrizione |
|---|---|
| servizi cognitivi | Modulo risorse AVM per l'account di Servizi cognitivi ( Open AI) |