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

# Políticas de paso

> Escribe las reglas de tu operación en lenguaje natural para que los agentes las apliquen — y para que tu equipo tenga una guía de referencia clara en cada paso

Una **política** es un texto en lenguaje natural que describe cómo se debe decidir en un paso del flujo. Es el mecanismo con el que le enseñas a un agente las reglas de tu empresa, y a la vez una guía de referencia para las personas que revisan.

No es código ni un formulario con campos rígidos: es el mismo conocimiento que hoy vive en la cabeza de tu analista, puesto por escrito para que el agente lo entienda y lo aplique de forma consistente.

<Frame caption="Editor de política del paso: se escribe en lenguaje natural y se guarda al instante.">
  <img src="https://mintcdn.com/payana/ciZIXW9SReB7Uh7w/images/workflows/editar-politica.gif?s=bc3c6d0b208ff1f5b515dd8fe40e5298" alt="Editor de la política de un paso" width="1066" height="600" data-path="images/workflows/editar-politica.gif" />
</Frame>

## Por qué importan las políticas

* **Le dan inteligencia al agente.** Un agente sin política corre con un comportamiento por defecto, seguro pero genérico. Con una política, decide como lo haría tu equipo.
* **Definen el alcance de la autonomía.** La política es donde dices en qué casos el agente puede actuar solo y en cuáles debe escalar a una persona.
* **Son documentación viva.** Cualquiera de tu equipo puede leer la política del paso para entender los criterios, aunque el paso lo ejecute una persona.

<Tip>
  Cuanto más se parezca la política a cómo le explicarías las reglas a alguien nuevo en el equipo, mejor la entiende el agente. Usa ejemplos, tablas y condiciones concretas.
</Tip>

## Cómo escribir una política

Una política puede incluir texto, listas, tablas, condiciones y ejemplos. Este es un ejemplo para un paso de causación:

```text theme={null}
Reglas de centros de costo — Vehículos:
Cada peaje o gasto de combustible va al centro de costo de la placa que lo generó.

| Placa    | Centro de costo      |
|----------|----------------------|
| ABC 123  | CC-BOG-Distribución  |
| XYZ 789  | CC-MED-Logística     |

Si la factura no tiene placa identificable, enviar a revisión.

Autonomía — cuándo actuar sin esperar revisión:
- Peajes: siempre que la placa esté en la tabla de referencia.
- Facturas menores a $1.000.000 COP de proveedores con historial en Payana.
Para todo lo demás, generar recomendación y esperar confirmación.
```

Y este es un ejemplo para un paso de **aprobación**:

```text theme={null}
Criterios de aprobación — Gastos operativos:

Aprobar automáticamente si TODO lo siguiente se cumple:
- El proveedor está en la lista de proveedores habituales.
- El monto es menor a $2.000.000 COP.
- La factura tiene orden de compra asociada.

Rechazar si:
- El proveedor está en la lista de bloqueados.
- La factura está duplicada (mismo proveedor, monto y fecha que una ya registrada).

En cualquier otro caso, dejar la recomendación y escalar a Finanzas.
```

<Note>
  No necesitas cubrirlo todo desde el primer día. Empieza con las reglas más frecuentes y agrega casos a medida que el agente encuentre documentos que no sabe resolver.
</Note>

## Agregar una política a un paso

<Steps>
  <Step title="Abre el paso y ve a la sección Política del paso">
    Está disponible en todos los pasos que admiten decisión (clasificación, aprobación, etiquetado, causación).
  </Step>

  <Step title="Elige cómo crearla">
    * **Agregar política** — abre el editor para escribirla desde cero.
    * **Usar una existente** — abre el catálogo para reutilizar una política ya escrita.

    <Frame caption="La sección Política del paso: escribir una nueva o reutilizar una del catálogo.">
      <img src="https://mintcdn.com/payana/ciZIXW9SReB7Uh7w/images/workflows/politica-botones.png?fit=max&auto=format&n=ciZIXW9SReB7Uh7w&q=85&s=250b3105ca8c7ef733eb1c41e26ec5fa" alt="Botones de la sección Política del paso" width="421" height="96" data-path="images/workflows/politica-botones.png" />
    </Frame>
  </Step>

  <Step title="Escribe o pega el contenido y guarda">
    La política se guarda al instante. El paso queda marcado como "Política configurada", con un enlace para verla o editarla.
  </Step>
</Steps>

## El catálogo de políticas reutilizables

Las políticas no viven encerradas en un solo paso: se guardan en un **catálogo** de tu empresa y puedes reutilizarlas en varios pasos y flujos.

* **Reutilizar** una política del catálogo la vincula a tu paso.
* Cada política tiene un **nombre único** dentro de tu empresa, para que sea fácil de identificar. El editor no permite dos políticas con el mismo nombre.
* Puedes **duplicar** una política existente para crear una variante sin afectar la original.

<Frame caption="El catálogo de políticas reutilizables: «Usar» la vincula, «Copiar» crea una variante.">
  <img src="https://mintcdn.com/payana/ciZIXW9SReB7Uh7w/images/workflows/catalogo-politicas.png?fit=max&auto=format&n=ciZIXW9SReB7Uh7w&q=85&s=be0c3cf3d7a8d1180b5498c7ab22fbf1" alt="Catálogo de políticas reutilizables" width="1280" height="720" data-path="images/workflows/catalogo-politicas.png" />
</Frame>

<Warning>
  Si editas una política que está siendo usada por un paso, el agente aplicará la versión actualizada la próxima vez que actúe. Las políticas se leen en el momento de la decisión, así que un cambio de política **no** requiere republicar el flujo.
</Warning>

## Buenas prácticas

<AccordionGroup>
  <Accordion title="Sé explícito con la autonomía">
    Separa claramente los casos en que el agente puede actuar solo de los que debe escalar. Una frase como "para todo lo demás, generar recomendación y esperar confirmación" evita sorpresas.
  </Accordion>

  <Accordion title="Usa tablas para las correspondencias">
    Placas → centros de costo, proveedores → cuentas contables, categorías → aprobadores. Las tablas son fáciles de leer para el agente y para tu equipo.
  </Accordion>

  <Accordion title="Empieza en modo recomendación">
    Deja que el agente recomiende un tiempo y revisa sus decisiones antes de darle autonomía para actuar. Así calibras la política con casos reales.
  </Accordion>

  <Accordion title="Itera con los casos que se escapan">
    Cada vez que el agente escale un documento que "debería" haber sabido resolver, agrega esa regla a la política.
  </Accordion>
</AccordionGroup>
