Prácticas recomendadas para la elaboración de instrucciones de agentes de ClickUp

Este artículo muestra cómo escribir buenos prompts para los Super Agents de ClickUp.

¿Es la primera vez que usas los Super Agents? Lee nuestro artículo ¿Qué son los Super Agents? antes de empezar.

La disponibilidad de funciones y los límites varían según el plan y el rol del usuario. Más información

Existen consideraciones de privacidad, seguridad y permisos que solo se aplican a los Super Agents. Más información

Para usar los Super Agents, tienes que activar el ClickApp de IA en tu Entorno de trabajo.

¿Es la primera vez que usas los Super Agents? Lee nuestro artículo ¿Qué son los Super Agents? antes de empezar.

Configurar manualmente un Super Agent

¡Asegúrate de tener toda la información necesaria! Aprende a configurar manualmente tu Super Agent, incluida la introducción del prompt.

Los Super Agents también se pueden crear en nuestro generador de Super Agents en lenguaje natural.

Captura de pantalla del generador de Super Agents mientras procesa

Los fragmentos de prompt que se describen a continuación están divididos en secciones. En cada sección encontrarás un ejemplo de un buen prompt y un prompt optimizado.

Rol y objetivo

Los Super Agents de ClickUp son como compañeros de trabajo. Puedes asignarles un rol o una personalidad y darles tareas. Imagínalos como un empleado nuevo o alguien que acaba de incorporarse a su puesto.

Buen prompt Prompt optimizado
Eres un agente de contenido e información especializado en identificar las funciones de producto recién publicadas y transformarlas en resúmenes claros y convincentes, en un lenguaje sencillo, junto con enfoques de venta dirigidos a jóvenes profesionales entusiasmados con la nueva tecnología, aunque puedan no tener conocimientos técnicos. Eres un agente perspicaz y creativo especializado en identificar las funciones de producto recién publicadas, recopilar información sobre esas funciones y transformar esa información en enfoques de venta convincentes dirigidos a jóvenes profesionales entusiasmados con la nueva tecnología, aunque puedan no tener conocimientos técnicos.

GIF de un prompt optimizado

¿Por qué es mejor el prompt optimizado?

El prompt optimizado usa un lenguaje rico. Por ejemplo, «Eres un agente perspicaz y creativo».

  • El lenguaje rico aporta al Super Agent matices y contexto para tareas que requieren razonamiento subjetivo, deducción o síntesis de tipo humano.

El prompt optimizado usa el mismo término para mantener la coherencia y lo repite para que el Super Agent no tenga que deducir ninguna información. Por ejemplo, «especializado en identificar las funciones de producto recién publicadas, recopilar información sobre esas funciones y transformar esa información de función».

  • Mantener la coherencia en los términos y reducir la necesidad de inferencia reserva la capacidad de procesamiento del Super Agent para la tarea principal.

Alcance

Esta parte del prompt introduce al Super Agent en el alcance de su tarea.

Buen prompt Prompt optimizado
Cada semana, recopila el trabajo de funciones completado en todo el Entorno de trabajo durante los últimos 7 días.
Excluye las correcciones de errores evidentes, las tareas de mantenimiento, las refactorizaciones o las tareas solo internas cuando se identifiquen mediante el título o las etiquetas.
Cada semana, recopila el trabajo de funciones completado en todo el Entorno de trabajo durante los últimos 7 días.
Céntrate en las nuevas funciones de producto excluyendo las correcciones de errores evidentes, las tareas de mantenimiento, las refactorizaciones o las tareas solo internas cuando se identifiquen mediante el título o las etiquetas.

¿Por qué es mejor el prompt optimizado?

El prompt optimizado usa instrucciones positivas en lugar de negativas. Por ejemplo, «Céntrate en las nuevas funciones de producto excluyendo las correcciones de errores evidentes, las tareas de mantenimiento, las refactorizaciones o las tareas solo internas cuando se identifiquen mediante el título o las etiquetas».

  • Cuando empiezas la frase diciéndole al Super Agent que «excluya las correcciones de errores evidentes», dedica su capacidad de procesamiento a pensar en errores en lugar de a encontrar nuevas funciones de producto.
  • Empezar con una instrucción positiva, «Céntrate en las nuevas funciones de producto», permite que el Super Agent dedique su capacidad de procesamiento a encontrar nuevas funciones de producto en lugar de centrarse en los errores.

Próximos pasos

Indícale al Super Agent qué herramientas debe usar. Por ejemplo, para buscar nuevas funciones de producto, el Super Agent necesitará acceso a todo o parte de tu Entorno de trabajo.

Más información sobre cómo crear Super Agents en ClickUp.

En tu prompt, indícale al Super Agent cómo usar la herramienta. Por ejemplo, puedes decirle al Super Agent: «Asegúrate de que existe una tarea llamada "Funciones de producto semanales"; si no la encuentras, créala con la herramienta de creación de tareas».

Más información sobre el uso de las herramientas de IA de Brain.

Orientación sobre la redacción

Esta parte del prompt le indica al Super Agent qué debe producir a partir de la información que ha recopilado.

Buen prompt Prompt optimizado
Proporciona entre 1 y 3 enfoques de venta impactantes por función, usando un lenguaje orientado a la acción y beneficios concretos. Proporciona entre 1 y 3 enfoques de venta impactantes por función, usando un lenguaje orientado a la acción y beneficios concretos.
Usa la información de las funciones que has recopilado para reflexionar sobre cómo podrían beneficiar o entusiasmar a clientes jóvenes y aficionados a la tecnología que no provienen de un entorno técnico.
Escribe con un lenguaje impactante y orientado a la acción que transmita una imagen atractiva y emocionante de cómo vender cada función.

GIF de otro prompt optimizado

¿Por qué es mejor el prompt optimizado?

El prompt optimizado muestra causa y efecto de forma eficiente. Por ejemplo, «Destila la información de las funciones que has recopilado en enfoques de venta de alto impacto que respondan directamente a las necesidades de los clientes».

  • Este tipo de lenguaje es útil cuando el Super Agent no aprovecha suficientemente algún elemento de tu prompt en su resultado.

El prompt optimizado usa la relación causa-efecto para pedirle al Super Agent que transforme la información recopilada en su resultado. Por ejemplo, «Usa la información de las funciones que has recopilado para reflexionar sobre cómo podrían beneficiar o entusiasmar a clientes jóvenes y aficionados a la tecnología que no provienen de un entorno técnico».

  • Usa este tipo de lenguaje cuando el Super Agent se quede atascado en una parte de tu prompt.

El prompt optimizado incluye otro ejemplo de lenguaje rico: «Escribe con un lenguaje impactante y orientado a la acción que transmita una imagen atractiva y emocionante de cómo vender cada función».

  • Usa este tipo de lenguaje para obtener exactamente el resultado que buscas.

Formato de salida

Esta parte del prompt funciona como una plantilla que le indica al Super Agent cómo dar formato a su resultado.

Buen prompt Prompt optimizado
Entradas de función:
Nombre: (título de la tarea)
Fuente: Enlace a la tarea
Qué es: Explicación en lenguaje sencillo de 1 o 2 frases
Formato de las entradas de función:
Nombre: (título de la función)
Fuente: Enlace a la tarea sobre la función
Qué es la función: (Explica de forma concisa qué es la función, cómo funciona y cómo encaja en el producto en su conjunto.)

¿Por qué es mejor el prompt optimizado?

Ambos prompts proporcionan una plantilla con paréntesis. El Super Agent sabrá que debe sustituir el marcador de posición por el contenido que ha recopilado. Por ejemplo, «Nombre: (título de la función)».

El prompt optimizado es mucho más descriptivo. Por ejemplo, «Qué es la función: (Explica de forma concisa qué es la función, cómo funciona y cómo encaja en el producto en su conjunto)».

  • Usa el formato de salida cuando el Super Agent se beneficie de una guía en lugar de determinar el formato por sí mismo. Por ejemplo, informes estructurados, procedimientos operativos estándar o artículos de blog.

Siguiente paso

Para reforzar la estructura que buscas, puedes añadir un resumen al final de esta sección. Por ejemplo:

«Formato de salida: Produce contenido en Markdown pulido y listo para publicar en la página semanal. Usa párrafos cortos y listas con viñetas. Mantén cada entrada de función por debajo de unas 120 palabras, sin contar las viñetas».

Usa delimitadores para etiquetar las secciones del prompt

Cuando tu prompt incluya material de referencia, como directrices de marca, descripciones de producto o contenido de ejemplo, etiqueta dónde empieza y termina cada sección.

Buen prompt Prompt optimizado
Directrices de marca:
1 Usa frases cortas.
2 Evita el lenguaje técnico.
3 Empieza siempre por el beneficio.

Descripción del producto:
Un Super Agent que garantiza que todos siguen las directrices de marca.
Directrices de marca:
1 Usa frases cortas.
2 Evita el lenguaje técnico.
3 Empieza siempre por el beneficio.
--fin de las directrices de marca--

Descripción del producto:
Un Super Agent que garantiza que todos siguen las directrices de marca.
—fin de la descripción del producto—

¿Por qué es mejor el prompt optimizado?

El prompt optimizado usa delimitadores para marcar explícitamente dónde termina cada sección. Esto elimina la ambigüedad y permite que el Super Agent pase limpiamente de una sección a la siguiente sin tener que hacer suposiciones.

Puedes dar formato a los delimitadores como prefieras, siempre que seas coherente a lo largo de todo el prompt. Algunas opciones:

  • --fin de [nombre de sección]--
  • Etiquetas XML: <brand_guidelines> Tu contenido aquí </brand_guidelines>
    • Las etiquetas XML son un formato de delimitador especialmente eficaz. Los modelos de IA suelen interpretar estos límites de forma fiable.
  • Guiones u otros separadores visuales

Evita las abreviaturas y el lenguaje vago

Los Super Agents no comprenden el lenguaje abreviado tan bien como los humanos. Reserva su capacidad de procesamiento para obtener mejores resultados.

Buen prompt Prompt optimizado
Mira el documento y escribe algo para las redes sobre la nueva función. Lee el resumen del producto y escribe una publicación en redes sociales para anunciar la nueva función de programación. Céntrate en el beneficio para los equipos remotos.

¿Por qué es mejor el prompt optimizado?

El prompt optimizado reemplaza los términos vagos por otros específicos, lo que mantiene al Super Agent centrado en la tarea en lugar de interpretar abreviaturas o un lenguaje impreciso.

Usar instrucciones positivas o negativas

Si la instrucción es una regla clara, como «no uses signos de exclamación», una instrucción negativa funciona bien. Si la instrucción tiene que ver con el tono, el estilo o el criterio, reescríbela como una instrucción positiva.

Incluso con reglas objetivas, evita usar demasiadas instrucciones negativas en un único prompt.

Buen prompt Prompt optimizado
No omitas ninguna información del texto original. Conserva toda la información del texto original.

Usa lenguaje integrativo y transformativo

Si tu Super Agent no aprovecha suficientemente un recurso que has proporcionado, o copia en exceso parte de tu entrada, usa lenguaje integrativo o transformativo.

Lenguaje integrativo

Si tu Super Agent no aprovecha suficientemente un recurso que has proporcionado, usa lenguaje integrativo.

El lenguaje integrativo es muy compacto y usa proposiciones subordinadas para vincular estrechamente la entrada y la tarea.

Buen prompt Prompt optimizado
Toma los enfoques de marketing y escribe una publicación en redes sociales. Usa los enfoques de marketing para escribir una publicación en redes sociales.

Lenguaje transformativo

Si tu Super Agent copia en exceso parte de tu entrada, como reproducir literalmente una descripción de producto en lugar de reinterpretarla, usa lenguaje transformativo.

El lenguaje transformativo se centra en palabras que implican cambio y desglosa la acción en varios pasos.

Buen prompt Prompt optimizado
Convierte la descripción del producto en una canción. Toma los conceptos y los detalles más llamativos de la descripción del producto y reimagínalos como una canción.

Divide los prompts complejos

Divide los prompts complejos para mejorar la calidad del resultado.

Si un prompt le pide a un Super Agent que haga dos cosas muy distintas, como extraer detalles técnicos de un documento y luego convertirlos en textos de marketing pulidos, divide el prompt.

Buen prompt Prompt optimizado
Convierte la descripción del producto en una canción. Paso 1: Extrae los detalles técnicos clave de este documento y enuméralos.
Paso 2: Usando los detalles extraídos, escribe un resumen para el cliente en un tono informal.

¿Por qué es mejor el prompt optimizado?

El prompt se divide en dos pasos claros con un lenguaje detallado.

Añade estructura a los prompts largos

Usa el siguiente esquema para mejorar el resultado de los prompts más largos:

Sección Qué incluir Ejemplo
Contexto El rol del Super Agent, el contexto de la tarea y cualquier factor que la complique. Eres un especialista en marketing de producto. La semana pasada lanzamos una nueva función y necesitamos hacer un seguimiento con los clientes existentes.
Recursos Cualquier material de referencia que vaya a usar el Super Agent. Etiqueta el inicio y el final de cada recurso. Añade un resumen del producto, datos de segmentos de clientes, directrices de marca o cualquier recurso que necesite tu Super Agent. Usa delimitadores para etiquetarlos.
Instrucciones detalladas Reglas, parámetros, casos límite y estructura del resultado. Escribe en un tono informal. Mantén cada sección por debajo de 100 palabras. Si una función no tiene datos de clientes, indícalo como TBD.
Instrucción final Una frase de cierre que reformule la tarea principal. Escribe el correo electrónico de seguimiento usando el resumen del producto y las directrices de marca.

Gestiona varios escenarios

Algunos prompts de Super Agents gestionan varias situaciones diferentes.

Si la lógica es sencilla, usa un lenguaje natural de tipo si/entonces. Por ejemplo: «Si la tarea tiene una fecha de vencimiento, inclúyela en el resumen. Si no la tiene, omite la línea de fecha de vencimiento».

Si tu prompt tiene varias rutas posibles, o si una de ellas consiste en no realizar ninguna acción, define todos los escenarios posibles desde el principio. Indícale al Super Agent que elija uno antes de ejecutarlo.

Buen prompt Prompt optimizado
Elimina cualquier información de identificación personal (PII) del texto. Si no hay PII, devuelve el texto original. Tu tarea es eliminar la PII de un fragmento de texto. Determina qué escenario corresponde antes de continuar:
Escenario 1: El texto contiene PII que se puede eliminar sin alterar el significado. Elimina la PII y conserva todo lo demás.
Escenario 2: El texto contiene PII, pero parte de ella no se puede eliminar sin alterar el significado. Elimina lo que puedas y reemplaza el resto con [PLACEHOLDER].
Escenario 3: El texto no contiene PII. Devuélvelo tal como estaba originalmente. Determina qué escenario corresponde y sigue las instrucciones de ese escenario.

¿Por qué es mejor el prompt optimizado?

El prompt optimizado obliga al Super Agent a comprometerse primero con una ruta, de modo que las demás opciones no consuman capacidad de procesamiento durante la ejecución.

Consejos adicionales

Si has seguido los pasos anteriores y tu Super Agent no funciona como esperabas, asegúrate de:

  • Proporcionar los datos clave directamente en el prompt en lugar de esperar que el Super Agent los encuentre.
  • Añadir flexibilidad a las plantillas que uses. Por ejemplo: «Si esta información no está disponible, escribe "N/D" u omite cualquier sección que no se pueda completar con la información proporcionada».
  • Limitar el contexto. Por ejemplo: «El resumen del producto es toda la información con la que cuentas».

Perfecciona tu Super Agent

Una vez que hayas escrito el prompt perfecto, aprende a perfeccionar tu Super Agent.