# Probar, activar y pausar

Un <Term id="agent">agente</Term> tiene tres estados:

- **Borrador**: solo se ejecuta cuando usted lo prueba.
- **Activo**: se inicia solo con su programación o disparador, y gasta los <Term id="credits">créditos</Term> del <Term id="workspace">espacio de trabajo</Term>.
- **Pausado**: deja de iniciarse solo hasta que alguien lo active de nuevo.

Un agente activo se ejecuta sin vigilancia y cuesta créditos, así que solo un Propietario o Administrador del espacio de trabajo puede activarlo.

## Antes de empezar [#antes-de-empezar]

| Para | Necesita |
| --- | --- |
| Probar un borrador | Poder editar el proyecto |
| Ejecutar ahora un agente activo | Poder abrir el proyecto |
| Activar, o activar de nuevo una versión anterior | Ser **Propietario** o **Administrador** del espacio de trabajo |
| Pausar o eliminar | Poder editar el proyecto |

Cualquier otra persona ve "Un administrador del espacio de trabajo activa los agentes." Los <Term id="roles">roles</Term> se definen en <AppLink to="settings.members" /> (consulte [Miembros](/docs/es/workspace/members)). La IA de un Studio nunca puede activar ni eliminar un agente; solo puede pedirlo.

## Probar un borrador [#probar-un-borrador]

**Probar** ejecuta el borrador más reciente una vez, ahora. Nada se activa y ninguna programación se inicia.

<ForEveryone>

<Steps>
<Step>
### Abra el agente [#abra-el-agente]
Ábralo desde <AppLink to="agents" /> o desde la pestaña **Agentes** del proyecto.
</Step>
<Step>
### Seleccione Probar [#seleccione-probar]
La <Term id="run">ejecución</Term> se abre y usted sigue cada paso. En un agente activo con cambios en borrador el botón dice **Probar cambios**; la versión activa sigue funcionando.
</Step>
<Step>
### Revise el resultado [#revise-el-resultado]
Lea su **Resultado** y abra **Registro y archivos** en cualquier paso. Si no está bien, cambie el borrador y pruebe de nuevo.
</Step>
</Steps>

<Screenshot src="/docs/_media/demp-bakery-business-data-agent-flow-page.png" alt="La página de un agente con los botones Probar y Activar" />

</ForEveryone>

<ForDevelopers>

`klarety agent test` guarda el borrador desde sus archivos y lo ejecuta una vez. Pase entradas con `--input name=value` (repetible; `7` se lee como número y `true` como booleano).

<Tabs items={["CLI", "Python"]}>
<Tab value="CLI">
```bash
klarety agent test daily-summary --project PROJECT_ID --input table=sales.orders
```
</Tab>
<Tab value="Python">
```python
from klarety import Nexus

nx = Nexus.connect()
nx.agents.save("PROJECT_ID", "daily-summary")
run_id = nx.agents.start(
    "PROJECT_ID", "daily-summary", draft=True, inputs={"table": "sales.orders"}
)
print(run_id)
```
</Tab>
</Tabs>

La respuesta es el id de la ejecución. Sígala con `klarety agent show <run_id>` y lea lo que produjo con `klarety agent result <run_id>`.

</ForDevelopers>

## Activar [#activar]

<Callout type="warn" title="Un agente activo gasta créditos">
  Una vez activo, el agente se ejecuta solo y cada ejecución usa los [créditos](/docs/es/workspace/credits) del espacio de trabajo. Pruebe primero el borrador y páuselo cuando ya no lo necesite.
</Callout>

<ForEveryone>

<Steps>
<Step>
### Seleccione Activar [#seleccione-activar]
En la página del agente, seleccione **Activar**. La aplicación pregunta "¿Activar daily-summary?" (con el nombre de su agente) y le recuerda que gastará los créditos del espacio de trabajo.
</Step>
<Step>
### Confirme [#confirme]
Seleccione **Activar** de nuevo. El agente queda **Activo**, su disparador funciona y pasa a **Automáticos** (o **A pedido**) en la página de Agentes.
</Step>
</Steps>

<Screenshot src="/docs/_media/demp-bakery-business-data-agent-flow-page.png" alt="El diálogo de confirmación para activar un agente" />

La IA del Studio puede pedir publicar un agente. Usted ve un aviso, "Tu IA pide publicar un agente", con **Verlo**, **Publicar** y **Ahora no**. Nada se ejecuta hasta que una persona selecciona **Publicar**.

</ForEveryone>

<ForDevelopers>

Desde el código usted pide; una persona decide en la aplicación. `klarety agent publish` guarda el borrador y envía la solicitud:

```bash
klarety agent publish daily-summary --project PROJECT_ID
```

```json
{
  "version_id": "...",
  "asked": true
}
```

Un Propietario o Administrador del espacio de trabajo que use su propia clave de API puede publicar una versión guardada directamente con `nx.agents.publish("PROJECT_ID", "daily-summary", version_id)`. Cualquier otra persona recibe un `RefusedError` (HTTP 403), porque un agente activo gasta los créditos del espacio de trabajo.

</ForDevelopers>

## Ejecutar ahora un agente activo [#ejecutar-ahora-un-agente-activo]

Un agente activo que se inicia **Cuando usted presiona Ejecutar** espera en **A pedido**. Ábralo y seleccione **Ejecutar**.

<ForDevelopers>

```bash
klarety agent run daily-summary --project PROJECT_ID
```

</ForDevelopers>

## Pausar un agente [#pausar-un-agente]

Seleccione **Pausar** y confirme. Deja de iniciarse solo; las ejecuciones en curso terminan. Puede activarlo de nuevo cuando quiera.

<ForDevelopers>

```python
nx.agents.unpublish("PROJECT_ID", "daily-summary")
```

</ForDevelopers>

## Volver a una versión anterior [#volver-a-una-versión-anterior]

Cada versión que estuvo activa se conserva. Abra **Versiones anteriores**, elija una y seleccione **Activar de nuevo**. Reemplaza de inmediato la versión activa y requiere un Propietario o Administrador del espacio de trabajo.

## Eliminar un agente [#eliminar-un-agente]

Seleccione **Eliminar** y luego **Eliminar agente**. Se detiene y sale de la lista. Las ejecuciones pasadas y su costo quedan registrados.

## Si algo sale mal [#si-algo-sale-mal]

- **Activar no está disponible**: usted no es Propietario ni Administrador del espacio de trabajo. Pida a uno que lo active, o pida a la IA de su Studio que lo solicite para que le aparezca a esa persona.
- **Un agente activo no se inició a tiempo**: revise que esté **Activo** y no pausado. Una ejecución fallida aparece en **Con fallos**; ábrala para ver qué paso se detuvo y por qué.
- **Los cambios en borrador no se ejecutan**: los cambios siguen siendo borrador hasta que alguien los active. El estado dice **Activo, con cambios en borrador**.

## Siguientes pasos [#siguientes-pasos]

- [Ejecuciones y aprobaciones](/docs/es/agents/runs)
- [Crear un agente](/docs/es/agents/create-an-agent)
- [Créditos](/docs/es/workspace/credits)