> For the complete documentation index, see [llms.txt](https://academy.shade.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.shade.inc/shade-academy/shade-academy-fr/outils-dia/facial-recognition.md).

# Reconnaissance faciale

La fonctionnalité Personnes utilise l’IA pour détecter et reconnaître les visages dans les images et vidéos de votre drive. Une fois les individus étiquetés, vous pouvez retrouver rapidement chaque élément dans lequel une personne apparaît, et même associer son nom à d’autres termes de recherche pour trouver exactement le moment que vous cherchez.

### Comment ça marche

Lorsque des éléments sont téléversés dans un drive, toutes les images ou vidéos présentes dans les dossiers indexés par l’IA sont automatiquement analysées à la recherche de visages. Les visages non identifiés (ceux qui ne sont pas encore liés à un profil nommé) apparaissent dans l’élément lui-même, dans la **Détails** onglet sous la **Visages non identifiés** section. À partir de là, vous pouvez créer un profil en utilisant ce visage comme point de départ.

Le **Personnes** vue dans la barre latérale gauche n’affiche que les individus auxquels un profil nommé a déjà été attribué. Ce n’est pas une liste de tous les visages détectés, mais un annuaire des personnes étiquetées.

La reconnaissance faciale est limitée à chaque drive. Les visages indexés dans un drive ne sont ni visibles ni recherchables depuis un autre.

<figure><img src="https://2926217644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FsT9qLz4apFMh4d3DMksH%2FScreenshot%202026-04-27%20at%205.21.49%E2%80%AFPM%20(2).png?alt=media&amp;token=74ae3a47-042f-43f6-9389-63abf715fc52" alt=""><figcaption></figcaption></figure>

### Créer un profil

Il existe deux façons de créer un profil pour une personne :

**À partir d’un élément :** Ouvrez n’importe quel élément contenant un visage non identifié, allez dans l’ **Détails** onglet, et trouvez le visage sous **Visages non identifiés**. Vous pouvez créer un profil directement depuis là, avec ce visage automatiquement utilisé comme exemple.

**Depuis la vue Personnes :** Cliquez sur **+ Ajouter un individu** en haut à droite, puis saisissez un nom et sélectionnez manuellement des images d’exemple.

Quelle que soit la méthode choisie, il est conseillé de fournir de bonnes images d’exemple :

1. Saisissez un nom pour l’individu.
2. Sélectionnez une ou plusieurs images d’exemple pour aider le système à apprendre à quoi ressemble cette personne.

**Conseils pour de meilleurs résultats :**

* Utilisez au moins une photo dédiée où le visage de la personne est clairement visible, dégagé et bien éclairé.
* Ajouter 2 à 3 photos d’exemple supplémentaires améliore sensiblement la précision de la reconnaissance, surtout avec des angles, des conditions d’éclairage ou des périodes différentes.
* Évitez les exemples où le visage est partiellement caché, dans l’ombre ou très petit dans le cadre.

Une fois le profil enregistré, le système analysera les éléments de votre drive et fera apparaître chaque occurrence où cette personne apparaît.

### Recherche par personne

Les personnes étiquetées sont pleinement intégrées à la recherche IA du drive. Vous pouvez rechercher uniquement par nom, ou associer un nom à d’autres termes descriptifs pour affiner davantage les résultats.

Par exemple, rechercher **« JJ en train de lancer un ballon de football »** renverra des images et vidéos de JJ effectuant précisément cette action, et pas seulement n’importe quel élément contenant JJ, ni n’importe quel élément montrant quelqu’un en train de lancer un ballon de football.

Cela permet de trouver facilement des moments précis impliquant des personnes précises, sans avoir à parcourir manuellement.

### Points à garder à l’esprit

* Seuls les éléments dans les dossiers indexés par l’IA sont analysés. Si un dossier est exclu de l’indexation IA, les visages contenus dans ces éléments n’apparaîtront pas dans la vue Personnes.
* Les éléments nouvellement téléversés peuvent ne pas apparaître immédiatement, car l’indexation s’exécute après le téléversement.
* La précision de la reconnaissance s’améliore avec davantage d’images d’exemple de meilleure qualité. Si les résultats semblent incomplets, essayez d’ajouter des exemples supplémentaires au profil de l’individu.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://academy.shade.inc/shade-academy/shade-academy-fr/outils-dia/facial-recognition.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
