Skip to content

Commit da04ec7

Browse files
committed
Merge branch 'main' of github.com:MicrosoftDocs/azure-ai-docs-pr into release-preview-new-mistral-models
# Conflicts: # articles/ai-studio/how-to/deploy-models-mistral.md
2 parents 6c123ca + 2285acb commit da04ec7

File tree

796 files changed

+3894
-3605
lines changed

Some content is hidden

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

796 files changed

+3894
-3605
lines changed

articles/ai-services/.openpublishing.redirection.ai-services.json

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -775,6 +775,11 @@
775775
"redirect_url": "/azure/ai-services/speech-service/video-translation-get-started",
776776
"redirect_document_id": true
777777
},
778+
{
779+
"source_path_from_root": "/articles/ai-services/speech-service/custom-speech-ai-studio.md",
780+
"redirect_url": "/azure/ai-services/speech-service/custom-speech-ai-foundry-portal",
781+
"redirect_document_id": true
782+
},
778783
{
779784
"source_path_from_root": "/articles/ai-services/qnamaker/how-to/migrate-to-openai.md",
780785
"redirect_url": "/azure/ai-services/qnamaker/overview/overview",
@@ -784,6 +789,11 @@
784789
"source_path_from_root": "/articles/ai-services/language-service/question-answering/how-to/azure-openai-integration.md",
785790
"redirect_url": "/azure/ai-services/language-service/question-answering/overview",
786791
"redirect_document_id": true
792+
},
793+
{
794+
"source_path_from_root": "/articles/ai-services/openai/how-to/integrate-synapseml.md",
795+
"redirect_url": "/azure/ai-services/openai/overview",
796+
"redirect_document_id": true
787797
}
788798
]
789799
}

articles/ai-services/computer-vision/concept-face-detection.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@ ms.custom:
1313
ms.topic: conceptual
1414
ms.date: 09/18/2024
1515
ms.author: pafarley
16+
feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
1617
---
1718

1819
# Face detection, attributes, and input data

articles/ai-services/computer-vision/concept-face-recognition-data-structures.md

Lines changed: 14 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@ ms.custom:
1313
ms.topic: conceptual
1414
ms.date: 11/04/2023
1515
ms.author: pafarley
16+
feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
1617
---
1718

1819
# Face recognition data structures
@@ -42,19 +43,29 @@ The Face Identify API uses container data structures to the hold face recognitio
4243

4344
### Person Directory
4445

45-
**PersonDirectory** is the newest data structure of this kind. It supports a larger scale and higher accuracy. Each Azure Face resource has a single default **PersonDirectory** data structure. It's a flat list of **PersonDirectoryPerson** objects - it can hold up to 75 million.
46+
**PersonDirectory** is the newest data structure of this kind. It supports a larger scale and higher accuracy. Each Azure Face resource has a single default **PersonDirectory** data structure. It's a flat list of **PersonDirectoryPerson** objects - it can hold up to 20 million.
4647

4748
**PersonDirectoryPerson** represents a person to be identified. Updated from the **PersonGroupPerson** model, it allows you to add faces from different recognition models to the same person. However, the Identify operation can only match faces obtained with the same recognition model.
4849

49-
**DynamicPersonGroup** is a lightweight data structure that allows you to dynamically reference a **PersonGroupPerson**. It doesn't require the Train operation: once the data is updated, it's ready to be used with the Identify API.
50+
**DynamicPersonGroup** is a lightweight data structure that allows you to dynamically reference a **PersonDirectoryPerson**. It doesn't require the Train operation: once the data is updated, it's ready to be used with the Identify API.
5051

5152
You can also use an **in-place person ID list** for the Identify operation. This lets you specify a more narrow group to identify from. You can do this manually to improve identification performance in large groups.
5253

5354
The above data structures can be used together. For example:
5455
- In an access control system, The **PersonDirectory** might represent all employees of a company, but a smaller **DynamicPersonGroup** could represent just the employees that have access to a single floor of the building.
5556
- In a flight onboarding system, the **PersonDirectory** could represent all customers of the airline company, but the **DynamicPersonGroup** represents just the passengers on a particular flight. An **in-place person ID list** could represent the passengers who made a last-minute change.
5657

57-
For more details, please refer to the [PersonDirectory how-to guide](./how-to/use-persondirectory.md).
58+
For more details, please refer to the [PersonDirectory how-to guide](./how-to/use-persondirectory.md). A quick comparison between **LargePersonGroup** and **PersonDirectory**:
59+
60+
| Detail | LargePersonGroup | PersonDirectory |
61+
| --- | --- | --- |
62+
| Capacity | A **LargePersonGroup** can hold up to 1 million **PersonGroupPerson** objects. | The collection can store up to 20 millions **PersonDirectoryPerson** identities. |
63+
| PersonURI | `/largepersongroups/{groupId}/persons/{personId}` | `(/v1.0-preview-or-above)/persons/{personId}` |
64+
| Ownership | The **PersonGroupPerson** objects are exclusively owned by the **LargePersonGroup** they belong to. If you want a same identity kept in multiple groups, you will have to [Create Large Person Group Person](/rest/api/face/person-group-operations/create-large-person-group-person) and [Add Large Person Group Person Face](/rest/api/face/person-group-operations/add-large-person-group-person-face) for each group individually, ending up with a set of person IDs in several groups. | The **PersonDirectoryPerson** objects are directly stored inside the **PersonDirectory**, as a flat list. You can use an in-place person ID list to [Identify From Person Directory](/rest/api/face/face-recognition-operations/identify-from-person-directory), or optionally [Create Dynamic Person Group](/rest/api/face/person-directory-operations/create-dynamic-person-group) and hybridly include a person into the group. A created **PersonDirectoryPerson** object can be referenced by multiple **DynamicPersonGroup** without duplication. |
65+
| Model | The recognition model is determined by the **LargePersonGroup**. New faces for all **PersonGroupPerson** objects will become associated with this model when they're added to it. | The **PersonDirectoryPerson** object prepares separated storage per recognition model. You can specify the model when you add new faces, but the Identify API can only match faces obtained with the same recognition model, that is associated with the query faces. |
66+
| Training | You must call the Train API to make any new face/person data reflect in the Identify API results. | There's no need to make Train calls, but API such as [Add Person Face](/rest/api/face/person-directory-operations/add-person-face) becomes a long running operation, which means you should use the response header "Operation-Location" to check if the update completes. |
67+
| Cleanup | [Delete Large Person Group](/rest/api/face/person-group-operations/delete-large-person-group) will also delete the all the **PersonGroupPerson** objects it holds, as well as their face data. | [Delete Dynamic Person Group](/rest/api/face/person-directory-operations/delete-dynamic-person-group) will only unreference the **PersonDirectoryPerson**. To delete actual person and the face data, see [Delete Person](/rest/api/face/person-directory-operations/delete-person). |
68+
5869

5970
## Data structures used with Find Similar
6071

articles/ai-services/computer-vision/concept-face-recognition.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@ ms.custom:
1212
ms.topic: conceptual
1313
ms.date: 10/16/2024
1414
ms.author: pafarley
15+
feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
1516
---
1617

1718
# Face recognition

articles/ai-services/computer-vision/concept-liveness-abuse-monitoring.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,11 +7,13 @@ author: PatrickFarley
77
manager: nitinme
88

99
ms.service: azure-ai-vision
10+
ms.subservice: azure-ai-face
1011
ms.topic: conceptual
1112
ms.date: 11/05/2023
1213
ms.author: pafarley
1314
ms.custom:
1415
- ignite-2023
16+
feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
1517
---
1618

1719
# Abuse monitoring in Face liveness detection

articles/ai-services/computer-vision/enrollment-overview.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ ms.subservice: azure-ai-face
1010
ms.topic: best-practice
1111
ms.date: 02/14/2024
1212
ms.author: pafarley
13+
feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
1314
---
1415

1516
# Best practices for adding users to a Face service

articles/ai-services/computer-vision/how-to/add-faces.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@ ms.date: 02/14/2024
1212
ms.author: pafarley
1313
ms.devlang: csharp
1414
ms.custom: devx-track-csharp
15+
feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
1516
---
1617

1718
# Add faces to a PersonGroup

articles/ai-services/computer-vision/how-to/find-similar-faces.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ ms.subservice: azure-ai-face
1111
ms.topic: how-to
1212
ms.date: 02/14/2024
1313
ms.author: pafarley
14+
feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
1415
---
1516

1617
# Find similar faces

articles/ai-services/computer-vision/how-to/identity-access-token.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ ms.subservice: azure-ai-face
1111
ms.topic: how-to
1212
ms.date: 03/07/2024
1313
ms.author: pafarley
14+
feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
1415
---
1516

1617
# Use limited access tokens for Face

articles/ai-services/computer-vision/how-to/identity-detect-faces.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@ ms.date: 02/14/2024
1313
ms.author: pafarley
1414
ms.devlang: csharp
1515
ms.custom: devx-track-csharp
16+
feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
1617
---
1718

1819
# Call the Detect API

0 commit comments

Comments
 (0)