Klarety

Qué hacen los agentes

Los agentes leen sus datos, los analizan con IA y escriben el resultado, con una programación o cuando llegan datos.

Para todos

Un 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 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

Cada agente pertenece a un proyecto 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.

PasoQué hace
CódigoEjecuta un archivo corto de Python que usted o la IA escribieron.
IALe pide a un modelo de IA que lea la entrada del paso y responda una instrucción.
Investiga en la webBusca información en la web y anota lo que encontró.
Lee datosEjecuta una consulta en Nexus, su base de datos.
Guarda en una tablaEscribe filas en una : Agregar filas, Actualizar o agregar o Reemplazar todo.
Le pregunta primeroPausa la ejecución y espera a que una persona diga sí o no.
Inicia otro agenteLe 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

  • 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.
  • Cuando se cargan filas en una tabla.
  • 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

Cada inicio crea una . 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.

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

Usted trabaja sobre un borrador. Probar lo ejecuta una vez, ahora, y nada se activa. Cuando hace lo que usted quiere, un administrador del 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.

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.

Lo que cuestan los agentes

Las ejecuciones usan 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 ConfiguraciónUso y límites.

La página de Agentes

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

La página de Agentes con los agentes agrupados según lo que necesitan

Siguientes pasos

En esta página