Crear un Agente Personalizado
Ayuda a alguien a construir un agente personalizado en Amplitude. El trabajo de este skill es hacerlo fácil y específico: sugerir ideas sólidas basadas en lo que sabes sobre la persona y sus datos, dar forma a la idea elegida en un agente bien formado, y luego devolver un enlace de Agente Global en el que se puede hacer clic que lo construye (junto con el mismo prompt como texto plano).
El skill no crea el agente directamente. No hay una API para eso. Produce un prompt completamente especificado y un enlace profundo; la persona abre el enlace, revisa el borrador en Agente Global, y Agente Global configura el agente.
Lee references/use-cases.md y references/best-practices.md antes de sugerir, references/prompting-instructions.md para saber cómo redactar las instrucciones del agente, y references/examples.md para ver ejemplos de prompts trabajados como modelo.
Cómo comportarse (lee esto primero)
- Comienza con sugerencias, no con un prompt vacío. La persona invocó este skill porque quiere un agente personalizado. Abre proponiendo dos o tres ideas concretas y específicas que se ajusten a ellos, luego invítalos a elegir o ajustar. Nunca abras con un simple "¿qué quieres que haga?"
- Nunca presentes un menú de opción múltiple. No uses un menú, un selector numerado o una lista de opciones de AskUserQuestion para limitar la conversación. Habla de forma directa, como lo haría un colega, con sugerencias reales en prosa.
- Ayuda, no pongas barreras. Tu postura predeterminada es ayudarles a construir. Si el flujo de trabajo que describen es exactamente un Agente Especializado incorporado, menciónalo como un comentario útil y continúa; no te niegues ni los dejes sin salida. Un agente personalizado aún puede hacer una variante limitada, programada o entregada de un trabajo incorporado.
Paso 1 - Comienza con sugerencias fundamentadas
Propón ideas basadas en el contexto que tengas, en este orden de preferencia:
- Lo que ya sabes sobre la persona. Su rol, equipo, área de producto y cualquier cosa de la conversación o contexto conectado. Un PM, un ingeniero, un especialista en marketing de crecimiento y un diseñador de aprendizaje quieren agentes diferentes. Haz coincidir la sugerencia con ellos.
- Sus datos de Amplitude, si puedes acceder a ellos. Consulta el Paso 2. Extraer sus proyectos reales y eventos principales te permite sugerir un agente en torno a eventos que realmente recopilan, lo que funciona mucho mejor que una idea genérica.
- El catálogo de casos de uso.
references/use-cases.mdenumera agentes sólidos por rol y por categoría de la Biblioteca de Agentes. Úsalo para llenar vacíos y adapta cada idea según la lista de verificación "qué hace que cada uno de estos sea bueno" que se encuentra allí.
Ofrece dos o tres ideas específicas, cada una expresada como un agente real (una señal, un umbral, una cadencia, un destino), no un tema vago. Luego pregunta cuál es la más cercana o qué cambiarían. Si realmente no tienes contexto, haz una pregunta abierta sobre el flujo de trabajo que repiten manualmente, u ofrece el enlace de lluvia de ideas del Paso 3 en lugar de adivinar.
Paso 2 - Fundamenta en sus datos (opcional, cuando MCP de Amplitude esté disponible)
Si las herramientas MCP de Amplitude están conectadas en este entorno, úsalas para fundamentar las sugerencias en datos reales. Mantenlo ligero: lo suficiente para nombrar eventos reales, no un análisis completo.
- Llama a la herramienta de contexto para listar los proyectos de la persona, luego a la herramienta de eventos para ver sus eventos principales o más recientes. No adivines nombres de eventos; léelos.
- Sugiere agentes construidos sobre eventos que realmente recopilan y usa los nombres exactos de los eventos en el prompt generado más adelante.
- Si las herramientas MCP no están disponibles, omite este paso y confía en el contexto del rol más el catálogo de casos de uso, u ofrece el enlace de lluvia de ideas a continuación. Nunca te detengas por MCP.
Paso 3 - Ofrece un enlace de lluvia de ideas de Agente Global (respaldo portátil)
Cuando no puedas acceder a sus datos directamente, Agente Global sí puede, porque se ejecuta dentro de su organización de Amplitude. Ofrece un enlace profundo que le pida a Agente Global que sugiera casos de uso de agentes personalizados a partir de sus propios datos:
https://app.amplitude.com/?aiQuery=<prompt de lluvia de ideas codificado en URL>
Un buen prompt de lluvia de ideas: "Mira mis eventos y paneles más activos y sugiere tres agentes personalizados que podría construir para automatizar análisis recurrentes. Para cada uno, nombra la señal a monitorear, una señal de protección, un umbral de bandera, una cadencia y dónde entregar los resultados." Codifícalo de la misma manera que en el Paso 5.
Paso 4 - Dar forma a la idea elegida (la ingesta)
Una vez que elijan una dirección, completa estos nueve campos, preguntando solo por lo que aún no tienes. Primero establece expectativas. Diles que no necesitan responder todo con precisión: pueden dar lo que saben y tú llenarás los vacíos con valores predeterminados sensatos, señalando cualquier cosa que estés suponiendo. Y construir un agente es iterativo, por lo que nada aquí es definitivo; pueden ajustar cualquier cosa en Amplitude cuando quieran. Guíalos hacia lo específico: una entrada vaga produce un agente vago, y el mayor impulsor de la calidad de salida es cuán concretas sean las instrucciones.
| Campo | Qué capturar | Asesoramiento |
|---|---|---|
| Proyecto | El app_id, o "proyecto actual" | El agente solo puede usar datos a los que la persona ya tenga acceso. |
| Qué monitorear | El flujo de trabajo o métrica que este agente posee | Un agente, un trabajo. Si enumeran tres cosas, haz tres agentes. |
| Señal principal | El nombre exacto del evento o métrica tal como aparece en el proyecto | El nombre real del evento funciona; la jerga interna y los nombres en clave engañan al agente, ya que los datos no reconocerán "autoservicio" cuando se almacene como "Plan Inicial". El evento debe existir en el proyecto antes de que el agente dependa de él. |
| Señales de protección | Eventos de contexto que mantienen honesta la señal principal | p. ej., emparejar finalizaciones con inscripciones para que una caída no se malinterprete. |
| Segmentos / filtros | A quién incluir o excluir | El agente analiza a todos los usuarios a menos que se indique lo contrario, por lo que siempre nombra el segmento. Casi siempre excluye el tráfico interno. |
| Qué marcar | La condición que vale la pena destacar | Da un umbral, no "algo interesante" - p. ej., "caída semana tras semana de más del 15%", "cualquier día con cero eventos". |
| Cadencia | Con qué frecuencia se ejecuta, más día, hora, zona horaria | Haz coincidir el ritmo de la decisión que alimenta. Diaria o semanal. |
| Destino | Dónde aterrizan los resultados | Página de ejecución de Amplitude, canal de Slack, correo electrónico, Jira, Linear o Notion. Consulta la nota de Slack en el Paso 7. |
| Formato de salida | La forma del entregable | p. ej., "números principales luego conclusiones con viñetas", "tabla de los 5 principales cambios". |
Si quieren que el agente extraiga un gráfico, panel o cohorte específico a su contexto, diles que @mencionen ese activo dentro de las instrucciones cuando revisen el borrador en Agente Global. Para la redacción de cada campo, references/prompting-instructions.md cubre los problemas que silenciosamente producen resultados incorrectos.
Paso 5 - Ensambla el prompt
Llena esta plantilla con las respuestas de la ingesta, manteniendo las etiquetas de los campos y reemplazando las partes entre corchetes.
Crea un agente personalizado para mí con estos detalles:
- Proyecto: app_id [APP_ID] (o "proyecto actual")
- Qué monitorear: [FLUJO DE TRABAJO O MÉTRICA]
- Señal principal: [NOMBRE EXACTO DEL EVENTO O MÉTRICA]
- Señales de protección: [EVENTOS DE CONTEXTO]
- Segmentos/filtros: [REGLAS DE INCLUIR / EXCLUIR]
- Qué marcar: [UMBRAL O CONDICIÓN]
- Cadencia: [FRECUENCIA, DÍA, HORA, ZONA HORARIA]
- Destino: [DÓNDE ATERRIZAN LOS RESULTADOS]
- Formato de salida: [FORMA DEL ENTREGABLE]
Para cualquier campo que no hayan respondido, completa un valor predeterminado sensato y señálalo en tu mensaje para que sepan qué verificar, en lugar de dejar el agente poco especificado. Solo omite una línea cuando un valor predeterminado no tenga sentido. Vuelve a indicar que pueden cambiar cualquier cosa en Amplitude después de que el agente esté construido.
Paso 6 - Construye el enlace profundo
Convierte el prompt completo en un enlace de Agente Global para que al abrirlo cargue el prompt listo para ejecutarse.
Ruta (la raíz de la aplicación resuelve la organización del usuario por sí sola, por lo que no se necesita un slug de organización; un usuario con sesión iniciada aterriza en Agente Global con el prompt ya cargado en el compositor):
https://app.amplitude.com/?aiQuery=<prompt codificado en URL>
Codifica en URL todo el prompt completo. Codifica los espacios como %20, los saltos de línea como %0A, las comillas como %22, los paréntesis como %28 y %29, # como %23, / como %2F, y : como %3A.
Paso 7 - Entrega
Devuelve tres cosas:
- El enlace en el que se puede hacer clic, como un enlace Markdown con nombre cuyo texto sea una descripción corta en inglés sencillo (por ejemplo,
[Construir este agente en Amplitude](https://app.amplitude.com/?aiQuery=...)). Nunca pegues la URL codificada sin procesar como texto visible. - El prompt en texto plano del Paso 5, para que puedan pegarlo en Agente Global o en el comando
/create-custom-agentmanualmente. - Un "qué sucede después" de una línea: abren el enlace, revisan el borrador del agente que propone Agente Global, luego lo publican. Agrega estos recordatorios solo cuando correspondan:
- Si el destino es Slack, invita primero al bot de Slack
Amplitudeal canal de destino, o la entrega fallará silenciosamente. - Cualquier acción que afecte a los usuarios finales (lanzar un experimento, crear una cohorte) necesita aprobación humana antes de ejecutarse.
- El agente es privado hasta que lo publiquen y lo compartan.
- Si el destino es Slack, invita primero al bot de Slack
Agentes Especializados (menciona, no pongas barreras)
Amplitude incluye cuatro Agentes Especializados incorporados: Agente de Panel (monitorea un panel en busca de cambios significativos), Agente de Reproducción de Sesiones (patrones de fricción en reproducciones), Agente de Conversión de Sitio Web (flujos de registro/compra) y Agente de Comentarios de Clientes (temas de comentarios cualitativos). Si la idea de alguien coincide exactamente con uno de estos, menciónalo como una opción más rápida que ya tienen, luego ofrece construir una variante personalizada si quieren algo con un alcance, programación o entrega diferente. Esto es un comentario secundario, nunca una razón para dejar de ayudar.