Asteria Docs

Construye un agente que funciona de principio a fin en unos veinte minutos, con un trabajo que tienes de verdad.

Vamos a construir Revisión de Voz de Marca, un agente que revisa textos contra tu guía de estilo. Cambia el tema por el tuyo sobre la marcha: la forma sirve para la mayoría de trabajos.

Al final tendrás un agente al que puedes llamar con @, y uno que podrías compartir con tu equipo.

Antes de empezar

Ten a mano un documento que describa cómo escribe tu organización: una guía de estilo, una página de tono de voz, incluso un buen ejemplo de un texto con el que quedaste contento. Con una página basta.

Pon el material de referencia donde el agente pueda alcanzarlo

Si es una o dos páginas, se lo adjuntarás directamente al agente más adelante. Ahora no hay nada que hacer.

Si es un montón de verdad (una guía de estilo más campañas pasadas más mensajes de producto), crea antes una colección y mételos ahí. Llámala Directrices de Marca.

Crea el agente

Agentes en la barra lateral y luego Crear agente.

Nombre: Revisión de Voz de Marca

Descripción: Revisa textos contra nuestro tono de voz y señala todo lo que se salga de la marca.

Escribe las instrucciones

Esta es la parte que merece doce de tus veinte minutos. Adáptala:

Revisas textos escritos contra nuestra voz de marca para una
fintech B2B que vende a directores financieros de empresas medianas.

Cómo escribimos:
- Con seguridad y con claridad. Frases cortas. Sustantivos concretos.
- Explicamos, no vendemos. Sin superlativos.
- Español de España.

Nunca uses: revolucionario, sin fricciones, disruptivo, desbloquear,
líder del sector, sin esfuerzo.

Cuando revises un texto:
1. Da primero la versión corregida, lista para pegar.
2. Luego lista qué has cambiado y por qué, una línea cada cosa.
3. Luego señala aparte cualquier cosa que sea una afirmación factual
   que tendríamos que respaldar con pruebas. No las reescribas.
   Pregunta por ellas.

Si el texto ya encaja con la marca, dilo claramente en lugar de
inventar cambios para justificarte.

Si no tienes claro si algo rompe una regla, di que no lo tienes claro
y explica la tensión. No elijas un bando en silencio.

Los dos últimos párrafos son los que lo hacen útil. Sin ellos, un agente siempre encontrará algo que cambiar, porque eso es lo que cree que le has pedido.

Dale el material de referencia

Baja hasta Conocimiento.

Una colección: en Colecciones fijadas, fija Directrices de Marca. El agente ya busca en ella automáticamente, sin que nadie la nombre.

Una o dos páginas: en Archivos subidos, sube la guía de estilo. Su contenido está delante del agente en cada turno.

No hagas las dos cosas con el mismo documento. Elige la que encaje con el tamaño.

Decide sobre las herramientas

Para este agente, probablemente ninguna. Lee textos y da una opinión.

Resiste la tentación de añadir búsqueda web "por si acaso". Una herramienta que el trabajo no necesita es una vía para que el agente se despiste, y hace más lenta cada respuesta.

Añade preguntas sugeridas

En Preguntas sugeridas, añade dos o tres:

Revisa este titular y subtítulo de landing page.
¿Este correo suena demasiado comercial?
Reescribe este párrafo con nuestra voz.

Sáltate esto y un compañero que abra tu agente tendrá que adivinar.

Guarda y luego pruébalo como es debido

Validar para guardar. Ahora usa el panel Probar de la derecha, y no pruebes el caso fácil.

Dale un texto que ya está bien. ¿Lo dice, o se inventa cambios? Si se los inventa, refuerza esa instrucción.

Dale un texto con una afirmación factual. "Nuestra plataforma reduce el tiempo de conciliación un 90%." ¿Señala la afirmación en vez de pulirla?

Dale algo que no venga a cuento. "Escríbeme un plan de proyecto." ¿Se niega con criterio?

Ajusta las instrucciones y vuelve a probar. Dos o tres rondas es lo normal, y este bucle es el trabajo real de construir un agente.

Úsalo

De vuelta en el chat, escribe @ y elige Revisión de Voz de Marca, o haz clic en él en la barra lateral dentro de Mis Agentes. Dale a la estrella para fijarlo arriba.

Mejorarlo durante las dos semanas siguientes

Un agente no está terminado cuando lo guardas. El bucle útil:

Cuando se equivoque, arregla las instrucciones, no el mensaje. Reformular tu petición parchea una conversación. Editar el encargo arregla todas las futuras.

Añade las excepciones según te las encuentres. La primera vez que señale algo que no debía, añade una línea que lo diga.

Mantenlas cortas. Unas instrucciones que se desparraman hasta 4000 caracteres de casos especiales van a peor, no a mejor: las reglas importantes se ahogan. Si se está alargando, puede que el trabajo sean dos agentes, o que los detalles pertenezcan a una habilidad.

Cuando estés listo para compartirlo

Dáselo antes a uno o dos compañeros y mira lo que escriben. Preguntarán cosas que a ti nunca se te ocurrirían, y ese es el feedback más barato que existe. Luego consulta Compartir y el marketplace.

Habilidades para procedimientos que quieres en cualquier conversación, no solo en la de este agente.
Disparadores para ejecutar un agente con una programación.
Flujos de trabajo para trabajos de varios pasos que se ejecutan sin ti.

Tutorial: tu primer agente