Crear un agente de IA – PlanRadar HelpCenter

Visión general

Configure un agente de IA que reaccione a la actividad en uno de sus proyectos y que cree tickets, añada comentarios o envíe correos electrónicos sin que nadie lo inicie.

Acceso y permisos

Agentes de IA solo está disponible en la Webapp.

Necesita un usuario interno con el permiso de usuario Agentes de IA. Agentes de IA no está disponible para subcontratistas ni observadores.

La página Configuración necesita un usuario interno con el permiso de usuario Account. Los propietarios de la cuenta siempre lo tienen.

Más información en Permisos.

Las ejecuciones de agentes consumen su límite de uso de IA, el mismo límite que el asistente de IA. Más información en Límites de uso de IA y actualizaciones.

Más información sobre Privacidad y seguridad para las funciones de IA.

Vea cómo funciona

Dónde encontrar sus agentes

Haga clic en Agentes de IA en la barra lateral.

Página	Qué muestra
Agentes	Todos los agentes de la cuenta con su estado, su proyecto, quién los creó y cuándo se ejecutaron por última vez.
Agentes archivados	Los agentes que se archivaron. Nunca se ejecutan y no se pueden volver a activar.
Registro de actividades	Las ejecuciones de todos los agentes de la cuenta.
Configuración	Los ajustes de cuenta para Agentes de IA. Necesita el permiso de usuario Account.

Qué necesita un agente antes de poder ejecutarse

Cuatro elementos. El panel Probando junto al agente los enumera y marca cada uno en cuanto lo completa.

Elemento	Para qué sirve
Instrucciones	Lo que quiere que haga el agente, descrito con sus propias palabras.
Proyecto	El único proyecto en el que se ejecuta el agente. Nunca lee nada fuera de él.
Disparadores	Los eventos que inician una ejecución, por ejemplo la creación de un ticket.
Acciones	Lo que el agente puede escribir.

Hasta que los cuatro elementos estén listos, puede guardar el agente, pero no puede probarlo ni activarlo.

Empezar con una plantilla

Su cuenta incluye cuatro agentes listos para usar, cada uno ya redactado. Cambie cualquier parte antes de activarlo.

Plantilla	Para qué sirve
Verificador de la integridad de los tickets	Se señalan los nuevos tickets a los que les faltan campos obligatorios o fotografías.
Detector de tickets duplicados	Señala los tickets que probablemente sean duplicados cuando se crea uno nuevo.
Tarea de verificación sobre la resolución	Crea un subticket de verificación cuando se resuelva un ticket.
Asistente para respuesta de documentos	Elabora un borrador de respuesta a partir de la documentación del proyecto cuando se crea un ticket de consulta.

Haga clic en Agentes de IA en la barra lateral.
Haga clic en Crear un nuevo agente.
En Nuestras plantillas, haga clic en una plantilla.
Revise el Nombre del agente, la Descripción y las Instrucciones, y cámbielos si lo desea.
En Proyectos, haga clic en Añadir y elija el proyecto en el que se ejecuta el agente.
Revise el disparador y las acciones. Haga clic en Editar en cualquiera de los dos para cambiarlo.
En el panel Probando, haga clic en Prueba de funcionamiento y lea lo que habría hecho el agente.
Haga clic en Activar agente.

Describa su propio agente

No tiene que empezar con una plantilla. En el paso Explica puede escribir lo que quiera con sus propias palabras.

Haga clic en Agentes de IA en la barra lateral y luego en Crear un nuevo agente.
En Instrucciones, describa lo que debe hacer el agente, por ejemplo: cuando se cree un ticket sin fecha de vencimiento, añade un comentario para pedirla.
Haga clic en Siguiente.
En el paso Configura, haga clic en Añadir en Proyectos, Disparadores y Acciones, uno tras otro.
Haga clic en Revisa y prueba.
Dé un nombre al agente. La descripción es opcional.
En el panel Probando, haga clic en Prueba de funcionamiento.
Haga clic en Activar agente.

Haga clic en Reescribe con IA debajo de las instrucciones para que se mejore su redacción. Conserve el resultado, deshágalo o escriba su propia versión.

Haga clic en Guardar como borrador en cualquier momento para continuar más tarde. Un borrador nunca se ejecuta.

Disparadores

Un agente se ejecuta cuando uno de sus disparadores se produce en su proyecto. Un agente puede tener más de un disparador.

Disparador	Ejecuta el agente cuando
Ticket creado	Alguien crea un ticket.
Ticket actualizado	Alguien cambia un ticket.
Comentario añadido al ticket	Alguien añade un comentario a un ticket.
Archivo cargado	Alguien carga un archivo en Documentos.
Nueva versión del archivo	Alguien carga una nueva versión de un archivo en Documentos.

Los disparadores de ticket se pueden limitar a formularios y capas concretos. Los disparadores de archivo se pueden limitar a carpetas concretas de Documentos.

Los agentes no se ejecutan según una programación, y no puede iniciarlos desde el asistente de IA.

Acciones

Un agente siempre puede leer los tickets y los documentos de su proyecto. Así es como responde a una pregunta o comprueba si hay un duplicado, y no tiene que activarlo. Las acciones definen lo que el agente puede escribir, y las añade usted.

Un agente puede usar cada acción una sola vez.

Acción	Lo que usted define	Lo que decide el agente
Crear ticket	Formulario, capa, asignado, prioridad, estado y título. Solo el formulario es obligatorio.	El contenido del ticket, y si se crea alguno.
Añadir comentario	Nada.	El texto del comentario, y si se comenta.
Enviar correo electrónico	A, CC y Asunto, todos opcionales.	El contenido del correo, y si se envía.

En Crear ticket, elija primero el formulario. El formulario determina los campos que tiene un ticket, por lo que los demás ajustes permanecen desactivados hasta que seleccione un formulario, y un campo que el formulario no incluye permanece desactivado.

En Enviar correo electrónico, puede elegir los destinatarios en la acción o nombrar a una persona en las instrucciones. Los destinatarios elegidos en la acción tienen prioridad.

Un agente solo puede enviar correos a los miembros activos de su propio proyecto. Las direcciones externas no son posibles.

Pruebe antes de activar

Una prueba hace todo lo que hace una ejecución real, salvo escribir. El agente lee los mismos datos y toma las mismas decisiones, y el resultado le muestra lo que habría creado, comentado o enviado. En su proyecto no se crea ni se cambia nada. Una prueba funciona en un borrador y en un agente que ya está activo o en pausa.

Prueba de funcionamiento aparece en el panel Probando en cuanto el agente tiene instrucciones, un proyecto, un disparador y una acción. Antes de eso, el panel le indica qué falta.

La prueba se ejecuta con un elemento real del proyecto, seleccionado automáticamente. Si nada en el proyecto coincide con el disparador, la prueba no devuelve datos en lugar de un resultado.
Puede probar los cambios antes de guardarlos. El agente vuelve después a sus ajustes guardados.
Las pruebas aparecen en el historial de ejecuciones junto a las ejecuciones reales, marcadas como pruebas.

Una prueba consume su límite de uso de IA, igual que una ejecución real. Si la cuenta ha alcanzado su límite, las pruebas vuelven a estar disponibles cuando el límite se renueva.

Active el agente

Haga clic en Activar agente. El agente aparece como Activo en la lista y se ejecuta desde ese momento cada vez que se produce un disparador. Póngalo en pausa en cualquier momento y dejará de ejecutarse hasta que alguien lo vuelva a activar.

Solo la persona que creó un agente puede volver a activarlo después de una pausa. Un agente archivado no se puede volver a activar.

Consulte lo que hizo un agente

Cada ejecución se registra. Abra un agente y luego una ejecución para ver qué leyó el agente, qué decidió y qué escribió. Registro de actividades muestra las ejecuciones de todos los agentes de la cuenta.

Una ejecución puede terminar sin que el agente haga nada. Es un resultado normal, no un fallo, y la ejecución lo indica: "Your agent reviewed this event and decided no action was needed."

La persona que creó el agente y el propietario de la cuenta ven todos los detalles de cada ejecución. Los demás ven que la ejecución se produjo.

Cuando un agente se pone en pausa por sí mismo

Un agente se pone en pausa por sí mismo en estos casos. Recibe una notificación, y el agente permanece en pausa hasta que la persona que lo creó lo vuelve a activar.

Su cuenta alcanzó su límite de uso de IA. El agente no se reinicia por sí mismo cuando el límite se restablece.
Las ejecuciones fallaron repetidamente porque el contenido enviado al modelo de IA era demasiado grande. Acorte las instrucciones, o dirija el agente a formularios más pequeños o a menos documentos.
El agente alcanzó su límite de acciones en una sola ejecución.
El proyecto del agente se archivó o se eliminó.
El propietario del agente se estableció como inactivo, perdió el permiso de usuario Agentes de IA o perdió el acceso al proyecto.
Se iniciaron demasiadas ejecuciones en poco tiempo.

Tenga en cuenta

Los agentes crean tickets, añaden comentarios y envían correos electrónicos. No cambian ni eliminan tickets, documentos o planos existentes.
El agente decide si actúa. Dos ejecuciones en tickets parecidos pueden terminar de forma distinta.
Cada agente tiene su propio usuario en su cuenta. Todo lo que escribe aparece con ese usuario en el historial del ticket.

Este contenido se ha generado con la ayuda de inteligencia artificial y puede contener imprecisiones. Por favor, revise y verifique la información antes de utilizarlo.

Ajustes de cuenta para Agentes de IA

La página Configuración contiene tres ajustes para toda la cuenta, no por usuario. Necesita un usuario interno con el permiso de usuario Account.

Ajuste	Para qué sirve
Instrucciones globales	Instrucciones que se aplican a cada ejecución de agente en la cuenta, además de las instrucciones propias de cada agente. Elija una sugerencia como punto de partida o escriba las suyas, y use Reescribe con IA para mejorar la redacción. La página muestra quién las cambió por última vez y cuándo.
Notificaciones	Dos interruptores para toda la cuenta: avisar cuando falla una ejecución de agente, y avisar cuando un agente se pone en pausa.
Permisos	Todas las personas de la cuenta que pueden usar Agentes de IA, con un campo de búsqueda y un recuento. Haga clic en el icono de lápiz junto a una persona para abrir sus ajustes de usuario.

FAQ

¿Puede un agente cambiar un ticket?

No. Un agente puede crear un ticket, comentarlo y enviar un correo electrónico. No puede editar ni eliminar nada.

¿Puede un agente abarcar varios proyectos?

No. Un agente se ejecuta en un solo proyecto. Cree un segundo agente para un segundo proyecto.

¿Pueden los subcontratistas o los observadores crear agentes?

No. Agentes de IA solo está disponible para usuarios internos.

¿Por qué todavía no puedo probar mi agente?

Prueba de funcionamiento aparece en cuanto el agente tiene instrucciones, un proyecto, un disparador y una acción. El panel Probando indica cuál de los cuatro falta todavía.

¿Puedo probar un cambio antes de guardarlo?

Sí. La prueba usa lo que hay en la pantalla, y el agente vuelve después a sus ajustes guardados.

¿En nombre de quién actúa el agente?

Cada agente tiene su propio usuario en su cuenta. Todo lo que escribe aparece con ese usuario en el historial del ticket, por lo que siempre puede distinguir lo que hizo un agente de lo que hizo una persona.

Un compañero puso un agente en pausa. ¿Por qué no puedo volver a activarlo?

Solo la persona que creó un agente puede volver a activarlo después de una pausa.