Agentes de IA · Claude Code + n8n

El brief de tu agente

Este formulario convierte la información de tu negocio en una instrucción lista para pegar en Claude Code. Claude Code, con la skill autor-prompt-agente instalada, va a usar ese brief para escribir el system prompt de tu agente. Cuanto más completo y detallado escribas cada campo, mejor va a salir el prompt: tómate tu tiempo.

  1. 1 Completa el brief
  2. 2 Genera y copia la instrucción
  3. 3 Pégala en Claude Code
1

Negocio e identidad

Quién eres tú y quién va a ser tu agente.

crítica

Describe tus productos o servicios principales, tu cliente típico y qué te diferencia. Esto le da a Claude Code el panorama del negocio. Si tu catálogo es muy amplio para describirlo acá, no pasa nada: para eso está el campo de abajo.

mínimo 80 caracteres

Si vendés muchos productos y no entran en la descripción de arriba (una tienda online con cientos de artículos, por ejemplo), pegá acá el link de tu tienda o dejá el catálogo como archivo en tu proyecto. Es para que Claude Code entienda TODO lo que ofrecés. Importante: el catálogo NO se copia dentro del system prompt — no tendría sentido meter un catálogo entero ahí. Tu agente accede a los productos por su herramienta (o por tu documento cerrado); esto es solo contexto.

El nombre con el que se presenta en el chat.

¿Cómo es? Ej: "un vendedor canchero que conoce su mercadería y asesora sin presionar", "una asistente muy educada, cálida y profesional".

mínimo 30 caracteres
2

Voz y tono

Cómo habla tu agente. El dialecto importa muchísimo: define si dice "tenés" o "tienes".

crítica

Saludos, despedidas o muletillas propias que quieras que el agente use. Ej: cerrar siempre con la misma frase de la marca al despedirse.

Lo que te haría ruido leer en un chat de tu negocio. Ej: "no lo tenemos" seco, jerga de calle, tecnicismos, argentinismos si tu público no es argentino.

3

Ancla de verdad

De dónde saca los datos tu agente. Esta es la decisión más importante contra las alucinaciones.

crítica

Los campos que se le pasan al llamarla.

Detalla los campos de la respuesta y qué significa cada uno. Marca si alguno es interno (ej: un flag de stock que no debería mencionarse al cliente).

mínimo 60 caracteres

Tu catálogo de servicios, temario, lista de precios, preguntas frecuentes: todo lo que el agente puede afirmar. Regla de oro: esto será TODO lo que tu agente sabe. Lo que no esté acá, va a decir que no se ofrece. Tómate el tiempo de pegarlo entero.

mínimo 150 caracteres
4

Precios y pagos

Exactos. Un descuento "aproximado" en el prompt es un agente que inventa descuentos.

crítica

Si los da tu herramienta, escríbelo ("los precios los devuelve la herramienta"). Si son fijos, lístalos acá o en el documento de la sección 3.

mínimo 40 caracteres

Con número exacto y condición. Si no hay ninguno, escribe NO HAY (eso también protege: el agente nunca los va a inventar).

Igual de exacto. Si no hay, escribe NO HAY.

5

Logística

Envíos, turnos, horarios, ubicación. Tan importante lo que se sabe como lo que NO.

opcional

Solo lo que el agente puede afirmar sin equivocarse.

Esto es oro contra las alucinaciones: lo que el agente NO debe inventar y dónde manda a resolverlo.

6

Prohibiciones

Lo que tu agente no puede afirmar, prometer ni tocar.

opcional

El agente solo habla de tu negocio. ¿Hay algo más que deba evitar? (política, competencia, vida personal del dueño…)

Ej: el stock. ¿Se menciona proactivamente o solo si el cliente lo trae? ¿Qué dice si el cliente confronta un dato ("en la web figura sin stock")? Si no aplica, déjalo vacío.

7

Derivación a humano

Cuándo y cómo pasa la conversación a una persona. La frase exacta suele disparar el escalado en n8n: trátala como código.

crítica

Se manda tal cual, sola, sin nada antes ni después. Si tu flujo de n8n detecta esta frase para silenciar al bot y asignar a un humano, tiene que coincidir letra por letra.

8

Ejemplos reales

Conversaciones de verdad de tu negocio. Son la mejor materia prima: de acá salen el tono real y los ejemplos del prompt.

crítica

Copia y pega chats reales con clientes, con el formato Cliente: … / Negocio: …. Incluye casos buenos (así respondemos nosotros) y casos difíciles (objeciones, reclamos, preguntas raras). Cuantos más, mejor.

opcional, pero muy recomendado
Guárdalas así: crea una carpeta llamada capturas dentro de la carpeta de tu proyecto (donde abres Claude Code) y pon ahí las imágenes. La instrucción que vas a generar le dice a Claude Code que las abra y las lea antes de escribir el prompt — Claude Code ve las imágenes directamente, no hace falta transcribirlas.
9

Objetivo del agente

Qué es una conversación exitosa y cuál es el siguiente paso natural de tu negocio.

crítica

Describe el final ideal: ¿el cliente compró por la web? ¿reservó una clase de prueba? ¿quedó derivado al equipo con contexto? ¿se fue con la duda resuelta y buena impresión?

mínimo 60 caracteres

Pega el link EXACTO (de pago, de agenda, de la web) o el detalle. Si el link lo devuelve la herramienta por producto, escríbelo así.

instrucción para Claude Code · brief-agente.md

      

Y ahora, en Claude Code

  1. Verifica que tienes la skill autor-prompt-agente instalada en tu proyecto (carpeta .claude/skills/).
  2. Si marcaste que tienes capturas, guárdalas en la carpeta capturas/ de tu proyecto antes de seguir.
  3. Abre Claude Code en la carpeta de tu proyecto y pega la instrucción completa.
  4. Claude Code va a leer tu brief (y tus capturas) y, si le falta algo crítico, te lo va a preguntar: respóndele con detalle.
  5. Revisa el prompt que te entregue y recién ahí instálalo en el nodo AI Agent de n8n.

← Volver arriba para editar respuestas (la instrucción se regenera al tocar el botón de nuevo)