# Qué hacen los agentes

Un <Term id="agent">agente</Term> trabaja por su cuenta. Lee sus datos, hace algo con ellos (ejecuta código, le pregunta a una IA, investiga en la web) y guarda el resultado en una tabla, un archivo o una respuesta corta. Usted describe el trabajo con sus palabras, y la IA del [Studio](/docs/es/projects/studio) de su proyecto lo construye como borrador.

Úselo para trabajo que se repite: un resumen matutino, calificar filas nuevas, copiar una API web en una tabla cada hora, un informe semanal.

## Cómo se construye un agente [#cómo-se-construye-un-agente]

Cada agente pertenece a un [proyecto](/docs/es/projects/create-a-project) y está hecho de **pasos**. Cada paso hace una cosa, y los siguientes usan lo que hicieron los anteriores. Haga clic en cualquier paso de la página del agente para ver su configuración.

| Paso | Qué hace |
| --- | --- |
| **Código** | Ejecuta un archivo corto de Python que usted o la IA escribieron. |
| **IA** | Le pide a un modelo de IA que lea la entrada del paso y responda una instrucción. |
| **Investiga en la web** | Busca información en la web y anota lo que encontró. |
| **Lee datos** | Ejecuta una consulta <Term id="sql">SQL</Term> en [Nexus](/docs/es/data), su base de datos. |
| **Guarda en una tabla** | Escribe filas en una <Term id="table">tabla</Term>: **Agregar filas**, **Actualizar o agregar** o **Reemplazar todo**. |
| **Le pregunta primero** | Pausa la ejecución y espera a que una persona diga sí o no. |
| **Inicia otro agente** | Le pasa trabajo a otro agente. |

Un paso puede ejecutarse una vez **para cada elemento** que hizo un paso anterior, con una opción para cuántos se ejecutan **a la vez**. Puede ejecutarse **solo cuando** se cumple una condición, reintentar tras un fallo (**Reintentos**) y detenerse tras un **Límite de tiempo**. Un paso de IA puede usar un **Modelo** específico; si se deja en el predeterminado del plan, sigue a su plan.

## Cuándo se inicia un agente [#cuándo-se-inicia-un-agente]

- **Con una programación**: cada hora, a diario a una hora fija o en días escogidos de la semana.
- **Cuando llegan archivos** a una carpeta del [Almacenamiento de objetos](/docs/es/data/object-storage).
- **Cuando se cargan filas** en una [tabla](/docs/es/data/tables).
- **Cuando llama un webhook**.
- **Cuando usted presiona Ejecutar**.

Los inicios automáticos solo funcionan cuando el agente está activo. Hasta entonces es un borrador que puede probar cuantas veces quiera.

## Cómo funciona una ejecución [#cómo-funciona-una-ejecución]

Cada inicio crea una <Term id="run">ejecución</Term>. Recorre los pasos en orden, y cada paso muestra su estado: En espera, En curso, Completado, Fallido, Omitido, o **Esperando su respuesta** cuando pide aprobación. Una ejecución termina como Completada, Fallida, Rechazada (alguien dijo que no en una aprobación) o Detenida.

El **Resultado** de la ejecución muestra lo que produjo el agente: filas, texto o archivos para descargar. Cada paso conserva su registro y sus archivos. Consulte [Ejecuciones y aprobaciones](/docs/es/agents/runs).

## Los agentes preguntan antes de cambiar algo importante [#los-agentes-preguntan-antes-de-cambiar-algo-importante]

Un paso **Le pregunta primero** puede ir antes de cualquier cosa que guarde o cambie datos. La ejecución se pausa allí y el agente aparece en **Lo necesitan** en la página de Agentes. Nada después ocurre hasta que una persona elige **Sí, continuar**.

## Borradores, agentes activos y quién decide [#borradores-agentes-activos-y-quién-decide]

Usted trabaja sobre un **borrador**. **Probar** lo ejecuta una vez, ahora, y nada se activa. Cuando hace lo que usted quiere, un administrador del <Term id="workspace">espacio de trabajo</Term> elige **Activar**. Desde ese momento se inicia solo y gasta los créditos del espacio de trabajo. Cualquier versión anterior se puede activar de nuevo. Consulte [Probar, activar y pausar](/docs/es/agents/go-live).

<Callout type="info" title="Solo una persona activa un agente">
  La IA de su Studio puede construir y probar agentes, pero no puede activarlos. Cuando pide publicar un agente, usted ve la solicitud y decide. Solo un Propietario o Administrador del espacio de trabajo puede activar un agente.
</Callout>

## Lo que cuestan los agentes [#lo-que-cuestan-los-agentes]

Las ejecuciones usan <Term id="credits">créditos</Term> de su espacio de trabajo. El costo de cada una está en la columna **Créditos** de la lista de ejecuciones, y la página de Agentes muestra **Créditos hoy** y las ejecuciones de la última semana. El saldo y el gasto están en <AppLink to="settings.usage" />.

## La página de Agentes [#la-página-de-agentes]

<AppLink to="agents" /> muestra todos los agentes de los proyectos que usted puede abrir, agrupados por lo que necesita atención primero:

- **Lo necesitan**: una ejecución espera su aprobación.
- **En ejecución**: hay una ejecución en curso.
- **Con fallos**: la última ejecución falló.
- **Automáticos**: activos y se inician solos.
- **A pedido**: activos y esperan a que alguien los inicie.
- **Aún sin publicar**: todavía son borradores.

Cambie entre **Tablero** y **Lista**, o busque por nombre de agente o de proyecto.

<Screenshot src="/docs/_media/agents-overview.png" alt="La página de Agentes con los agentes agrupados según lo que necesitan" />

## Siguientes pasos [#siguientes-pasos]

- [Crear un agente](/docs/es/agents/create-an-agent)
- [Plantillas](/docs/es/agents/templates)
- [Probar, activar y pausar](/docs/es/agents/go-live)
- [Ejecuciones y aprobaciones](/docs/es/agents/runs)