Knowledge Sources - Get
Recupera la definizione di un'origine conoscenza.
GET {endpoint}/knowledgesources('{sourceName}')?api-version=2025-08-01-preview
Parametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
endpoint
|
path | True |
string |
URL dell'endpoint del servizio di ricerca. |
|
source
|
path | True |
string |
Nome dell'origine della conoscenza da recuperare. |
|
api-version
|
query | True |
string |
Versione dell'API client. |
Intestazione della richiesta
| Nome | Necessario | Tipo | Descrizione |
|---|---|---|---|
| x-ms-client-request-id |
string (uuid) |
ID di rilevamento inviato con la richiesta di assistenza per il debug. |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK | KnowledgeSource: | |
| Other Status Codes |
Risposta di errore. |
Esempio
|
Search |
|
Search |
SearchServiceGetKnowledgeSource
Esempio di richiesta
GET https://previewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2025-08-01-preview
Risposta di esempio
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-preview-test",
"kind": "searchIndex",
"description": "Description of the knowledge source.",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"searchIndexParameters": {
"searchIndexName": "preview-test",
"sourceDataSelect": "description,category"
}
}
SearchServiceGetKnowledgeSourceAzureBlob
Esempio di richiesta
GET https://previewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2025-08-01-preview
Risposta di esempio
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-preview-test",
"kind": "azureBlob",
"description": "Description of the knowledge source.",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"azureBlobParameters": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "test-container",
"folderPath": "test-path",
"identity": {
"@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
"userAssignedIdentity": "/my/userassigned/id"
},
"embeddingModel": {
"name": "openai",
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com",
"deploymentId": "model",
"apiKey": "<redacted>",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com",
"deploymentId": "myDeployment",
"apiKey": "<redacted>",
"modelName": "gpt-4o-mini"
}
},
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2024-06-06T00:01:50.265Z"
}
}
}
Definizioni
| Nome | Descrizione |
|---|---|
|
AIFoundry |
Nome del modello di incorporamento dal catalogo di Azure AI Foundry che verrà chiamato. |
|
AIServices |
Specifica i parametri di Visione di AI Services per la vettorializzazione di un'immagine o di un testo di query. |
|
AIServices |
Specifica i parametri di Visione di AI Services per la vettorializzazione di un'immagine o di un testo di query. |
| AMLParameters |
Specifica le proprietà per la connessione a un vettorizzatore AML. |
| AMLVectorizer |
Specifica un endpoint di Azure Machine Learning distribuito tramite il catalogo dei modelli di Azure AI Foundry per generare l'incorporamento vettoriale di una stringa di query. |
|
Azure |
Credenziali di un'applicazione registrata creata per il servizio di ricerca, usata per l'accesso autenticato alle chiavi di crittografia archiviate in Azure Key Vault. |
|
Azure |
Configurazione per l'origine della conoscenza di Archiviazione BLOB di Azure. |
|
Azure |
Parametri per l'origine della conoscenza di Archiviazione BLOB di Azure. |
|
Azure |
Consente di generare un incorporamento vettoriale per un determinato input di testo usando la risorsa Azure OpenAI. |
|
Azure |
Nome del modello Azure Open AI che verrà chiamato. |
|
Azure |
Specifica i parametri per la connessione alla risorsa Azure OpenAI. |
|
Azure |
Specifica la risorsa Azure OpenAI usata per vettorializzare una stringa di query. |
|
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
|
Error |
Dettagli dell'errore. |
|
Error |
Risposta di errore |
|
Indexing |
Rappresenta una pianificazione per l'esecuzione dell'indicizzatore. |
|
Input |
Mappatura dei campi di input per una competenza. |
|
Knowledge |
Specifica la risorsa Azure OpenAI usata per eseguire la pianificazione delle query. |
|
Knowledge |
Modello di intelligenza artificiale da utilizzare per la pianificazione delle query. |
|
Knowledge |
Il tipo di fonte di conoscenza. |
|
Output |
Mappatura dei campi di output per una competenza. |
|
Search |
Cancella la proprietà identity di un'origine dati. |
|
Search |
Specifica l'identità da utilizzare per un'origine dati. |
|
Search |
Origine conoscenza destinata a un indice di ricerca. |
|
Search |
Parametri per l'origine della conoscenza dell'indice di ricerca. |
|
Search |
Una chiave di crittografia gestita dal cliente in Azure Key Vault. Le chiavi create e gestite dall'utente possono essere utilizzate per crittografare o decrittografare i dati inattivi, ad esempio indici e mappe di sinonimi. |
|
Vector |
Metodo di vettorizzazione da utilizzare durante la fase di query. |
|
Web |
Specifica le proprietà per la connessione a un vettorizzatore definito dall'utente. |
|
Web |
Specifica un vettorizzatore definito dall'utente per la generazione dell'incorporamento vettoriale di una stringa di query. L'integrazione di un vettorizzatore esterno si ottiene utilizzando l'interfaccia API Web personalizzata di un set di competenze. |
AIFoundryModelCatalogName
Nome del modello di incorporamento dal catalogo di Azure AI Foundry che verrà chiamato.
| Valore | Descrizione |
|---|---|
| OpenAI-CLIP-Image-Text-Embeddings-vit-base-patch32 | |
| OpenAI-CLIP-Image-Text-Embeddings-ViT-Large-Patch14-336 | |
| Facebook-DinoV2-Image-Embeddings-ViT-Base | |
| Facebook-DinoV2-Image-Embeddings-ViT-Giant | |
| Cohere-embed-v3-english | |
| Cohere-embed-v3-multilingual | |
| Cohere-embed-v4 |
Modello di incorporamento coerente v4 per la generazione di incorporamenti da testo e immagini. |
AIServicesVisionParameters
Specifica i parametri di Visione di AI Services per la vettorializzazione di un'immagine o di un testo di query.
| Nome | Tipo | Descrizione |
|---|---|---|
| apiKey |
string |
Chiave API della risorsa AI Services designata. |
| authIdentity | SearchIndexerDataIdentity: |
Identità gestita assegnata dall'utente utilizzata per le connessioni in uscita. Se viene fornito un authResourceId che non viene specificato, viene usata l'identità gestita assegnata dal sistema. Quando si aggiorna l'indice, se l'identità non è specificata, il valore rimane invariato. Se impostato su "none", il valore di questa proprietà viene cancellato. |
| modelVersion |
string |
Versione del modello da usare quando si chiama il servizio Visione artificiale dei servizi di intelligenza artificiale. Per impostazione predefinita, verrà utilizzata l'ultima versione disponibile quando non specificata. |
| resourceUri |
string (uri) |
URI della risorsa Servizi di intelligenza artificiale. |
AIServicesVisionVectorizer
Specifica i parametri di Visione di AI Services per la vettorializzazione di un'immagine o di un testo di query.
| Nome | Tipo | Descrizione |
|---|---|---|
| aiServicesVisionParameters |
Contiene i parametri specifici per l'incorporamento della vettorializzazione di AI Services Vision. |
|
| kind |
string:
ai |
Nome del tipo di metodo di vettorizzazione configurato per l'utilizzo con la ricerca vettoriale. |
| name |
string |
Nome da associare a questo particolare metodo di vettorializzazione. |
AMLParameters
Specifica le proprietà per la connessione a un vettorizzatore AML.
| Nome | Tipo | Descrizione |
|---|---|---|
| key |
string |
(Obbligatorio per l'autenticazione con chiave) La chiave per il servizio AML. |
| modelName |
Nome del modello di incorporamento dal catalogo di Azure AI Foundry distribuito nell'endpoint specificato. |
|
| region |
string |
(Facoltativo per l'autenticazione con token). L'area in cui viene distribuito il servizio AML. |
| resourceId |
string |
(Obbligatorio per l'autenticazione del token). ID risorsa Azure Resource Manager del servizio AML. Deve essere nel formato subscriptions/{guid}/resourceGroups/{resource-group-name}/Microsoft.MachineLearningServices/workspaces/{workspace-name}/services/{service_name}. |
| timeout |
string (duration) |
(Facoltativo) Se specificato, indica il timeout per il client http che effettua la chiamata API. |
| uri |
string (uri) |
(Obbligatorio per l'assenza di autenticazione o per l'autenticazione con chiave) URI di assegnazione dei punteggi del servizio AML a cui verrà inviato il payload JSON. È consentito solo lo schema URI https. |
AMLVectorizer
Specifica un endpoint di Azure Machine Learning distribuito tramite il catalogo dei modelli di Azure AI Foundry per generare l'incorporamento vettoriale di una stringa di query.
| Nome | Tipo | Descrizione |
|---|---|---|
| amlParameters |
Specifica le proprietà del vettorizzatore AML. |
|
| kind |
string:
aml |
Nome del tipo di metodo di vettorizzazione configurato per l'utilizzo con la ricerca vettoriale. |
| name |
string |
Nome da associare a questo particolare metodo di vettorializzazione. |
AzureActiveDirectoryApplicationCredentials
Credenziali di un'applicazione registrata creata per il servizio di ricerca, usata per l'accesso autenticato alle chiavi di crittografia archiviate in Azure Key Vault.
| Nome | Tipo | Descrizione |
|---|---|---|
| applicationId |
string |
Un ID applicazione AAD a cui sono state concesse le autorizzazioni di accesso necessarie per Azure Key Vault che deve essere usato per crittografare i dati inattivi. L'ID applicazione non deve essere confuso con l'ID oggetto per l'applicazione AAD. |
| applicationSecret |
string |
Chiave di autenticazione dell'applicazione AAD specificata. |
AzureBlobKnowledgeSource
Configurazione per l'origine della conoscenza di Archiviazione BLOB di Azure.
| Nome | Tipo | Descrizione |
|---|---|---|
| @odata.etag |
string |
ETag dell'agente. |
| azureBlobParameters |
Tipo di origine della conoscenza. |
|
| description |
string |
Descrizione facoltativa definita dall'utente. |
| encryptionKey |
Descrizione di una chiave di crittografia creata in Azure Key Vault. Questa chiave viene usata per fornire un livello aggiuntivo di crittografia dei dati inattivi per la definizione dell'agente quando si desidera la certezza completa che nessuno, nemmeno Microsoft, possa decrittografarli. Una volta crittografata, la definizione dell'agente rimarrà sempre crittografata. Il servizio di ricerca ignorerà i tentativi di impostare questa proprietà su null. È possibile modificare questa proprietà in base alle esigenze se si desidera ruotare la chiave di crittografia; La definizione dell'agente non sarà interessata. La crittografia con chiavi gestite dal cliente non è disponibile per i servizi di ricerca gratuiti ed è disponibile solo per i servizi a pagamento creati a partire dal 1° gennaio 2019. |
|
| kind |
string:
azure |
Tipo di origine della conoscenza. |
| name |
string |
Il nome dell'origine della conoscenza. |
AzureBlobKnowledgeSourceParameters
Parametri per l'origine della conoscenza di Archiviazione BLOB di Azure.
| Nome | Tipo | Descrizione |
|---|---|---|
| chatCompletionModel | KnowledgeAgentModel: |
Modello di completamento della chat opzionale per la verbalizzazione delle immagini o l'estrazione del contesto. |
| connectionString |
string |
Stringa di connessione basata su chiave o il formato ResourceId se si usa un'identità gestita. |
| containerName |
string |
Nome del contenitore di archiviazione BLOB. |
| createdResources |
object |
Risorse create dall'origine della conoscenza. |
| disableImageVerbalization |
boolean |
Indica se la verbalizzazione dell'immagine deve essere disabilitata. |
| embeddingModel | VectorSearchVectorizer: |
Configurazione vettorizzatore opzionale per la vettorializzazione dei contenuti. |
| folderPath |
string |
Percorso della cartella facoltativo all'interno del contenitore. |
| identity | SearchIndexerDataIdentity: |
Un'identità esplicita da utilizzare per questa fonte di conoscenza. |
| ingestionSchedule |
Pianificazione facoltativa per l'inserimento dei dati. |
AzureOpenAIEmbeddingSkill
Consente di generare un incorporamento vettoriale per un determinato input di testo usando la risorsa Azure OpenAI.
| Nome | Tipo | Descrizione |
|---|---|---|
| @odata.type |
string:
#Microsoft. |
Frammento URI che specifica il tipo di competenza. |
| apiKey |
string |
Chiave API della risorsa Azure OpenAI designata. |
| authIdentity | SearchIndexerDataIdentity: |
Identità gestita assegnata dall'utente utilizzata per le connessioni in uscita. |
| context |
string |
Rappresenta il livello in cui vengono eseguite le operazioni, ad esempio la radice del documento o il contenuto del documento (ad esempio, /document o /document/content). Il valore predefinito è /document. |
| deploymentId |
string |
ID della distribuzione del modello Azure OpenAI nella risorsa designata. |
| description |
string |
La descrizione dell'abilità che descrive gli input, gli output e l'utilizzo dell'abilità. |
| dimensions |
integer (int32) |
Numero di dimensioni che devono essere presenti negli incorporamenti di output risultanti. Supportato solo nei modelli text-embedding-3 e successivi. |
| inputs |
Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza a monte. |
|
| modelName |
Nome del modello di incorporamento distribuito nel percorso deploymentId specificato. |
|
| name |
string |
Il nome della competenza che la identifica in modo univoco all'interno del set di competenze. A un'abilità senza nome definito verrà assegnato un nome predefinito del suo indice in base 1 nell'array di abilità, preceduto dal carattere '#'. |
| outputs |
L'output di una competenza è un campo in un indice di ricerca o un valore che può essere utilizzato come input da un'altra competenza. |
|
| resourceUri |
string (uri) |
URI della risorsa Azure OpenAI. |
AzureOpenAIModelName
Nome del modello Azure Open AI che verrà chiamato.
| Valore | Descrizione |
|---|---|
| text-embedding-ada-002 | |
| text-embedding-3-large | |
| text-embedding-3-small | |
| gpt-4o | |
| gpt-4o-mini | |
| gpt-4.1 | |
| gpt-4.1-mini | |
| gpt-4.1-nano |
AzureOpenAIParameters
Specifica i parametri per la connessione alla risorsa Azure OpenAI.
| Nome | Tipo | Descrizione |
|---|---|---|
| apiKey |
string |
Chiave API della risorsa Azure OpenAI designata. |
| authIdentity | SearchIndexerDataIdentity: |
Identità gestita assegnata dall'utente utilizzata per le connessioni in uscita. |
| deploymentId |
string |
ID della distribuzione del modello Azure OpenAI nella risorsa designata. |
| modelName |
Nome del modello di incorporamento distribuito nel percorso deploymentId specificato. |
|
| resourceUri |
string (uri) |
URI della risorsa Azure OpenAI. |
AzureOpenAIVectorizer
Specifica la risorsa Azure OpenAI usata per vettorializzare una stringa di query.
| Nome | Tipo | Descrizione |
|---|---|---|
| azureOpenAIParameters | AzureOpenAIParameters: |
Contiene i parametri specifici della vettorizzazione di incorporamento di Azure OpenAI. |
| kind |
string:
azure |
Nome del tipo di metodo di vettorizzazione configurato per l'utilizzo con la ricerca vettoriale. |
| name |
string |
Nome da associare a questo particolare metodo di vettorializzazione. |
ErrorAdditionalInfo
Informazioni aggiuntive sull'errore di gestione delle risorse.
| Nome | Tipo | Descrizione |
|---|---|---|
| info |
object |
Informazioni aggiuntive. |
| type |
string |
Tipo di informazioni aggiuntive. |
ErrorDetail
Dettagli dell'errore.
| Nome | Tipo | Descrizione |
|---|---|---|
| additionalInfo |
Informazioni aggiuntive sull'errore. |
|
| code |
string |
Codice di errore. |
| details |
Dettagli dell'errore. |
|
| message |
string |
Messaggio di errore. |
| target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
| Nome | Tipo | Descrizione |
|---|---|---|
| error |
Oggetto error. |
IndexingSchedule
Rappresenta una pianificazione per l'esecuzione dell'indicizzatore.
| Nome | Tipo | Descrizione |
|---|---|---|
| interval |
string (duration) |
Intervallo di tempo tra le esecuzioni dell'indicizzatore. |
| startTime |
string (date-time) |
Ora in cui deve iniziare l'esecuzione di un indicizzatore. |
InputFieldMappingEntry
Mappatura dei campi di input per una competenza.
| Nome | Tipo | Descrizione |
|---|---|---|
| inputs |
Input ricorsivi utilizzati durante la creazione di un tipo complesso. |
|
| name |
string |
Nome dell'input. |
| source |
string |
Origine dell'input. |
| sourceContext |
string |
Contesto di origine utilizzato per la selezione degli input ricorsivi. |
KnowledgeAgentAzureOpenAIModel
Specifica la risorsa Azure OpenAI usata per eseguire la pianificazione delle query.
| Nome | Tipo | Descrizione |
|---|---|---|
| azureOpenAIParameters | AzureOpenAIParameters: |
Contiene i parametri specifici dell'endpoint del modello Azure OpenAI. |
| kind |
string:
azure |
Il tipo di modello di intelligenza artificiale. |
KnowledgeAgentModelKind
Modello di intelligenza artificiale da utilizzare per la pianificazione delle query.
| Valore | Descrizione |
|---|---|
| azureOpenAI |
Usa i modelli di Azure Open AI per la pianificazione delle query. |
KnowledgeSourceKind
Il tipo di fonte di conoscenza.
| Valore | Descrizione |
|---|---|
| searchIndex |
Origine della conoscenza che legge i dati da un indice di ricerca. |
| azureBlob |
Un'origine delle informazioni che legge e inserisce dati da Archiviazione BLOB di Azure in un indice di ricerca. |
OutputFieldMappingEntry
Mappatura dei campi di output per una competenza.
| Nome | Tipo | Descrizione |
|---|---|---|
| name |
string |
Nome dell'output definito dalla competenza. |
| targetName |
string |
Nome di destinazione dell'output. È facoltativo e predefinito per il nome. |
SearchIndexerDataNoneIdentity
Cancella la proprietà identity di un'origine dati.
| Nome | Tipo | Descrizione |
|---|---|---|
| @odata.type |
string:
#Microsoft. |
Frammento di URI che specifica il tipo di identità. |
SearchIndexerDataUserAssignedIdentity
Specifica l'identità da utilizzare per un'origine dati.
| Nome | Tipo | Descrizione |
|---|---|---|
| @odata.type |
string:
#Microsoft. |
Frammento di URI che specifica il tipo di identità. |
| userAssignedIdentity |
string |
L'ID risorsa di Azure completo di un'identità gestita assegnata all'utente, in genere nel formato "/subscriptions/12345678-1234-1234-1234-1234567890ab/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId" che avrebbe dovuto essere assegnato al servizio di ricerca. |
SearchIndexKnowledgeSource
Origine conoscenza destinata a un indice di ricerca.
| Nome | Tipo | Descrizione |
|---|---|---|
| @odata.etag |
string |
ETag dell'agente. |
| description |
string |
Descrizione facoltativa definita dall'utente. |
| encryptionKey |
Descrizione di una chiave di crittografia creata in Azure Key Vault. Questa chiave viene usata per fornire un livello aggiuntivo di crittografia dei dati inattivi per la definizione dell'agente quando si desidera la certezza completa che nessuno, nemmeno Microsoft, possa decrittografarli. Una volta crittografata, la definizione dell'agente rimarrà sempre crittografata. Il servizio di ricerca ignorerà i tentativi di impostare questa proprietà su null. È possibile modificare questa proprietà in base alle esigenze se si desidera ruotare la chiave di crittografia; La definizione dell'agente non sarà interessata. La crittografia con chiavi gestite dal cliente non è disponibile per i servizi di ricerca gratuiti ed è disponibile solo per i servizi a pagamento creati a partire dal 1° gennaio 2019. |
|
| kind |
string:
search |
Tipo di origine della conoscenza. |
| name |
string |
Il nome dell'origine della conoscenza. |
| searchIndexParameters |
Parametri per l'origine della conoscenza. |
SearchIndexKnowledgeSourceParameters
Parametri per l'origine della conoscenza dell'indice di ricerca.
| Nome | Tipo | Descrizione |
|---|---|---|
| searchIndexName |
string |
Nome dell'indice di ricerca. |
| sourceDataSelect |
string |
Utilizzato per richiedere campi aggiuntivi per i dati di origine a cui si fa riferimento. |
SearchResourceEncryptionKey
Una chiave di crittografia gestita dal cliente in Azure Key Vault. Le chiavi create e gestite dall'utente possono essere utilizzate per crittografare o decrittografare i dati inattivi, ad esempio indici e mappe di sinonimi.
| Nome | Tipo | Descrizione |
|---|---|---|
| accessCredentials |
Credenziali facoltative di Azure Active Directory usate per l'accesso ad Azure Key Vault. Non necessario se si usa l'identità gestita. |
|
| identity | SearchIndexerDataIdentity: |
Un'identità gestita esplicita da usare per questa chiave di crittografia. Se non viene specificata e la proprietà delle credenziali di accesso è null, viene usata l'identità gestita assegnata dal sistema. Al momento dell'aggiornamento della risorsa, se l'identità esplicita non è specificata, rimane invariata. Se si specifica "none", il valore di questa proprietà viene cancellato. |
| keyVaultKeyName |
string |
Nome della chiave di Azure Key Vault da usare per crittografare i dati inattivi. |
| keyVaultKeyVersion |
string |
Versione della chiave di Azure Key Vault da usare per crittografare i dati inattivi. |
| keyVaultUri |
string |
URI dell'insieme di credenziali delle chiavi di Azure, noto anche come nome DNS, che contiene la chiave da usare per crittografare i dati inattivi. Un URI di esempio potrebbe essere |
VectorSearchVectorizerKind
Metodo di vettorizzazione da utilizzare durante la fase di query.
| Valore | Descrizione |
|---|---|
| azureOpenAI |
Generare incorporamenti usando una risorsa Azure OpenAI in fase di query. |
| customWebApi |
Genera incorporamenti utilizzando un endpoint Web personalizzato in fase di query. |
| aiServicesVision |
Generare incorporamenti per un'immagine o un input di testo in fase di query usando l'API Vettorizzazione di Visione di Azure AI Services. |
| aml |
Generare incorporamenti usando un endpoint di Azure Machine Learning distribuito tramite il catalogo dei modelli di Azure AI Foundry in fase di query. |
WebApiParameters
Specifica le proprietà per la connessione a un vettorizzatore definito dall'utente.
| Nome | Tipo | Descrizione |
|---|---|---|
| authIdentity | SearchIndexerDataIdentity: |
Identità gestita assegnata dall'utente utilizzata per le connessioni in uscita. Se viene fornito un authResourceId che non viene specificato, viene usata l'identità gestita assegnata dal sistema. Quando si aggiorna l'indicizzatore, se l'identità non è specificata, il valore rimane invariato. Se impostato su "none", il valore di questa proprietà viene cancellato. |
| authResourceId |
string |
Si applica agli endpoint personalizzati che si connettono al codice esterno in una funzione di Azure o in un'altra applicazione che fornisce le trasformazioni. Questo valore deve essere l'ID applicazione creato per la funzione o l'app quando è stata registrata con Azure Active Directory. Se specificata, la vettorizzazione si connette alla funzione o all'app usando un ID gestito (assegnato dal sistema o dall'utente) del servizio di ricerca e il token di accesso della funzione o dell'app, usando questo valore come ID risorsa per la creazione dell'ambito del token di accesso. |
| httpHeaders |
object |
Le intestazioni necessarie per effettuare la richiesta HTTP. |
| httpMethod |
string |
Metodo per la richiesta HTTP. |
| timeout |
string (duration) |
Il timeout desiderato per la richiesta. Il valore predefinito è 30 secondi. |
| uri |
string (uri) |
URI dell'API Web che fornisce il vettorizzatore. |
WebApiVectorizer
Specifica un vettorizzatore definito dall'utente per la generazione dell'incorporamento vettoriale di una stringa di query. L'integrazione di un vettorizzatore esterno si ottiene utilizzando l'interfaccia API Web personalizzata di un set di competenze.
| Nome | Tipo | Descrizione |
|---|---|---|
| customWebApiParameters |
Specifica le proprietà del vettorizzatore definito dall'utente. |
|
| kind |
string:
custom |
Nome del tipo di metodo di vettorizzazione configurato per l'utilizzo con la ricerca vettoriale. |
| name |
string |
Nome da associare a questo particolare metodo di vettorializzazione. |