Agent Tasks

Qué hace Agent Tasks

Con Agent Tasks encargas tareas recurrentes a agentes de IA en lugar de hacerlas tú. Briefas a un agente como lo harías con una persona, por ejemplo «cada lunes por la mañana, suma los pedidos de la semana pasada y envíame el resumen por correo», eliges las herramientas que puede usar y indicas cuándo debe ejecutarse. El agente planifica sus propios pasos en el momento de ejecutarse, trabaja dentro de los límites que fijaste y se detiene para tu aprobación antes de que salga nada hacia un cliente.

Tres términos aparecen en toda esta guía:

• Un agente es una tarea que has configurado: su instrucción, sus herramientas y su disparador.
• Una ejecución es cada vez que se pone en marcha el agente. Cada ejecución deja un registro paso a paso en el Registro de ejecuciones.
• Un conector es un servicio que un agente puede usar: tu tienda, un canal de chat, una hoja de cálculo, un marketplace, un proveedor de pagos. Una misma conexión la comparten todos los agentes del bot.

Agent Tasks es un complemento. Tras la compra, Complementos → Agent Tasks deja de aparecer atenuado en la barra lateral del panel, con Resumen, Agentes, Biblioteca, Conectores, Registro de ejecuciones y Configuración debajo. Sin el complemento, la página solo muestra una breve descripción y nada más.

Dónde están las cosas

Abre Complementos → Agent Tasks en la barra lateral del panel. La consola tiene cinco páginas, cada una con su propia entrada en la barra lateral:

• Resumen: lo que necesita tu atención ahora mismo y una tabla de tus agentes activos.
• Agentes: todos los agentes, con pausar, ejecutar, editar y eliminar.
• Biblioteca: agentes preparados que puedes añadir con un clic, además del constructor en blanco.
• Conectores: lo integrado, lo conectado y lo que puedes conectar.
• Registro de ejecuciones: cada ejecución, sus pasos, su coste y cualquier aprobación que esté esperando.

El constructor se abre desde las pestañas Agentes y Biblioteca y aparece bajo Agentes mientras estás en él.

Resumen: lo que te necesita

La tarjeta REQUIERE TU ATENCIÓN es el lugar que hay que revisar. Su encabezado cuenta lo que espera y cuántas tareas se gestionaron esta semana. Aparecen tres tipos de fila:

• Una ejecución retenida: un agente quiere enviar algo y espera por ti. Revisar abre la ejecución con los mensajes exactos que propone.
• Una conexión rota: el acceso de un conector ha caducado y los agentes que lo usan fallarán hasta que vuelvas a conectar. Volver a conectar te lleva a la pestaña Conectores.
• Un agente en borrador: construido pero nunca publicado. Abrir borrador te devuelve al constructor.

Cuando no hay nada en espera, la tarjeta lo indica, y puedes dejar la consola en paz: los agentes funcionan solos y solo aparecen aquí cuando uno necesita una decisión.

Debajo, AGENTES ACTIVOS enumera cada agente en marcha con su horario, su próxima ejecución, los conectores que usa y el resultado de su última ejecución.

Añadir un agente desde la biblioteca

El inicio más rápido es un agente preparado. Abre Biblioteca, filtra por Cliente, Soporte, Operación o Informes, y pulsa Añadir agente en una tarjeta. Añadir desde la biblioteca es gratis, y el agente queda activo de inmediato con el horario indicado en su tarjeta.

Algunas plantillas necesitan primero una conexión. Una tarjeta que lee una hoja de cálculo te pide elegir el archivo al añadirla, y si todavía no hay ninguna hoja conectada te envía a la pestaña Conectores. Las tarjetas que necesitan un servicio concreto (Shopify, Calendly, AfterShip, Stripe, HubSpot, Slack, Mailchimp, un número de voz) solo funcionan cuando ese conector está configurado.

La biblioteca incluye actualmente:

• Informes: Resumen semanal de ventas (lunes por la mañana), Registro de ventas a hoja de cálculo (cada mañana), Exportación del registro de llamadas (cada noche).
• Operación: Actualización de la base de conocimiento (semanal), Envío de campañas (semanal), Ronda de llamadas (cada hora), Alerta de stock bajo (cada mañana), Auditoría de stock en marketplaces (cada mañana).
• Soporte: Seguimiento del estado de pedidos (diario), Escalado de tickets vencidos (cuando un ticket supera su SLA), Concierge de traspaso (cuando un cliente pide una persona).
• Cliente: Reservar una cita, Estado de garantía, Buscar una tienda, Estado de entrega, Estado de reembolso, Lista de espera de reposición. Estos los llaman tus clientes desde el chat; consulta más abajo *Dejar que los clientes llamen a un agente desde el chat*.

Un agente añadido desde la biblioteca es tuyo para editarlo. Ábrelo con Editar en la pestaña Agentes: puedes cambiar su nombre, instrucción, modelo y horario, y añadir o quitar herramientas. Quitar una herramienta solo reduce lo que el agente puede hacer; nunca lo amplía.

Crear un agente propio

Pulsa + Crear agente en la pestaña Agentes, o + Crear desde cero en la Biblioteca. El constructor es una página con cuatro tarjetas.

Qué hace

• Nombre: cómo aparece en las listas y en los correos de aprobación.
• Instrucción: el briefing, hasta 4.000 caracteres. Escríbelo como escribirías a un miembro del personal: qué mirar, qué hacer, qué no hacer nunca. El agente planifica sus pasos a partir de esto y se detiene en tus barreras.
• Modelo: Rápido para consultas cortas y respuestas rutinarias, Equilibrado para trabajo de varios pasos con llamadas a herramientas (predeterminado), Profundo para razonamiento largo cuando los errores son caros. Los modelos más profundos cuestan más por ejecución.

Herramientas que puede usar

Las herramientas se agrupan en lo que el agente puede hacer, lo que puede leer y en qué puede escribir. Pulsa + Añadir en cada grupo. Todo lo que necesite una conexión que aún no has hecho aparece marcado como CONECTAR ANTES; todo lo que todavía no esté disponible en la plataforma, como PRÓXIMAMENTE.

Acciones que puede realizar:

• Mensaje: enviar a conversaciones de tus canales de chat conectados. Cada mensaje se retiene para tu aprobación. Con más de un canal conectado, elige el canal en la tarjeta o déjalo en *Cualquier canal*.
• Correo: enviar desde tu buzón conectado a cualquier dirección. Cada correo se retiene para tu aprobación. Los informes a tu propio buzón no necesitan ninguna configuración.
• Teléfono: realizar llamadas salientes desde tu número de voz. Cada llamada se retiene para tu aprobación y se limita a 15 minutos. Requiere el canal de voz y un número.
• API de un conector: una entrada por cada servicio conectado. El agente compone las llamadas; las credenciales permanecen en el servidor y nunca son visibles para él.
• Rastreador: obtiene y lee páginas web públicas indicadas en el briefing.
• Búsqueda web: busca información actual en la web.
• Llamar a una API: llama a una API en hosts que indicas en la tarjeta, con una clave opcional. La clave se guarda con el agente y la inyecta la plataforma; el agente nunca la lee.
• Herramientas MCP: usan las herramientas de un servidor MCP cuya dirección introduces en la tarjeta.

Fuentes de datos que puede leer: tu tienda (pedidos y datos de tienda de Shopify, WordPress o Wix, solo lectura), transcripciones de conversaciones, la base de conocimiento del chatbot, el mantenimiento del conocimiento (actualizar la base de conocimiento desde tu sitio y leer su estado), el conocimiento interno del agente del helpdesk, una hoja de cálculo que elijas en la tarjeta y la memoria propia del agente de ejecuciones anteriores.

Almacenes de datos en los que puede escribir: una hoja de cálculo que elijas en la tarjeta y la memoria del agente, las notas propias del agente entre ejecuciones, como a quién ya se contactó.

Cada tarjeta de hoja de cálculo fija su propio archivo. Google Sheets abre el selector de archivos de Google; Microsoft Excel abre una lista de los libros de tu OneDrive conectado. El agente lee y escribe solo el archivo que elijas.

Cuándo se ejecuta

• Según un horario: cada hora, cada día, días laborables, fines de semana, semanal o mensual, a la hora y zona horaria que elijas. Una línea verde bajo el selector muestra el resultado en palabras sencillas.
• Ante un evento: eventos de chat (traspaso solicitado, abuso detectado, sin respuesta encontrada), eventos del helpdesk (ticket nuevo, necesita aprobación, necesita atención, reabierto, fuera de SLA), eventos de tienda (pedido nuevo, pedido reembolsado, pedido cancelado, y en Wix también carrito abandonado y stock bajo) o Con webhook. Al elegir el webhook, el agente recibe su propia URL, que se muestra en su tarjeta, a la que cualquier sistema puede enviar datos con POST.
• Cuando un cliente lo pide en el chat: el cliente inicia el agente desde una conversación. Consulta la siguiente sección.
• Solo manual: sin horario ni eventos. Pulsas Ejecutar ahora en la pestaña Agentes.

Barreras

Dos barreras están siempre activas: los mensajes a clientes se retienen para tu aprobación, y una ejecución se detiene si su gasto supera el límite por ejecución (actualmente 2,00 $). Aparecen en la tarjeta para que sepas que existen.

Ejecución de prueba y publicación

Para un agente creado a partir de un briefing, Ejecución de prueba ejecuta el plan sin enviar nada y te muestra lo que habría hecho, etiquetado como *Vista previa de prueba, no se envió nada*. Las ejecuciones de prueba se cobran como las reales. Cuando estés satisfecho, Publicar agente lo activa; un agente activo que vuelves a compilar recibe Publicar actualización.

Tras compilar, aparece un banner verde *Compilado. Esto es lo que hará este agente*, seguido del plan en lenguaje sencillo. Léelo antes de publicar.

Dejar que los clientes llamen a un agente desde el chat

Ajusta Cuándo se ejecuta a Cuando un cliente lo pide en el chat y el constructor muestra un pequeño contrato:

• Nombre de la herramienta: cómo la llama internamente la IA del chat. Los clientes nunca lo ven.
• Cuándo usarla: una frase que indica a la IA del chat cuándo aplica esta tarea. Escríbela como una instrucción al personal.
• Datos que el cliente puede aportar: hasta cinco, cada uno con nombre, tipo (texto, número, sí/no), descripción y si es obligatorio.
• Ejecuciones por cliente: cuántas veces puede iniciar un cliente esta tarea en 24 horas, de 1 a 10. El valor predeterminado es 3.
• Alcance de datos: una instrucción que se añade a cada paso de una ejecución llamada por un cliente, sobre lo que el agente puede y no puede repetir.

El agente necesita la acción Mensaje, o no tiene forma de responder.

Hay dos cosas que entender antes de publicar. Primero: todo lo que una tarea puede leer, puede repetirlo al cliente que la llamó. El alcance de datos es una instrucción para la IA, no un límite de seguridad; no concedas a una tarea orientada al cliente datos que nunca debería mostrar. Lo que respalda esto: cada respuesta que produce una tarea llamada por un cliente pasa, antes de que el chat la entregue, por un filtro de fugas que la compara con la petición del cliente y con tu alcance de datos.

Una respuesta que da al cliente su propia hora de cita sale; una que enumera tu calendario, cita tus notas o nombra a otro cliente se detiene como ejecución retenida, el cliente recibe el aviso de que el equipo de la tienda la está revisando, y tu aprobación o rechazo en el Historial de ejecuciones decide si se entrega o se cierra.

Las tareas llamadas por clientes tampoco pueden usar el Rastreador ni la Búsqueda web, mantienen su memoria separada por cliente, y solo pueden enviar correos al cliente que preguntó o a ti. Segundo: cada ejecución gasta tus créditos, limitados por el límite por cliente. Un cliente que ya agotó su cupo recibe el aviso de que la tarea no está disponible en este momento; nunca se le informa de nada sobre tu saldo.

Quién cuenta como cliente: en los canales de mensajería (WhatsApp, Telegram, LINE, Messenger, Instagram, Discord), la cuenta propia del cliente es su identidad y no hace falta iniciar sesión. En tu sitio web, el visitante debe haber iniciado sesión; a los visitantes anónimos se les pide primero que inicien sesión. WordPress y la app de Shopify lo gestionan automáticamente. Cualquier otro sitio necesita el Secreto de firma de identidad que aparece en la pestaña Agent Tasks dentro de Configurar, un trabajo único para quien construyó el sitio.

Publicar el agente es lo que lo hace público. Pausarlo en la pestaña Agentes lo retira. Agent Tasks → Configuración lista tus agentes llamables desde el chat, pero no es un segundo interruptor.

Conectores

Abre Conectores. La primera fila, INTEGRADO, contiene lo que ya tiene cada agente sin configurar nada: tu plataforma de tienda (Shopify, WordPress o Wix, detectada automáticamente), el Chatbot (responder en cualquier canal), Conocimiento del bot, Enviarme un correo (informes solo a tu bandeja), Memoria del agente y Conversaciones.

Debajo, la BIBLIOTECA DE CONECTORES lista cada servicio que puedes añadir, filtrable por Canales, Redes sociales, Marketplaces, Helpdesks, Pagos, CRM, Marketing y Productividad. Cada tarjeta se conecta de una de cuatro maneras:

• Conectar: un inicio de sesión con el proveedor. Aprueba la solicitud y vuelves a la consola; no hay nada que copiar. Lo usan Google Sheets, Microsoft Excel, Slack, Notion, los calendarios, Calendly, Stripe, Square, Squarespace, Mailchimp, Klaviyo, Attentive, HubSpot, Zoho, Salesforce, Judge.me, la familia de Google, la familia de Meta, X, TikTok, YouTube y los marketplaces. Dos de ellos piden antes un dato: Judge.me necesita el dominio de tu tienda, y WooCommerce necesita la URL de tu tienda, porque la pantalla de aprobación está en tu propia tienda.
• Conectar con una clave: pegas las credenciales del propio panel del proveedor. El formulario se abre con un enlace Obtener tu clave a la página correcta y una ruta de una línea que seguir una vez dentro. Lo usan PayPal, AfterShip, ShipStation, Shippo, Rakuten, Resend, Mailtrap, Twilio, Vonage, Telnyx, Loox y Microsoft Clarity. Apple Calendar es el mismo formulario con otra etiqueta, Conectar con cuenta, porque pide tu ID de Apple y una contraseña específica de app en lugar de una clave. Las claves se cifran en reposo como cualquier otra credencial.
• Conectado mediante tu bot: los canales de chat (Telegram, WhatsApp, Discord, Voz, LINE, Messenger, Instagram) y los helpdesks (Zendesk, Gorgias, Freshdesk, Help Scout) provienen de la configuración propia del bot. Si uno aún no está configurado, Conectar abre el mismo formulario de configuración que usa la pestaña Canales.
• Próximamente: el conector existe pero aún no está activado para la plataforma. Consulta más abajo *Por qué una tarjeta dice «Próximamente»*.

Una conexión sirve a todos los agentes del bot. Desconectar elimina nuestro acceso guardado y, cuando el proveedor lo admite, también lo revoca en su lado.

Cuando caduca el acceso de un proveedor, la tarjeta cambia a Volver a conectar, conexión caducada, el Resumen la marca, y los agentes que dependen de ella se pausan automáticamente con el motivo indicado en su fila. Volver a conectar los reanuda.

Algunos conectores tienen particularidades que el aviso del formulario explica: la clave de licencia de Rakuten se renueva aproximadamente cada 90 días; la Búsqueda de transacciones de PayPal puede tardar hasta nueve horas en activarse tras habilitarla; Mailtrap fija un stream por conexión; Twilio acepta una clave de API o el token de autenticación de la cuenta; Loox requiere un plan de pago de Loox; Resend solo puede enviar desde un dominio verificado en tu propia cuenta de Resend; una conexión de Squarespace que ningún agente haya usado durante una semana debe volver a conectarse.

Aprobaciones y ejecuciones retenidas

Cuando un agente quiere enviar un mensaje, un correo o una llamada a un cliente, la ejecución se detiene antes de enviar y queda marcada como RETENIDA. Recibes un correo con el asunto *El agente «…» espera tu aprobación*, y la ejecución aparece en REQUIERE TU ATENCIÓN.

Ábrela en el Registro de ejecuciones. La línea de tiempo de pasos termina en un bloque ámbar por cada escritura propuesta: a quién va, el asunto si lo hay y el comienzo del cuerpo. Aprobar y enviar envía todo lo de la ejecución; Rechazar lo descarta. La aprobación es total o nada; no hay selección de mensajes individuales.

Una ejecución retenida espera siete días. Si no decides antes, caduca, y el agente no inicia nuevas ejecuciones programadas mientras haya una decisión pendiente. Dos destinos nunca se retienen: un informe a tu propio buzón y una hoja de cálculo que tú hayas elegido. Son de confianza, así que los agentes de informes funcionan sin supervisión desde el primer día.

El Registro de ejecuciones

Cada ejecución llega al Registro de ejecuciones, la más reciente primero, filtrable por Todas, Fallidas y Retenidas. Cada fila muestra el agente, cuándo se ejecutó y qué la disparó (horario, evento, manual, prueba, una petición de chat de un cliente o una aprobación), cuánto duró y el resultado. Exportar CSV descarga la lista.

Selecciona una ejecución para ver sus pasos a la derecha: cada paso en palabras sencillas, la herramienta usada, la duración y cualquier error. Las ejecuciones retenidas muestran las escrituras propuestas con los botones de aprobar y rechazar. Las ejecuciones de teléfono listan cada llamada con un enlace a su transcripción. Las ejecuciones de prueba muestran el panel de vista previa.

Insignias de resultado: HECHO terminada; FALLIDO detenida por un error, mostrado en la fila; RETENIDO esperando por ti; DETENIDO parada por ti o por el sistema, con el motivo; EN EJECUCIÓN, EN COLA y APLICANDO siguen en curso.

Gestionar agentes

En la pestaña Agentes, cada fila tiene un interruptor para pausar o reanudar, Ejecutar ahora, Editar y un menú ⋯ con Duplicar y Eliminar.

• Pausar detiene el horario y, en un agente llamable desde el chat, lo retira. Volver a activarlo reanuda el horario.
• Ejecutar ahora inicia una ejecución de inmediato. Solo hay una ejecución en vuelo por agente; si hay una abierta, Ejecutar ahora espera.
• Editar abre el constructor. Los cambios se aplican desde la siguiente ejecución. Cambiar los conectores de un agente reescribe su briefing para el nuevo servicio, y esa reescritura se cobra como cualquier llamada al modelo.
• Duplicar crea una copia, gratis.
• Eliminar pide confirmación dos veces. Borra el agente, sus versiones, su historial de ejecuciones y su memoria. Las conversaciones y tu historial de facturación se conservan. Un agente con una ejecución en curso no puede eliminarse hasta que termine.

Un agente que se pausó automáticamente porque caducó un conector te lo indica en su fila. Vuelve a conectar para reanudarlo, o pulsa el interruptor para reanudarlo de todos modos.

Qué cuesta

Todo se descuenta del mismo saldo de créditos que el resto de la plataforma, y las cifras siguientes son las vigentes al escribir esto.

• Añadir desde la biblioteca, duplicar, editar y cambiar un horario: gratis.
• Compilar desde un briefing: el coste del modelo para compilarlo, nada encima.
• Una ejecución: las llamadas al modelo que hace, más una pequeña tarifa de cómputo que es una fracción de céntimo incluso en una ejecución pesada. Las ejecuciones de prueba y las de aprobación se cobran igual. Una ejecución se detiene si supera el límite por ejecución, actualmente 2,00 $.
• Búsqueda web: actualmente 0,01 créditos por consulta.
• X (Twitter): X cobra por llamada a la API, y eso se traslada con el doble de su tarifa: actualmente 0,01 créditos por lectura y 0,03 por escritura.
• Cualquier otra llamada a un conector: sin tarifa por llamada.

El gasto acumulado del mes de cada agente aparece en su fila de la pestaña Agentes, y el coste de cada ejecución está en el Registro de ejecuciones. Si el saldo está vacío, las compilaciones se rechazan y las ejecuciones fallan con *no_credits*; un cliente que intenta una tarea de chat simplemente recibe el aviso de que no está disponible. Las ejecuciones que fallan por un fallo de la plataforma se abonan automáticamente.

Límites que conviene conocer

• 30 agentes por bot. Archiva o elimina uno para hacer sitio.
• Una sola ejecución en vuelo por agente a la vez.
• Una ejecución se detiene sola cuando no avanza: la misma llamada con los mismos argumentos tres veces, o cuatro acciones seguidas que se rechazan o fallan. Se cierra como fallida y el Registro de ejecuciones indica en qué llamada quedó atascada.
• Tareas llamables desde el chat: de 1 a 10 ejecuciones por cliente cada 24 horas, configurables por agente.
• Agentes activados por webhook: como máximo diez ejecuciones abiertas en cola; los envíos adicionales se rechazan hasta que termine una. Los cuerpos de solicitud se cortan a los 4 KB; lo que pase de ahí no se entrega al agente.
• Llamadas telefónicas: 15 minutos cada una.
• Una ejecución se detiene tras unos 15 minutos.
• Una actualización de la base de conocimiento: una vez por agente cada 24 horas.

Si alguno de estos límites interfiere con trabajo real, escribe a support@proxyai.app e indica qué límite alcanzas y qué intentas hacer. Son características del sistema y no una ración; preferimos conocer el caso antes que verte rodear el límite.

Privacidad y retención

Los agentes nunca guardan tus credenciales: las llamadas a conectores pasan por la plataforma, que añade las credenciales en el camino de salida. El registro de pasos que ves se escribe después de enmascarar los datos personales, y no se conservan las páginas ni las respuestas de API en bruto que haya obtenido un agente. La auditoría detallada de las llamadas a conectores se purga a los 90 días. Los mensajes propuestos de una ejecución retenida se eliminan en cuanto la apruebas o rechazas, o cuando caduca; las vistas previas de las ejecuciones de prueba se conservan 24 horas para que puedas revisarlas.

En las tareas llamadas por clientes, recuerda que el agente repetirá lo que pueda leer. Limita esos agentes de forma estricta.

Por qué una tarjeta dice «Próximamente»

Un botón Próximamente en un conector significa que el código está listo, pero el proveedor todavía no ha aprobado nuestra app, o la conexión no está activada para la plataforma. Algunos proveedores revisan cada app que pide acceso; Google, por ejemplo, revisa las apps que leen calendarios, analítica o comentarios de YouTube, y Meta revisa las apps que gestionan anuncios o páginas.

Hasta que pase una revisión, puedes ver una pantalla de advertencia del proveedor durante la conexión, o la tarjeta se queda en Próximamente. Nada de tu parte lo desbloquea; la tarjeta cambia a Conectar en el momento en que esté activo, sin necesidad de actualizar.

Soluciones rápidas

• La tarjeta sigue diciendo «Conectar» pero estoy seguro de que está conectada: en los canales de chat, la conexión viene de la configuración del bot; revisa Configuraciones → Canales. Si el canal está activo allí, recarga la consola.
• Conectar me lleva al proveedor y de vuelta con un error: la causa más habitual es un ajuste del proveedor que aún no se ha propagado. Inténtalo otra vez tras un minuto; si persiste, contacta con soporte indicando el nombre del proveedor.
• Mi agente está pausado y yo no lo pausé: un conector que usa ha caducado. La fila indica cuál. Vuelve a conectar en la pestaña Conectores.
• El agente se ejecutó pero no se envió nada: revisa el Registro de ejecuciones. Lo más probable es que esté RETENIDO esperando tu aprobación, o que la ejecución haya llegado a la barrera «pedirme confirmación antes de enviar a más de N personas», y el resto esté esperando ahí.
• Un cliente dice que la tarea del chat «no está disponible»: ha usado su cupo del día, el agente está pausado o el saldo está vacío.
• Quiero ver el código: no hay código que ver. El plan que aparece tras compilar y el registro de pasos tras una ejecución son toda la historia.