> ## 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.

# Agentes de decisión

> Agentes que asumen el rol de una persona en un paso del flujo: leen el documento, aplican tu política y deciden — recomendando o actuando solos, siempre mostrando su razonamiento

Un **agente de decisión** es un asistente de IA que asume el rol de una persona en **un paso** de tu flujo y elige dentro de un conjunto acotado de opciones. No improvisa ni inventa: decide siguiendo la **política** que tú escribiste, y siempre muestra su razonamiento y qué tan seguro está.

Hoy Payana tiene cuatro agentes de decisión, y todos funcionan bajo la misma lógica:

| Agente                                         | En qué paso trabaja | Qué decide                                                |
| ---------------------------------------------- | ------------------- | --------------------------------------------------------- |
| [Clasificación](/agentes/agente-clasificacion) | Clasificación       | Un valor del campo (por ejemplo, el *Área* del documento) |
| [Aprobación](/agentes/agente-aprobacion)       | Aprobación          | Aprobar o rechazar                                        |
| [Etiquetado](/agentes/agente-etiquetado)       | Etiquetado          | Una o varias etiquetas del catálogo                       |
| [Causación](/documentos/agente-causacion)      | Causación           | Cómo causar el documento en tu ERP                        |

<Frame caption="Una decisión de agente de principio a fin: el documento llega a un paso con agente activo, el agente muestra su recomendación con el razonamiento, y una persona la revisa y confirma.">
  <img src="https://mintcdn.com/payana/ciZIXW9SReB7Uh7w/images/agentes/agente-decision-overview.gif?s=50ed016269b04bbd37f3c503a75268a0" alt="Un agente de decisión recomendando y una persona confirmando" width="1200" height="675" data-path="images/agentes/agente-decision-overview.gif" />
</Frame>

<Note>
  Como todos comparten la misma mecánica, cuando aprendes a usar uno, ya sabes usar los demás. Cambia **qué decide** cada uno; el resto (activarlo, elegir su modo, leer su confianza, revisar sus decisiones) es idéntico.
</Note>

## Las dos piezas: el interruptor y la política

Un agente se controla con dos cosas, ambas en la sección **Agente IA** del paso:

<CardGroup cols={2}>
  <Card title="El interruptor (on/off)" icon="toggle-on">
    Activa o desactiva el agente en ese paso. Apagado, el paso lo ejecutan solo personas. Encendido, el agente entra a trabajar.
  </Card>

  <Card title="El modo" icon="sliders">
    Define hasta dónde puede llegar el agente: **solo recomendar** o **recomendar y ejecutar**. Lo ves abajo.
  </Card>
</CardGroup>

Y por fuera de esa sección, la **[política del paso](/flujos/politicas)** define el criterio: qué debe decidir y en qué casos puede actuar solo.

<Frame caption="La sección Agente IA de un paso: el interruptor para activarlo y el selector de modo.">
  <img src="https://mintcdn.com/payana/ciZIXW9SReB7Uh7w/images/agentes/seccion-agente-ia.png?fit=max&auto=format&n=ciZIXW9SReB7Uh7w&q=85&s=0e9f88bed7909a5993d43ac1f3c4732e" alt="Sección Agente IA de un paso, con el interruptor y el selector de modo" width="1280" height="720" data-path="images/agentes/seccion-agente-ia.png" />
</Frame>

<Note>
  **Prender o apagar un agente, o cambiar su modo, no re-crea el flujo.** Es un ajuste de configuración: se aplica de inmediato, incluso a los documentos que ya están en ese paso. No necesitas volver a publicar por eso.
</Note>

## Los dos modos de trabajo

Todos los agentes de decisión pueden trabajar en uno de dos modos:

<Frame caption="El selector de modo del agente: elige entre solo recomendar o recomendar y ejecutar.">
  <img src="https://mintcdn.com/payana/ciZIXW9SReB7Uh7w/images/agentes/elegir-modo.gif?s=08a30f08780ca2424b9ab6e2610f960e" alt="Selector de modo del agente en el editor" width="1066" height="600" data-path="images/agentes/elegir-modo.gif" />
</Frame>

### Solo recomendar

El agente analiza el documento, decide qué haría y **deja su recomendación** — pero siempre hay una persona que confirma. Es el modo seguro para empezar: ves cómo decide el agente sin darle todavía la última palabra.

En este modo, el documento **siempre** llega a la bandeja de una persona, con la recomendación del agente ya visible y prellenada.

### Recomendar y ejecutar

El agente da un paso más: cuando tiene **confianza suficiente** (según tu política), completa el paso por sí mismo. El documento avanza sin que nadie tenga que tocarlo.

Si el agente **no** tiene confianza suficiente en un caso, no fuerza nada: cae al modo seguro y deja el documento para una persona, con su recomendación lista para revisar.

En una tabla, la diferencia entre los dos modos según la **confianza** de cada decisión:

| Situación                      | Solo recomendar                                     | Recomendar y ejecutar                       |
| ------------------------------ | --------------------------------------------------- | ------------------------------------------- |
| **Qué hace el agente**         | Deja su recomendación, siempre                      | Actúa cuando tiene confianza suficiente     |
| **Decisión de alta confianza** | Recomendación prellenada → **una persona confirma** | El agente **completa el paso solo**         |
| **Decisión de baja confianza** | **Una persona** revisa y decide                     | Cae al modo seguro → **una persona** revisa |
| **¿El documento avanza solo?** | Nunca: siempre pasa por una persona                 | Sí, cuando la confianza alcanza             |
| **Cuándo conviene**            | Para empezar y calibrar la política                 | Cuando la política ya está probada          |

<Warning>
  En modo **recomendar y ejecutar**, la empresa asume el resultado de las decisiones automáticas del agente. Por eso recomendamos empezar en **solo recomendar**, revisar sus decisiones un tiempo, y activar la acción automática cuando la política esté calibrada.
</Warning>

## La confianza: por qué cada decisión tiene un color

Cada decisión del agente viene con un nivel de **confianza**. En la plataforma lo verás traducido a color:

* **Alta confianza** (azul) — el agente está seguro; en modo "recomendar y ejecutar", estas son las decisiones que ejecuta solo.
* **Baja confianza** (gris) — el agente tiene una opinión pero no está seguro; siempre pasa por revisión de una persona.

Este color aparece en las recomendaciones que ves en tus tareas y en el detalle del documento. Es la forma de saber, de un vistazo, en qué decisiones el agente está firme y en cuáles conviene mirar con calma.

<Frame caption="El recuadro de recomendación del agente: el color refleja la confianza. En azul (alta confianza), el agente está firme en su decisión.">
  <img src="https://mintcdn.com/payana/ciZIXW9SReB7Uh7w/images/agentes/confianza-colores.png?fit=max&auto=format&n=ciZIXW9SReB7Uh7w&q=85&s=9c6fe5eb96ef59d944f12e987ba5c049" alt="Recomendación del agente con indicador de confianza por color" width="302" height="139" data-path="images/agentes/confianza-colores.png" />
</Frame>

## Transparencia: el agente nunca decide a ciegas

Un principio de diseño de los agentes de Payana: **todo lo que el agente piensa queda visible.**

* Cada decisión trae un **razonamiento** (por qué eligió eso).
* Las decisiones que el agente **no** ejecutó (por baja confianza) **no se pierden**: quedan guardadas y visibles para que una persona las acepte con un clic.
* El **historial** del documento (timeline) muestra qué recomendó el agente y qué hizo, incluso cuando actuó solo.

Aprende a leer todo esto en [Revisar tareas de agentes](/documentos/revisar-tareas-agentes).

## Qué pasa cuando el agente se detiene

Si un documento no cae en ningún caso que la política autorice, el agente **no improvisa**: deja su análisis y escala el documento a la persona responsable, con su recomendación ya prellenada. Nada avanza sin una regla que lo respalde o una persona que lo confirme.

## Activar un agente

<Steps>
  <Step title="Abre el paso en el editor del flujo">
    Ve a la sección **Agente IA** del paso.
  </Step>

  <Step title="Enciende el interruptor">
    Activa el agente. Puede que activar un agente requiera ajustar tu plan; el equipo de Payana te acompaña en ese paso.
  </Step>

  <Step title="Elige el modo">
    Empieza en **solo recomendar** para calibrar.
  </Step>

  <Step title="Escribe (o vincula) la política del paso">
    Sin política, el agente corre con un comportamiento por defecto seguro. Con política, decide como tu equipo. Ver [Políticas de paso](/flujos/politicas).
  </Step>
</Steps>

## Conoce cada agente

<CardGroup cols={2}>
  <Card title="Agente de clasificación" icon="tags" href="/agentes/agente-clasificacion">
    Elige la categoría del documento por el campo que definiste.
  </Card>

  <Card title="Agente de aprobación" icon="circle-check" href="/agentes/agente-aprobacion">
    Recomienda o decide aprobar o rechazar según tus criterios.
  </Card>

  <Card title="Agente de etiquetado" icon="tag" href="/agentes/agente-etiquetado">
    Aplica una o varias etiquetas del catálogo para organizar tus documentos.
  </Card>

  <Card title="Agente de causación" icon="robot" href="/documentos/agente-causacion">
    Causa el documento en tu ERP siguiendo tus reglas contables.
  </Card>
</CardGroup>
