|
6143 | 6143 | "items": { |
6144 | 6144 | "$ref": "#/definitions/VectorSearchAlgorithmConfiguration" |
6145 | 6145 | }, |
6146 | | - "description": "Contains configuration options specific to the algorithm used during indexing and/or querying." |
| 6146 | + "description": "Contains configuration options specific to the algorithm used during indexing or querying." |
6147 | 6147 | }, |
6148 | 6148 | "vectorizers": { |
6149 | 6149 | "type": "array", |
|
6205 | 6205 | "name", |
6206 | 6206 | "kind" |
6207 | 6207 | ], |
6208 | | - "description": "Contains configuration options specific to the algorithm used during indexing and/or querying." |
| 6208 | + "description": "Contains configuration options specific to the algorithm used during indexing or querying." |
6209 | 6209 | }, |
6210 | 6210 | "HnswVectorSearchAlgorithmConfiguration": { |
6211 | 6211 | "type": "object", |
|
6219 | 6219 | "hnswParameters": { |
6220 | 6220 | "x-ms-client-name": "Parameters", |
6221 | 6221 | "$ref": "#/definitions/HnswParameters", |
6222 | | - "description": "Contains the parameters specific to hnsw algorithm." |
| 6222 | + "description": "Contains the parameters specific to HNSW algorithm." |
6223 | 6223 | } |
6224 | 6224 | }, |
6225 | | - "description": "Contains configuration options specific to the hnsw approximate nearest neighbors algorithm used during indexing and querying. The hnsw algorithm offers a tunable trade-off between search speed and accuracy." |
| 6225 | + "description": "Contains configuration options specific to the HNSW approximate nearest neighbors algorithm used during indexing and querying. The HNSW algorithm offers a tunable trade-off between search speed and accuracy." |
6226 | 6226 | }, |
6227 | 6227 | "HnswParameters": { |
6228 | 6228 | "type": "object", |
|
6260 | 6260 | "description": "The similarity metric to use for vector comparisons." |
6261 | 6261 | } |
6262 | 6262 | }, |
6263 | | - "description": "Contains the parameters specific to hnsw algorithm." |
| 6263 | + "description": "Contains the parameters specific to the HNSW algorithm." |
6264 | 6264 | }, |
6265 | 6265 | "ExhaustiveKnnVectorSearchAlgorithmConfiguration": { |
6266 | 6266 | "type": "object", |
|
6330 | 6330 | { |
6331 | 6331 | "value": "hnsw", |
6332 | 6332 | "name": "Hnsw", |
6333 | | - "description": "Hnsw (Hierarchical Navigable Small World), a type of approximate nearest neighbors algorithm." |
| 6333 | + "description": "HNSW (Hierarchical Navigable Small World), a type of approximate nearest neighbors algorithm." |
6334 | 6334 | }, |
6335 | 6335 | { |
6336 | 6336 | "value": "exhaustiveKnn", |
|
6363 | 6363 | "name", |
6364 | 6364 | "kind" |
6365 | 6365 | ], |
6366 | | - "description": "Contains specific details for a vectorization method to be used during query time." |
| 6366 | + "description": "Specifies the vectorization method to be used during query time." |
6367 | 6367 | }, |
6368 | 6368 | "AzureOpenAIVectorizer": { |
6369 | 6369 | "type": "object", |
|
6377 | 6377 | "azureOpenAIParameters": { |
6378 | 6378 | "x-ms-client-name": "AzureOpenAIParameters", |
6379 | 6379 | "$ref": "#/definitions/AzureOpenAIParameters", |
6380 | | - "description": "Contains the parameters specific to Azure Open AI embedding vectorization." |
| 6380 | + "description": "Contains the parameters specific to Azure OpenAI embedding vectorization." |
6381 | 6381 | } |
6382 | 6382 | }, |
6383 | | - "description": "Contains the parameters specific to using an Azure Open AI service for vectorization at query time." |
| 6383 | + "description": "Specifies the Azure OpenAI resource used to vectorize a query string." |
6384 | 6384 | }, |
6385 | 6385 | "AzureOpenAIParameters": { |
6386 | 6386 | "type": "object", |
6387 | 6387 | "properties": { |
6388 | 6388 | "resourceUri": { |
6389 | 6389 | "type": "string", |
6390 | 6390 | "format": "uri", |
6391 | | - "description": "The resource uri for your Azure Open AI resource." |
| 6391 | + "description": "The resource URI of the Azure OpenAI resource." |
6392 | 6392 | }, |
6393 | 6393 | "deploymentId": { |
6394 | 6394 | "type": "string", |
6395 | | - "description": "ID of your Azure Open AI model deployment on the designated resource." |
| 6395 | + "description": "ID of the Azure OpenAI model deployment on the designated resource." |
6396 | 6396 | }, |
6397 | 6397 | "apiKey": { |
6398 | 6398 | "type": "string", |
6399 | | - "description": "API key for the designated Azure Open AI resource." |
| 6399 | + "description": "API key of the designated Azure OpenAI resource." |
6400 | 6400 | }, |
6401 | 6401 | "authIdentity": { |
6402 | 6402 | "$ref": "#/definitions/SearchIndexerDataIdentity", |
6403 | 6403 | "x-nullable": true, |
6404 | 6404 | "description": "The user-assigned managed identity used for outbound connections." |
6405 | 6405 | } |
6406 | 6406 | }, |
6407 | | - "description": "Contains the parameters specific to using an Azure Open AI service for vectorization at query time." |
| 6407 | + "description": "Specifies the parameters for connecting to the Azure OpenAI resource." |
6408 | 6408 | }, |
6409 | 6409 | "CustomVectorizer": { |
6410 | 6410 | "type": "object", |
|
6418 | 6418 | "customVectorizerParameters": { |
6419 | 6419 | "x-ms-client-name": "CustomVectorizerParameters", |
6420 | 6420 | "$ref": "#/definitions/CustomVectorizerParameters", |
6421 | | - "description": "Contains the parameters specific to generating vector embeddings via a custom endpoint." |
| 6421 | + "description": "Specifies the properties of the user-defined vectorizer." |
6422 | 6422 | } |
6423 | 6423 | }, |
6424 | | - "description": "Contains the parameters specific to generating vector embeddings via a custom endpoint." |
| 6424 | + "description": "Specifies a user-defined vectorizer for generating the vector embedding of a query string. Integration of an external vectorizer is achieved using the custom Web API interface of a skillset." |
6425 | 6425 | }, |
6426 | 6426 | "CustomVectorizerParameters": { |
6427 | 6427 | "type": "object", |
6428 | 6428 | "properties": { |
6429 | 6429 | "uri": { |
6430 | 6430 | "type": "string", |
6431 | 6431 | "format": "uri", |
6432 | | - "description": "The uri for the Web API." |
| 6432 | + "description": "The URI of the Web API providing the vectorizer." |
6433 | 6433 | }, |
6434 | 6434 | "httpHeaders": { |
6435 | 6435 | "$ref": "#/definitions/WebApiHttpHeaders", |
6436 | | - "description": "The headers required to make the http request." |
| 6436 | + "description": "The headers required to make the HTTP request." |
6437 | 6437 | }, |
6438 | 6438 | "httpMethod": { |
6439 | 6439 | "type": "string", |
6440 | | - "description": "The method for the http request." |
| 6440 | + "description": "The method for the HTTP request." |
6441 | 6441 | }, |
6442 | 6442 | "timeout": { |
6443 | 6443 | "type": "string", |
|
6455 | 6455 | "description": "The user-assigned managed identity used for outbound connections. If an authResourceId is provided and it's not specified, the system-assigned managed identity is used. On updates to the indexer, if the identity is unspecified, the value remains unchanged. If set to \"none\", the value of this property is cleared." |
6456 | 6456 | } |
6457 | 6457 | }, |
6458 | | - "description": "Contains the parameters specific to generating vector embeddings via a custom endpoint." |
| 6458 | + "description": "Specifies the properties for connecting to a user-defined vectorizer." |
6459 | 6459 | }, |
6460 | 6460 | "VectorSearchVectorizerKind": { |
6461 | 6461 | "type": "string", |
|
6470 | 6470 | { |
6471 | 6471 | "value": "azureOpenAI", |
6472 | 6472 | "name": "AzureOpenAI", |
6473 | | - "description": "Generate embeddings using an Azure Open AI service at query time." |
| 6473 | + "description": "Generate embeddings using an Azure OpenAI resource at query time." |
6474 | 6474 | }, |
6475 | 6475 | { |
6476 | 6476 | "value": "customWebApi", |
|
8604 | 8604 | ] |
8605 | 8605 | }, |
8606 | 8606 | "CognitiveServicesAccountKey": { |
8607 | | - "description": "An Azure AI service resource provisioned with a key that is attached to a skillset.", |
| 8607 | + "description": "The multi-region account key of an Azure AI service resource that's attached to a skillset.", |
8608 | 8608 | "x-ms-discriminator-value": "#Microsoft.Azure.Search.CognitiveServicesByKey", |
8609 | 8609 | "allOf": [ |
8610 | 8610 | { |
|
9462 | 9462 | "resourceUri": { |
9463 | 9463 | "type": "string", |
9464 | 9464 | "format": "uri", |
9465 | | - "description": "The resource uri for your Azure Open AI resource." |
| 9465 | + "description": "The resource URI for your Azure OpenAI resource." |
9466 | 9466 | }, |
9467 | 9467 | "deploymentId": { |
9468 | 9468 | "type": "string", |
9469 | | - "description": "ID of your Azure Open AI model deployment on the designated resource." |
| 9469 | + "description": "ID of your Azure OpenAI model deployment on the designated resource." |
9470 | 9470 | }, |
9471 | 9471 | "apiKey": { |
9472 | 9472 | "type": "string", |
9473 | | - "description": "API key for the designated Azure Open AI resource." |
| 9473 | + "description": "API key for the designated Azure OpenAI resource." |
9474 | 9474 | }, |
9475 | 9475 | "authIdentity": { |
9476 | 9476 | "$ref": "#/definitions/SearchIndexerDataIdentity", |
9477 | 9477 | "x-nullable": true, |
9478 | 9478 | "description": "The user-assigned managed identity used for outbound connections." |
9479 | 9479 | } |
9480 | 9480 | }, |
9481 | | - "description": "Allows you to generate a vector embedding for a given text input using the Azure Open AI service." |
| 9481 | + "description": "Allows you to generate a vector embedding for a given text input using the Azure OpenAI resource." |
9482 | 9482 | }, |
9483 | 9483 | "ListSkillsetsResult": { |
9484 | 9484 | "properties": { |
|
0 commit comments