Merge pull request #377 from MikeAlhayek/patch-1

Fix formatting and add authentication section

Author: v-dirichards

articles/ai-services/openai/references/elasticsearch.md

@@ -36,7 +36,11 @@ The configurable options for Elasticsearch when using Azure OpenAI On Your Data.
 | `strictness` | integer | False | The configured strictness of the search relevance filtering. The higher of strictness, the higher of the precision but lower recall of the answer. Default is `3`.| 
 | `top_n_documents` | integer | False | The configured top number of documents to feature for the configured query. Default is `5`. |
 
-## Key and key ID authentication options
+## Authentication Options
+
+Azure OpenAI On Your Data supports multiple authentication types:
+
+### Key and key ID authentication options
 
 The authentication options for Azure OpenAI On Your Data when using an API key.
 
@@ -46,7 +50,7 @@ The authentication options for Azure OpenAI On Your Data when using an API key.
 | `key_id`|string|True|The Elasticsearch key ID to use for authentication.|
 | `type`|string|True| Must be `key_and_key_id`.|
 
-## Encoded API key authentication options
+### Encoded API key authentication options
 
 The authentication options for Azure OpenAI On Your Data when using an Elasticsearch encoded API key.
 
@@ -74,23 +78,24 @@ The details of the vectorization source, used by Azure OpenAI On Your Data when
 | `authentication`| [ApiKeyAuthenticationOptions](#api-key-authentication-options)|True | Specifies the authentication options to use when retrieving embeddings from the specified endpoint.|
 | `type`|string|True| Must be `endpoint`.|
 
-## Model ID vectorization source
+### API key authentication options
 
-The details of the vectorization source, used by Azure OpenAI On Your Data when applying vector search. This vectorization source is based on Elasticsearch model ID.
+The authentication options for Azure OpenAI On Your Data when using an API key.
 
 |Name | Type | Required | Description |
 |--- | --- | --- | --- |
-| `model_id`|string|True| Specifies the model ID to use for vectorization. This model ID must be defined in Elasticsearch.|
-| `type`|string|True| Must be `model_id`.|
+| `key`|string|True|The API key to use for authentication.|
+| `type`|string|True| Must be `api_key`.|
 
-## API key authentication options
+## Model ID vectorization source
 
-The authentication options for Azure OpenAI On Your Data when using an API key.
+The details of the vectorization source, used by Azure OpenAI On Your Data when applying vector search. This vectorization source is based on Elasticsearch model ID.
 
 |Name | Type | Required | Description |
 |--- | --- | --- | --- |
-| `key`|string|True|The API key to use for authentication.|
-| `type`|string|True| Must be `api_key`.|
+| `model_id`|string|True| Specifies the model ID to use for vectorization. This model ID must be defined in Elasticsearch.|
+| `type`|string|True| Must be `model_id`.|
+
 
 ## Fields mapping options