> ## Documentation Index
> Fetch the complete documentation index at: https://docs.payana.la/llms.txt
> Use this file to discover all available pages before exploring further.

# Agente de etiquetado

> El agente aplica automáticamente una o varias etiquetas de tu catálogo a cada documento, para que tu operación quede organizada y fácil de filtrar sin trabajo manual

<Info>
  **Nuevo.** El agente de etiquetado llegó con la última versión de Payana. Es parte de la familia de [agentes de decisión](/agentes/introduccion-agentes-decision).
</Info>

El **agente de etiquetado** asume el rol de una persona en un paso de **etiquetado**: lee cada documento y le aplica **una o varias etiquetas** de tu catálogo, para que quede organizado y sea fácil de buscar, filtrar y agrupar. A diferencia de la clasificación, el etiquetado **no cambia el camino** del documento en el flujo: es una capa de organización.

Es el único agente de decisión que puede tomar **varias decisiones sobre el mismo documento** (varias etiquetas a la vez), y por eso su experiencia tiene algunos detalles propios.

<Frame caption="El agente de etiquetado en acción: al abrir la tarea «Etiquetar», el desplegable ya trae marcada la etiqueta que sugirió el agente (con el ícono de destello) —aquí «Centro de Costos 1»— lista para confirmarse con un clic.">
  <img src="https://mintcdn.com/payana/ciZIXW9SReB7Uh7w/images/agentes/etiquetado-en-accion.gif?s=fbddff2fd86fc7fa0af915943dcaaeb8" alt="Tarea de etiquetado con la etiqueta sugerida por el agente marcada en el desplegable" width="1024" height="640" data-path="images/agentes/etiquetado-en-accion.gif" />
</Frame>

## Cerrado a tu catálogo: el agente nunca inventa etiquetas

El agente solo puede usar etiquetas que **ya existen** en tu empresa. Nunca crea etiquetas nuevas. Tú defines el conjunto disponible:

* Si en el paso eliges un **conjunto de etiquetas** (`tag_set`), el agente solo puede usar esas.
* Si no eliges ninguna, el agente puede usar **cualquier etiqueta activa** de tu empresa.

Crear etiquetas nuevas sigue siendo una acción humana, desde la configuración de tu empresa.

<Frame caption="La sección «Etiquetas disponibles»: limita el conjunto de etiquetas que el paso puede aplicar.">
  <img src="https://mintcdn.com/payana/ciZIXW9SReB7Uh7w/images/agentes/etiquetado-conjunto.png?fit=max&auto=format&n=ciZIXW9SReB7Uh7w&q=85&s=fa1017b99cd8b79893d1e98315177406" alt="Sección Etiquetas disponibles de un paso de etiquetado" width="421" height="164" data-path="images/agentes/etiquetado-conjunto.png" />
</Frame>

## Paso 1: Escribe tu política de etiquetado

La política le dice al agente **qué etiquetas aplicar y cuándo**:

```text theme={null}
Etiquetado de facturas:

- Aplica "Recurrente" si el proveedor emite facturas todos los meses (arriendo, servicios, software).
- Aplica "Urgente" si la fecha de vencimiento es en menos de 5 días.
- Aplica "Revisar IVA" si la factura tiene más de un tipo de IVA.
- Aplica la etiqueta de la sede ("Bogotá", "Medellín", "Cali") según la dirección del proveedor.

Un documento puede llevar varias etiquetas a la vez. No apliques etiquetas de las que no estés seguro.
```

<Tip>
  Como el etiquetado es multi-etiqueta, conviene ser claro sobre cuándo aplicar cada una por separado. El agente puede aplicar varias a la vez o ninguna, según lo que diga tu política.
</Tip>

Aprende a escribir buenas políticas en [Políticas de paso](/flujos/politicas).

## Paso 2: Activa el agente y elige su modo

En la sección **Agente IA** del paso de etiquetado, enciende el agente y elige cómo trabaja:

* **Solo recomendar** — el agente sugiere etiquetas, pero una persona confirma cuáles aplicar.
* **Recomendar y ejecutar** — el agente aplica solo las etiquetas en las que tiene confianza suficiente.

<Frame caption="La tarjeta Agente IA de un paso de etiquetado, con su interruptor y selector de modo.">
  <img src="https://mintcdn.com/payana/ciZIXW9SReB7Uh7w/images/agentes/etiquetado-agente-modo.png?fit=max&auto=format&n=ciZIXW9SReB7Uh7w&q=85&s=b4b386ca5084d2119322fdb4e4e5b5a0" alt="Tarjeta Agente IA de un paso de etiquetado" width="421" height="154" data-path="images/agentes/etiquetado-agente-modo.png" />
</Frame>

## Cómo trabaja con varias etiquetas

Aquí está lo particular del etiquetado. El agente evalúa **cada etiqueta por separado**, con su propia confianza:

* **En modo recomendar y ejecutar:** aplica automáticamente las etiquetas de **alta confianza**. Las etiquetas de **baja confianza** no se pierden: quedan como **sugerencias pasivas** en el documento, listas para que una persona las acepte con un clic (sin generar una tarea).
* **Si ninguna etiqueta le da confianza suficiente:** no aplica nada y escala el documento a una persona, con las sugeridas prellenadas.
* **En modo solo recomendar:** no aplica ninguna automáticamente; deja todas como sugerencias para que una persona elija.

<Frame caption="En el detalle del documento, la sección «Etiquetas sugeridas por el agente» muestra las etiquetas propuestas como chips. El color refleja la confianza: en azul, alta confianza.">
  <img src="https://mintcdn.com/payana/ciZIXW9SReB7Uh7w/images/agentes/etiquetado-chips-sugeridas.png?fit=max&auto=format&n=ciZIXW9SReB7Uh7w&q=85&s=930544f099f2789bd5c8e2561a1cd04b" alt="Chips de etiquetas sugeridas por el agente en el detalle del documento" width="323" height="48" data-path="images/agentes/etiquetado-chips-sugeridas.png" />
</Frame>

<Note>
  Las etiquetas sugeridas no aplicadas aparecen como **chips pasivos** en el documento: no generan una tarea ni bloquean el flujo. Son una invitación, no una obligación. Aceptarlas es tan simple como hacer clic. Ver [Revisar tareas de agentes](/documentos/revisar-tareas-agentes#etiquetas-sugeridas).
</Note>

## Etiquetado vs. clasificación

Es la confusión más común, así que vale la pena separarlas:

|                              | Clasificación                      | Etiquetado                           |
| ---------------------------- | ---------------------------------- | ------------------------------------ |
| ¿Cuántos valores?            | **Uno** (un valor de un campo)     | **Varios** (varias etiquetas)        |
| ¿Cambia el camino del flujo? | **Sí**, enruta por la categoría    | **No**, solo organiza                |
| ¿Para qué sirve?             | Decidir el recorrido del documento | Buscar, filtrar y agrupar documentos |

Ver [Agente de clasificación](/agentes/agente-clasificacion) y [Campos personalizados](/flujos/campos-personalizados).

## Qué pasa cuando el agente se detiene

Si el agente no tiene confianza en ninguna etiqueta, no aplica nada por su cuenta: escala el documento a una persona con las sugerencias visibles. Nada se etiqueta automáticamente sin confianza suficiente, y una etiqueta aplicada por el agente siempre puede ajustarse manualmente después.

<Note>
  El etiquetado combina muy bien con el resto del flujo: puedes etiquetar documentos por sede, urgencia o tipo, y luego filtrar por esas etiquetas en el listado de documentos para dar seguimiento. Ver [Flujos de documentos](/documentos/flujos-personalizados).
</Note>