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.

sourceName
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

ErrorResponse

Risposta di errore.

Esempio

SearchServiceGetKnowledgeSource
SearchServiceGetKnowledgeSourceAzureBlob

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
AIFoundryModelCatalogName

Nome del modello di incorporamento dal catalogo di Azure AI Foundry che verrà chiamato.

AIServicesVisionParameters

Specifica i parametri di Visione di AI Services per la vettorializzazione di un'immagine o di un testo di query.

AIServicesVisionVectorizer

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.

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.

AzureBlobKnowledgeSource

Configurazione per l'origine della conoscenza di Archiviazione BLOB di Azure.

AzureBlobKnowledgeSourceParameters

Parametri per l'origine della conoscenza di Archiviazione BLOB di Azure.

AzureOpenAIEmbeddingSkill

Consente di generare un incorporamento vettoriale per un determinato input di testo usando la risorsa Azure OpenAI.

AzureOpenAIModelName

Nome del modello Azure Open AI che verrà chiamato.

AzureOpenAIParameters

Specifica i parametri per la connessione alla risorsa Azure OpenAI.

AzureOpenAIVectorizer

Specifica la risorsa Azure OpenAI usata per vettorializzare una stringa di query.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

IndexingSchedule

Rappresenta una pianificazione per l'esecuzione dell'indicizzatore.

InputFieldMappingEntry

Mappatura dei campi di input per una competenza.

KnowledgeAgentAzureOpenAIModel

Specifica la risorsa Azure OpenAI usata per eseguire la pianificazione delle query.

KnowledgeAgentModelKind

Modello di intelligenza artificiale da utilizzare per la pianificazione delle query.

KnowledgeSourceKind

Il tipo di fonte di conoscenza.

OutputFieldMappingEntry

Mappatura dei campi di output per una competenza.

SearchIndexerDataNoneIdentity

Cancella la proprietà identity di un'origine dati.

SearchIndexerDataUserAssignedIdentity

Specifica l'identità da utilizzare per un'origine dati.

SearchIndexKnowledgeSource

Origine conoscenza destinata a un indice di ricerca.

SearchIndexKnowledgeSourceParameters

Parametri per l'origine della conoscenza dell'indice di ricerca.

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.

VectorSearchVectorizerKind

Metodo di vettorizzazione da utilizzare durante la fase di query.

WebApiParameters

Specifica le proprietà per la connessione a un vettorizzatore definito dall'utente.

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.

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

AIServicesVisionParameters

Contiene i parametri specifici per l'incorporamento della vettorializzazione di AI Services Vision.

kind string:

aiServicesVision

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

AIFoundryModelCatalogName

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

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

AzureBlobKnowledgeSourceParameters

Tipo di origine della conoscenza.

description

string

Descrizione facoltativa definita dall'utente.

encryptionKey

SearchResourceEncryptionKey

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:

azureBlob

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:

KnowledgeAgentAzureOpenAIModel

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

IndexingSchedule

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.Skills.Text.AzureOpenAIEmbeddingSkill

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

InputFieldMappingEntry[]

Gli input delle competenze possono essere una colonna nel set di dati di origine o l'output di una competenza a monte.

modelName

AzureOpenAIModelName

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

OutputFieldMappingEntry[]

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

AzureOpenAIModelName

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:

AzureOpenAIEmbeddingSkill

Contiene i parametri specifici della vettorizzazione di incorporamento di Azure OpenAI.

kind string:

azureOpenAI

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

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

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

InputFieldMappingEntry[]

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:

AzureOpenAIEmbeddingSkill

Contiene i parametri specifici dell'endpoint del modello Azure OpenAI.

kind string:

azureOpenAI

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.Azure.Search.DataNoneIdentity

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.Azure.Search.DataUserAssignedIdentity

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

SearchResourceEncryptionKey

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:

searchIndex

Tipo di origine della conoscenza.

name

string

Il nome dell'origine della conoscenza.

searchIndexParameters

SearchIndexKnowledgeSourceParameters

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

AzureActiveDirectoryApplicationCredentials

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 https://my-keyvault-name.vault.azure.net.

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

WebApiParameters

Specifica le proprietà del vettorizzatore definito dall'utente.

kind string:

customWebApi

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.