> 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-es/herramientas-de-ia/facial-recognition.md).

# Reconocimiento facial

La función Personas usa IA para detectar y reconocer rostros en las imágenes y videos de tu unidad. Una vez etiquetadas las personas, puedes encontrar rápidamente todos los activos en los que aparece una persona e incluso combinar su nombre con otros términos de búsqueda para encontrar exactamente el momento que buscas.

### Cómo funciona

Cuando se cargan activos en una unidad, cualquier imagen o video en carpetas indexadas por IA se analiza automáticamente en busca de rostros. Los rostros no identificados (aquellos que aún no están vinculados a un perfil con nombre) se muestran dentro del propio activo, en la **Detalles** pestaña bajo la **Rostros no identificados** sección. Desde ahí puedes crear un perfil usando ese rostro como punto de partida.

La **Personas** vista del panel lateral izquierdo solo muestra a las personas que ya tienen un perfil con nombre. No es una lista de todos los rostros detectados; en cambio, es un directorio de personas etiquetadas.

El reconocimiento facial se aplica por unidad. Los rostros indexados en una unidad no son visibles ni se pueden buscar desde otra.

<figure><img src="https://440362858-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>

### Creación de un perfil

Hay dos maneras de crear un perfil para una persona:

**Desde un activo:** Abre cualquier activo que contenga un rostro no identificado, ve a la **Detalles** pestaña y encuentra el rostro en **Rostros no identificados**. Puedes crear un perfil directamente desde allí, usando automáticamente ese rostro como muestra.

**Desde la vista Personas:** Haz clic en **+ Agregar persona** en la parte superior derecha, luego ingresa un nombre y selecciona manualmente imágenes de muestra.

Sea cual sea el camino que tomes, querrás proporcionar buenas imágenes de muestra:

1. Ingresa un nombre para la persona.
2. Selecciona una o más imágenes de muestra para ayudar al sistema a aprender cómo se ve esta persona.

**Consejos para obtener los mejores resultados:**

* Usa al menos una foto dedicada en la que el rostro de la persona sea claramente visible, no esté obstruido y esté bien iluminado.
* Agregar 2–3 fotos de muestra adicionales mejora significativamente la precisión del reconocimiento, especialmente en distintos ángulos, condiciones de iluminación o períodos de tiempo.
* Evita las muestras en las que el rostro esté parcialmente oculto, en sombra o sea muy pequeño en el encuadre.

Una vez guardado el perfil, el sistema escaneará los activos de tu unidad y mostrará cada instancia en la que aparezca esa persona.

### Búsqueda por persona

Las personas etiquetadas están totalmente integradas en la búsqueda con IA de la unidad. Puedes buscar solo por nombre o combinar un nombre con otros términos descriptivos para refinar aún más los resultados.

Por ejemplo, buscar **"JJ lanzando un balón de fútbol"** devolverá imágenes y videos de JJ realizando específicamente esa acción, no cualquier activo que contenga a JJ, y no cualquier activo de alguien lanzando un balón de fútbol.

Esto facilita encontrar momentos específicos que involucren a personas específicas sin tener que explorar manualmente.

### Cosas a tener en cuenta

* Solo se analizan los activos en carpetas indexadas por IA. Si una carpeta está excluida de la indexación de IA, los rostros de esos activos no aparecerán en la vista Personas.
* Es posible que los activos cargados recientemente no se reflejen de inmediato, ya que la indexación se ejecuta después de la carga.
* La precisión del reconocimiento mejora con más imágenes de muestra y de mejor calidad. Si los resultados parecen incompletos, prueba a agregar muestras adicionales al perfil de la persona.


---

# 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-es/herramientas-de-ia/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.
