Skip to content

Commit 35282d4

Browse files
s-pollys-polly
committed
Merge branch 'main' of https://github.com/MicrosoftDocs/azure-ai-docs-pr into stp_trace
2 parents 1a7fa27 + 1cfa5af commit 35282d4

File tree

69 files changed

+207
-210
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

69 files changed

+207
-210
lines changed

‎articles/ai-services/speech-service/voice-live-api-reference.md‎

Lines changed: 8 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1940,8 +1940,9 @@ Configuration for input audio transcription.
19401940
|-------|------|-------------|
19411941
| model | string | The transcription model. Supported: `whisper-1`, `gpt-4o-transcribe`, `gpt-4o-mini-transcribe`, `azure-speech` |
19421942
| language | string | Optional language code in BCP-47 (e.g., `en-US`), or ISO-639-1 (e.g., `en`), or multi languages with auto detection, (e.g., `en,zh`). |
1943-
| custom_speech | object | Optional configuration for custom speech models |
1944-
| phrase_list | string[] | Optional list of phrase hints to bias recognition |
1943+
| custom_speech | object | Optional configuration for custom speech models, only valid for `azure-speech` model. |
1944+
| phrase_list | string[] | Optional list of phrase hints to bias recognition, only valid for `azure-speech` model. |
1945+
| prompt | string | Optional prompt text to guide transcription, only valid for `whisper-1`, `gpt-4o-transcribe`, and `gpt-4o-mini-transcribe` models. |
19451946

19461947
#### RealtimeInputAudioNoiseReductionSettings
19471948

@@ -2080,19 +2081,15 @@ Azure semantic VAD (default variant).
20802081
| languages | string[] | Optional. Supported languages |
20812082
| auto_truncate | boolean | Optional. Auto-truncate on interruption (default: false) |
20822083

2083-
#### RealtimeEOUDetection
2084+
### RealtimeEOUDetection
20842085

2085-
End-of-utterance semantic detection configuration.
2086-
2087-
##### RealtimeAzureSemanticDetection
2088-
2089-
Azure semantic end-of-utterance detection (default).
2086+
Azure End-of-Utterance (EOU) could indicate when the end-user stopped speaking while allowing for natural pauses. End of utterance detection can significantly reduce premature end-of-turn signals without adding user-perceivable latency.
20902087

20912088
| Field | Type | Description |
20922089
|-------|------|-------------|
2093-
| model | string | Must be `"semantic_detection_v1"` |
2094-
| threshold | number | Optional. Detection threshold |
2095-
| timeout | number | Optional. Detection timeout |
2090+
| model | string | Could be `semantic_detection_v1` supporting English or `semantic_detection_v1_multilingual` supporting English, Spanish, French, Italian, German (DE), Japanese, Portuguese, Chinese, Korean, Hindi |
2091+
| threshold_level | string | Optional. Detection threshold level (`low`, `medium`, `high` and `default`), the default is `default` |
2092+
| timeout_ms | number | Maximum time in milliseconds to wait for more user speech. Defaults to 1000 ms. |
20962093

20972094
### Avatar Configuration
20982095

‎articles/machine-learning/how-to-use-mlflow-configure-tracking.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ However, if you work outside Azure Machine Learning, you need to configure MLflo
3535
```
3636

3737
> [!TIP]
38-
> Instead of `mlflow`, consider using [`mlflow-skinny`](https://github.com/mlflow/mlflow/blob/master/skinny/README_SKINNY.md). This package is a lightweight MLflow package without SQL storage, server, UI, or data science dependencies. It's recommended for users who primarily need MLflow tracking and logging capabilities but don't want to import the full suite of features, including deployments.
38+
> Instead of `mlflow`, consider using [`mlflow-skinny`](https://github.com/mlflow/mlflow/blob/master/libs/skinny/README_SKINNY.md). This package is a lightweight MLflow package without SQL storage, server, UI, or data science dependencies. It's recommended for users who primarily need MLflow tracking and logging capabilities but don't want to import the full suite of features, including deployments.
3939
4040
- An Azure Machine Learning workspace. To create a workspace, see [Create resources you need to get started](quickstart-create-resources.md).
4141

‎articles/search/cognitive-search-attach-cognitive-services.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -235,7 +235,7 @@ Enrichments are billable operations. If you no longer need to call Azure AI serv
235235
1. Remove the key in the body of the definition, and then send the request:
236236

237237
```http
238-
PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2024-07-01
238+
PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=@search.rerankerBoostedScore
239239
api-key: [admin key]
240240
Content-Type: application/json
241241
{

‎articles/search/hybrid-search-how-to-query.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -105,7 +105,7 @@ The following example shows a hybrid query request using the REST API.
105105
This example is from the [vector quickstart](https://raw.githubusercontent.com/Azure-Samples/azure-search-rest-samples/refs/heads/main/Quickstart-vectors/az-search-quickstart-vectors.rest) that has vector and nonvector content, and several query examples. For brevity, the vector is truncated in this article.
106106

107107
```http
108-
POST https://{{search-service-name}}.search.windows.net/indexes/{{index-name}}/docs/search?api-version=2024-07-01
108+
POST https://{{search-service-name}}.search.windows.net/indexes/{{index-name}}/docs/search?api-version=@search.rerankerBoostedScore
109109
Content-Type: application/json
110110
api-key: {{admin-api-key}}
111111
{
@@ -240,7 +240,7 @@ This section has multiple query examples that illustrate hybrid query patterns.
240240
This example adds a filter, which is applied to the `filterable` nonvector fields of the search index.
241241

242242
```http
243-
POST https://{{search-service-name}}.search.windows.net/indexes/{{index-name}}/docs/search?api-version=2024-07-01
243+
POST https://{{search-service-name}}.search.windows.net/indexes/{{index-name}}/docs/search?api-version=@search.rerankerBoostedScore
244244
Content-Type: application/json
245245
api-key: {{admin-api-key}}
246246
{
@@ -324,7 +324,7 @@ Assuming that you [have semantic ranker](semantic-how-to-enable-disable.md) and
324324
Whenever you use semantic ranking with vectors, make sure `k` is set to 50. Semantic ranker uses up to 50 matches as input. Specifying less than 50 deprives the semantic ranking models of necessary inputs.
325325

326326
```http
327-
POST https://{{search-service-name}}.search.windows.net/indexes/{{index-name}}/docs/search?api-version=2024-07-01
327+
POST https://{{search-service-name}}.search.windows.net/indexes/{{index-name}}/docs/search?api-version=@search.rerankerBoostedScore
328328
Content-Type: application/json
329329
api-key: {{admin-api-key}}
330330
{
@@ -365,7 +365,7 @@ api-key: {{admin-api-key}}
365365
Here's the last query in the collection. It's the same semantic hybrid query as the previous example, but with a filter.
366366

367367
```http
368-
POST https://{{search-service-name}}.search.windows.net/indexes/{{index-name}}/docs/search?api-version=2024-07-01
368+
POST https://{{search-service-name}}.search.windows.net/indexes/{{index-name}}/docs/search?api-version=@search.rerankerBoostedScore
369369
Content-Type: application/json
370370
api-key: {{admin-api-key}}
371371
{

‎articles/search/hybrid-search-overview.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ Hybrid search is predicated on having a search index that contains fields of var
3434
A representative hybrid query might be as follows (notice that the vector queries have placeholder values for brevity):
3535

3636
```http
37-
POST https://{{searchServiceName}}.search.windows.net/indexes/hotels-vector-quickstart/docs/search?api-version=2024-07-01
37+
POST https://{{searchServiceName}}.search.windows.net/indexes/hotels-vector-quickstart/docs/search?api-version=@search.rerankerBoostedScore
3838
content-type: application/JSON
3939
{
4040
"count": true,

‎articles/search/includes/quickstarts/full-text-powershell.md‎

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -92,7 +92,7 @@ To connect to your search service:
9292
1. Create a `$url` object that targets the indexes collection on your search service. Replace `<YOUR-SEARCH-SERVICE>` with the value you obtained in [Get endpoint](#get-endpoint).
9393
9494
```powershell
95-
$url = "<YOUR-SEARCH-SERVICE>/indexes?api-version=2024-07-01&`$select=name"
95+
$url = "<YOUR-SEARCH-SERVICE>/indexes?api-version=@search.rerankerBoostedScore&`$select=name"
9696
```
9797
9898
1. Run `Invoke-RestMethod` to send a GET request to your search service. Include `ConvertTo-Json` to view responses from the service.
@@ -152,7 +152,7 @@ To create an index:
152152
2. Update the `$url` object to target the new index. Replace `<YOUR-SEARCH-SERVICE>` with the value you obtained in [Get endpoint](#get-endpoint).
153153
154154
```powershell
155-
$url = "<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart?api-version=2024-07-01"
155+
$url = "<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart?api-version=@search.rerankerBoostedScore"
156156
```
157157
158158
3. Run `Invoke-RestMethod` to create the index on your search service.
@@ -275,7 +275,7 @@ To upload documents to your index:
275275
2. Update the `$url` object to target the indexing endpoint. Replace `<YOUR-SEARCH-SERVICE>` with the value you obtained in [Get endpoint](#get-endpoint).
276276
277277
```powershell
278-
$url = "<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart/docs/index?api-version=2024-07-01"
278+
$url = "<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart/docs/index?api-version=@search.rerankerBoostedScore"
279279
```
280280
281281
3. Run `Invoke-RestMethod` to send the upload request to your search service.
@@ -301,7 +301,7 @@ To run a full-text query against your index:
301301
1. Update the `$url` object to specify search parameters. Replace `<YOUR-SEARCH-SERVICE>` with the value you obtained in [Get endpoint](#get-endpoint).
302302
303303
```powershell
304-
$url = '<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart/docs?api-version=2024-07-01&search=attached restaurant&searchFields=Description,Tags&$select=HotelId,HotelName,Tags,Description&$count=true'
304+
$url = '<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart/docs?api-version=@search.rerankerBoostedScore&search=attached restaurant&searchFields=Description,Tags&$select=HotelId,HotelName,Tags,Description&$count=true'
305305
```
306306
307307
2. Run `Invoke-RestMethod` to send the query request to your search service.
@@ -344,20 +344,20 @@ Run the following commands to explore the query syntax. You can perform string s
344344
# Query example 1
345345
# Search the index for the terms 'restaurant' and 'wifi'
346346
# Return only the HotelName, Description, and Tags fields
347-
$url = '<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart/docs?api-version=2024-07-01&search=restaurant wifi&$count=true&$select=HotelName,Description,Tags'
347+
$url = '<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart/docs?api-version=@search.rerankerBoostedScore&search=restaurant wifi&$count=true&$select=HotelName,Description,Tags'
348348
349349
# Query example 2
350350
# Use a filter to find hotels rated 4 or higher
351351
# Return only the HotelName and Rating fields
352-
$url = '<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart/docs?api-version=2024-07-01&search=*&$filter=Rating gt 4&$select=HotelName,Rating'
352+
$url = '<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart/docs?api-version=@search.rerankerBoostedScore&search=*&$filter=Rating gt 4&$select=HotelName,Rating'
353353
354354
# Query example 3
355355
# Take the top two results
356356
# Return only the HotelName and Category fields
357-
$url = '<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart/docs?api-version=2024-07-01&search=boutique&$top=2&$select=HotelName,Category'
357+
$url = '<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart/docs?api-version=@search.rerankerBoostedScore&search=boutique&$top=2&$select=HotelName,Category'
358358
359359
# Query example 4
360360
# Sort by a specific field (Address/City) in ascending order
361361
# Return only the HotelName, Address/City, Tags, and Rating fields
362-
$url = '<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart/docs?api-version=2024-07-01&search=pool&$orderby=Address/City asc&$select=HotelName, Address/City, Tags, Rating'
362+
$url = '<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart/docs?api-version=@search.rerankerBoostedScore&search=pool&$orderby=Address/City asc&$select=HotelName, Address/City, Tags, Rating'
363363
```

‎articles/search/includes/quickstarts/full-text-rest.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -89,7 +89,7 @@ To set up your request file:
8989
@token = PUT-YOUR-PERSONAL-IDENTITY-TOKEN-HERE
9090
9191
### List existing indexes by name
92-
GET {{baseUrl}}/indexes?api-version=2024-07-01 HTTP/1.1
92+
GET {{baseUrl}}/indexes?api-version=@search.rerankerBoostedScore HTTP/1.1
9393
Authorization: Bearer {{token}}
9494
```
9595
@@ -111,7 +111,7 @@ To create an index:
111111
112112
```http
113113
### Create a new index
114-
POST {{baseUrl}}/indexes?api-version=2024-07-01 HTTP/1.1
114+
POST {{baseUrl}}/indexes?api-version=@search.rerankerBoostedScore HTTP/1.1
115115
Content-Type: application/json
116116
Authorization: Bearer {{token}}
117117
@@ -169,7 +169,7 @@ To upload documents to your index:
169169
170170
```http
171171
### Upload documents
172-
POST {{baseUrl}}/indexes/hotels-quickstart/docs/index?api-version=2024-07-01 HTTP/1.1
172+
POST {{baseUrl}}/indexes/hotels-quickstart/docs/index?api-version=@search.rerankerBoostedScore HTTP/1.1
173173
Content-Type: application/json
174174
Authorization: Bearer {{token}}
175175
@@ -275,7 +275,7 @@ To run a full-text query against your index:
275275
276276
```http
277277
### Run a query
278-
POST {{baseUrl}}/indexes/hotels-quickstart/docs/search?api-version=2024-07-01 HTTP/1.1
278+
POST {{baseUrl}}/indexes/hotels-quickstart/docs/search?api-version=@search.rerankerBoostedScore HTTP/1.1
279279
Content-Type: application/json
280280
Authorization: Bearer {{token}}
281281

‎articles/search/includes/quickstarts/search-get-started-rbac-rest.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -75,7 +75,7 @@ To connect using REST:
7575
@token = PUT-YOUR-PERSONAL-IDENTITY-TOKEN-HERE
7676
7777
### List existing indexes
78-
GET {{baseUrl}}/indexes?api-version=2024-07-01 HTTP/1.1
78+
GET {{baseUrl}}/indexes?api-version=@search.rerankerBoostedScore HTTP/1.1
7979
Content-Type: application/json
8080
Authorization: Bearer {{token}}
8181
```

‎articles/search/includes/quickstarts/search-get-started-vector-rest.md‎

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -109,7 +109,7 @@ The index schema in this example is organized around hotel content. Sample data
109109

110110
```http
111111
### Create a new index
112-
POST {{baseUrl}}/indexes?api-version=2024-07-01 HTTP/1.1
112+
POST {{baseUrl}}/indexes?api-version=@search.rerankerBoostedScore HTTP/1.1
113113
Content-Type: application/json
114114
Authorization: Bearer {{token}}
115115
@@ -402,7 +402,7 @@ In Azure AI Search, the index contains all searchable data and queries run on th
402402
403403
```http
404404
### Upload documents
405-
POST {{baseUrl}}/indexes/hotels-quickstart-vectors/docs/index?api-version=2024-07-01 HTTP/1.1
405+
POST {{baseUrl}}/indexes/hotels-quickstart-vectors/docs/index?api-version=@search.rerankerBoostedScore HTTP/1.1
406406
Content-Type: application/json
407407
Authorization: Bearer {{token}}
408408
@@ -673,7 +673,7 @@ The vector query string is semantically similar to the search string, but it inc
673673
674674
```http
675675
### Run a single vector query
676-
POST {{baseUrl}}/indexes/hotels-vector-quickstart/docs/search?api-version=2024-07-01 HTTP/1.1
676+
POST {{baseUrl}}/indexes/hotels-vector-quickstart/docs/search?api-version=@search.rerankerBoostedScore HTTP/1.1
677677
Content-Type: application/json
678678
Authorization: Bearer {{token}}
679679
@@ -784,7 +784,7 @@ You can add filters, but the filters are applied to the nonvector content in you
784784
785785
```http
786786
### Run a vector query with a filter
787-
POST {{baseUrl}}/indexes/hotels-vector-quickstart/docs/search?api-version=2024-07-01 HTTP/1.1
787+
POST {{baseUrl}}/indexes/hotels-vector-quickstart/docs/search?api-version=@search.rerankerBoostedScore HTTP/1.1
788788
Content-Type: application/json
789789
Authorization: Bearer {{token}}
790790
@@ -847,7 +847,7 @@ You can add filters, but the filters are applied to the nonvector content in you
847847
848848
```http
849849
### Run a vector query with a geo filter
850-
POST {{baseUrl}}/indexes/hotels-vector-quickstart/docs/search?api-version=2024-07-01 HTTP/1.1
850+
POST {{baseUrl}}/indexes/hotels-vector-quickstart/docs/search?api-version=@search.rerankerBoostedScore HTTP/1.1
851851
Content-Type: application/json
852852
Authorization: Bearer {{token}}
853853
@@ -917,7 +917,7 @@ Hybrid search consists of keyword queries and vector queries in a single search
917917
918918
```http
919919
### Run a hybrid query
920-
POST {{baseUrl}}/indexes/hotels-vector-quickstart/docs/search?api-version=2024-07-01 HTTP/1.1
920+
POST {{baseUrl}}/indexes/hotels-vector-quickstart/docs/search?api-version=@search.rerankerBoostedScore HTTP/1.1
921921
Content-Type: application/json
922922
Authorization: Bearer {{token}}
923923
@@ -1033,7 +1033,7 @@ Here's the last query in the collection. This hybrid query adds L2 semantic rank
10331033
10341034
```http
10351035
### Run a hybrid query with semantic reranking
1036-
POST {{baseUrl}}/indexes/hotels-vector-quickstart/docs/search?api-version=2024-07-01 HTTP/1.1
1036+
POST {{baseUrl}}/indexes/hotels-vector-quickstart/docs/search?api-version=@search.rerankerBoostedScore HTTP/1.1
10371037
Content-Type: application/json
10381038
Authorization: Bearer {{token}}
10391039
@@ -1127,7 +1127,7 @@ If you want to keep the search service, but delete the index and documents, you
11271127
11281128
```http
11291129
### Delete an index
1130-
DELETE {{baseUrl}}/indexes/hotels-vector-quickstart?api-version=2024-07-01 HTTP/1.1
1130+
DELETE {{baseUrl}}/indexes/hotels-vector-quickstart?api-version=@search.rerankerBoostedScore HTTP/1.1
11311131
Content-Type: application/json
11321132
Authorization: Bearer {{token}}
11331133
```

‎articles/search/includes/tutorials/skillset-rest.md‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -97,7 +97,7 @@ Call [Create Data Source](/rest/api/searchservice/data-sources/create) to set th
9797
9898
```http
9999
### Create a data source
100-
POST {{baseUrl}}/datasources?api-version=2024-07-01 HTTP/1.1
100+
POST {{baseUrl}}/datasources?api-version=@search.rerankerBoostedScore HTTP/1.1
101101
Content-Type: application/json
102102
api-key: {{apiKey}}
103103
@@ -124,7 +124,7 @@ Call [Create Skillset](/rest/api/searchservice/skillsets/create) to specify whic
124124

125125
```http
126126
### Create a skillset
127-
POST {{baseUrl}}/skillsets?api-version=2024-07-01 HTTP/1.1
127+
POST {{baseUrl}}/skillsets?api-version=@search.rerankerBoostedScore HTTP/1.1
128128
Content-Type: application/json
129129
api-key: {{apiKey}}
130130
@@ -313,7 +313,7 @@ The largest component of an index is the fields collection, where data type and
313313

314314
```http
315315
### Create an index
316-
POST {{baseUrl}}/indexes?api-version=2024-07-01 HTTP/1.1
316+
POST {{baseUrl}}/indexes?api-version=@search.rerankerBoostedScore HTTP/1.1
317317
Content-Type: application/json
318318
api-key: {{apiKey}}
319319
@@ -406,7 +406,7 @@ Expect this step to take several minutes to complete. Even though the data set i
406406

407407
```http
408408
### Create and run an indexer
409-
POST {{baseUrl}}/indexers?api-version=2024-07-01 HTTP/1.1
409+
POST {{baseUrl}}/indexers?api-version=@search.rerankerBoostedScore HTTP/1.1
410410
Content-Type: application/json
411411
api-key: {{apiKey}}
412412
@@ -497,7 +497,7 @@ To find out whether the indexer is still running, call [Get Indexer Status](/res
497497

498498
```http
499499
### Get Indexer Status (wait several minutes for the indexer to complete)
500-
GET {{baseUrl}}/indexers/cog-search-demo-idxr/status?api-version=2024-07-01 HTTP/1.1
500+
GET {{baseUrl}}/indexers/cog-search-demo-idxr/status?api-version=@search.rerankerBoostedScore HTTP/1.1
501501
Content-Type: application/json
502502
api-key: {{apiKey}}
503503
```
@@ -514,7 +514,7 @@ Now that you've created an index that contains AI-generated content, call [Searc
514514

515515
```http
516516
### Query the index\
517-
POST {{baseUrl}}/indexes/cog-search-demo-idx/docs/search?api-version=2024-07-01 HTTP/1.1
517+
POST {{baseUrl}}/indexes/cog-search-demo-idx/docs/search?api-version=@search.rerankerBoostedScore HTTP/1.1
518518
Content-Type: application/json
519519
api-key: {{apiKey}}
520520
@@ -529,7 +529,7 @@ Filters can help you narrow results to items of interest:
529529

530530
```http
531531
### Filter by organization
532-
POST {{baseUrl}}/indexes/cog-search-demo-idx/docs/search?api-version=2024-07-01 HTTP/1.1
532+
POST {{baseUrl}}/indexes/cog-search-demo-idx/docs/search?api-version=@search.rerankerBoostedScore HTTP/1.1
533533
Content-Type: application/json
534534
api-key: {{apiKey}}
535535

0 commit comments

Comments
 (0)