ThunderPhone v3 ya está disponible.Empieza por tu cuenta desde 2¢/min.Lee el anuncio

Using the dashboard

Guía de estilo de prompts

Cómo escribir y editar el prompt de un agente de voz de ThunderPhone: las pautas que verifica la revisión de prompts, con los identificadores que citan sus hallazgos.

Esta guía es para cualquier persona que escriba o edite el prompt de un agente de voz: una persona en el creador, Copilot o un agente de programación que trabaje mediante la API. La herramienta de revisión de prompts la usa como criterio y cita sus identificadores de directrices (P1, W2, etc.).

Quien llama escucha al agente una vez, al ritmo del habla, y no puede retroceder. El agente lee el prompt en cada turno y reproduce fielmente su redacción. Ambos hechos determinan todo lo que sigue.

Estructura

P1. Redáctalo como lo haría una persona al informar a un nuevo recepcionista. Una breve introducción indica quién es el agente y para quién trabaja. La llamada sigue el orden en que ocurre: cómo comienza, qué se debe averiguar, qué se debe confirmar y cómo termina. Cada regla se ubica en la parte de la llamada donde aplica. Quien lee debería poder preguntarse sobre cada párrafo: «¿una persona que dirige este negocio podría haber escrito esto?». Lo que se debe averiguar abarca lo que el negocio necesita para atender la solicitud, no solo quién llama y cómo comunicarse con esa persona.

P2. Encabezados sencillos, texto debajo. Encabezados como "Quién eres", "La llamada", "Datos" y "Transferir" son útiles. La estructura de estilo automático no lo es: manuales de reglas numerados, encabezados en camelCase o con apariencia de código, listas largas de reglas con guiones, una referencia de herramientas al inicio y referencias cruzadas como "consulta la sección 4 a continuación". Las listas son adecuadas para datos que el agente consulta (horarios, precios, una dirección).

P3. Forma de hablar, una sola vez y brevemente. Cómo habla el agente durante toda la llamada (intervenciones cortas en primera persona, tono cálido y palabras sencillas; consulte S2) cabe en un breve párrafo cerca del inicio. Todo lo específico de un paso va en ese paso.

P4. Datos separados del comportamiento. Los horarios, precios, ubicaciones, políticas y otros datos van en una sección de datos del prompt o en una base de conocimientos, no dispersos en el flujo de la llamada. Los catálogos largos y las preguntas frecuentes pertenecen a una base de conocimientos. El agente solo puede decir los datos que se le proporcionaron.

Contenido

C1. Principios y hechos, no guiones. Describe lo que el agente intenta lograr y lo que necesita saber. Omite ramas como «si quien llama dice X, di Y», respuestas guionizadas a preguntas previstas y frases predefinidas. El saludo de apertura configurado es el único elemento guionizado.

C2. Una corrección establece el principio general. Cuando un cambio en el prompt responde a un fallo observado, el cambio agrega un principio general o un hecho faltante, no un parche para ese caso específico. Los detalles de la llamada que falló, como sus nombres, números y palabras exactas, no se incluyen en el prompt.

C3. Prefiere quitar antes que agregar. Cuando un fallo se debe a una regla existente que es demasiado específica, demasiado amplia o está mal ubicada, cambia o elimina esa regla en lugar de agregar una regla contraria junto a ella.

C4. La configuración decide algunas cosas, no el prompt. Estas son configuraciones del agente, y el texto del prompt sobre ellas se ignora o entra en conflicto con ellas: lo que se dice mientras se ejecuta una herramienta (línea de inicio de herramienta, frases de relleno), verificaciones tras silencios y la acción final después de un silencio, cómo se marca el ritmo de una repetición, el estilo de cambio de idioma, el aviso de grabación y si el agente o quien llama habla primero. Dirige el prompt al resultado en su lugar («confirma la dirección de correo electrónico antes de guardarla») y configura el ajuste. El saludo de apertura se escribe en el prompt.

C5. Los ejemplos son frases que dirá el agente. El agente copia la redacción de los ejemplos casi palabra por palabra, así que cada ejemplo debe ser una oración completa y natural para decir en voz alta, y unos pocos ejemplos variados son mejores que uno solo. Introdúcelos como ejemplos («Por ejemplo, podrías decir...») y no como la frase obligatoria. Etiquetas recortadas como «¿Sigue siendo correcto?» suenan secas al decirse en voz alta.

C6. No uses ejemplos de llamadas de nuestros propios clientes. Los ejemplos describen el tipo de situación en términos generales o usan una empresa inventada.

C7. El prompt es para quienes llaman, no sobre la implementación. Quienes llaman escuchan todo lo que dice el prompt una vez que está activo, por lo que se omiten notas sobre la implementación, las pruebas o el estado de cumplimiento ("esta versión es para pruebas", "PRUEBA" en el nombre de una reserva, "hasta que se firmen los acuerdos"). También se omiten descargos de responsabilidad, salvedades de responsabilidad y resúmenes finales que la empresa no solicitó, como lo que aceptar un plan no establece o un resumen de lo que aún no está confirmado. El agente responde lo que preguntó quien llama y se detiene; la empresa añade una salvedad cuando la necesita. Un dato faltante o un límite del sistema se redacta como lo que hace el agente ("para conocer los precios, ofrezca una devolución de llamada de la oficina"), no como una nota de que no se proporcionó o sobre cómo se registran las solicitudes, y no queda nada del borrador, como un nombre o encabezado suelto.

Redacción

W1. Di qué hacer, claramente y una sola vez. Indica el comportamiento deseado como una instrucción en palabras comunes: "Lee el número de pedido dígito por dígito para que quien llama pueda corregirlo". Dilo una sola vez, donde corresponda.

W2. Sin énfasis. No uses etiquetas como IMPORTANTE, NOTA o CRÍTICO, palabras en mayúsculas para dar fuerza, signos de exclamación, pares de «Mal:» y «Bien:», ni bloques sobre lo que no se debe hacer. Palabras como «nunca», «siempre» y «debe» usadas para dar fuerza también entran aquí. El énfasis atrae la atención del modelo hacia una regla y empeora su desempeño en el resto de la llamada. Cuando el agente ignore una instrucción, haz que sea más clara, más específica o esté mejor ubicada, no más enfática.

W3. Corrige la estructura que causa un comportamiento. Antes de agregar una regla contra algo que hace el agente, encuentra la redacción o estructura que lo lleva a hacerlo: una plantilla que el modelo completa literalmente, un término que significa dos cosas, una rama if-else que un modelo rápido interpreta de forma imprecisa. Cambia eso.

W4. Lo específico supera a lo general. «Ofrece los dos primeros horarios disponibles y luego pregunta cuál le funciona» es mejor que «ayuda con la programación». Las instrucciones vagas producen comportamientos vagos.

W5. Búscalo antes de preguntar al respecto. Cuando quien llama menciona algo que una herramienta de consulta de solo lectura puede verificar (un producto, un pedido o una reserva existente), el agente lo verifica con las palabras que dio quien llama y solo hace una pregunta de seguimiento si el resultado lo requiere. "Verifica el inventario del producto que menciona quien llama y dile lo que encuentres" es mejor que "aclara la marca, el tamaño y la variante, y luego verifica el inventario": un agente al que se le indica aclarar primero sigue preguntando y la verificación nunca se realiza. Esto solo cubre consultas. Antes de usar una herramienta que reserva, cambia, cancela o guarda algo, el agente aún confirma los detalles con quien llama.

Habla

S1. Una pregunta por turno, y la pregunta termina el turno. Cualquier cosa que se diga después de una pregunta se superpone con la respuesta de quien llama. Coloca cualquier explicación antes de la pregunta.

S2. Turnos breves, en oraciones completas y naturales. Una o dos oraciones breves, a menos que quien llama pida detalles. Las opciones habladas se limitan a unas pocas. Breve significa pocas palabras, no frases recortadas: el agente habla como una buena recepcionista por teléfono, en oraciones completas y en primera persona, como "Reservaré eso para usted ahora" o "Lo tengo agendado para el lunes a las diez". Los fragmentos con estilo de nota ("Reservando eso para usted.", "Hecho.", "Anotado.") suenan secos al decirse en voz alta, y las frases de correo electrónico ("Tenga en cuenta que...", "Por favor...", "Espero que esto le sirva") suenan leídas en lugar de dichas. El párrafo del prompt sobre la forma de hablar pide esto claramente, por ejemplo: "Mantén cada turno en una o dos oraciones y habla en primera persona, como lo haría una recepcionista por teléfono."

S3. Escribe para el oído. En lo que dice el agente, evita markdown, símbolos y notación que la voz leerá de forma extraña (barras, símbolos «&», «@», «.com», separadores de miles y números de teléfono sin espacios). Los hechos y valores que el agente pasa a una herramienta, como una dirección de correo electrónico o un número de cuenta, deben mantenerse en su forma escrita exacta; cuando también deban decirse en voz alta, agrega cómo se dicen junto a ellos en lugar de reescribirlos. Explica cómo se pronuncian los nombres o acrónimos inusuales, y escucha los términos nuevos en la voz del agente antes de conservarlos.

S4. Confirma lo que sería costoso equivocarse. Los números, correos electrónicos, direcciones y códigos se repiten tal como se proporcionaron, una vez, en la respuesta inmediatamente después de que quien llama los indique y antes de la siguiente pregunta, un valor por repetición. De forma predeterminada, un nombre se acepta tal como se dice, sin repetirlo, y el agente pide que lo deletreen solo cuando es inusual o poco claro, y lo pide una sola vez. Cuando la empresa necesita el nombre exacto, por ejemplo, para coincidir con sus registros o para una reserva a ese nombre, el prompt lo indica y el agente repite el nombre letra por letra. Una repetición es la oportunidad de quien llama para corregir un valor, no un requisito previo: quien llama que responde con el siguiente detalle o continúa sin corregirlo lo ha aceptado, y no se vuelve a preguntar por un valor aceptado. Un número de teléfono al que la empresa llamará o enviará mensajes de texto es la excepción: su repetición termina el turno y espera la respuesta de quien llama. Un prompt que solicita una lectura dígito por dígito nombra solo los valores que se leen de esa forma (un número de teléfono, un código); un número de vivienda, un precio, una hora o una fecha se dice como lo dirían las personas. El prompt indica qué confirmar; la plataforma regula el ritmo de la repetición.

Iteración

I1. Prueba antes de conservar un cambio. Reproduce el conjunto de desarrollo del agente en el borrador editado y compáralo con la versión actual: qué ejemplos corrigió un cambio y cuáles empeoró. Lee las respuestas como las escucharía quien llama. Todo lo que quien llama notaría es un problema, no un detalle.

I2. El conjunto de reserva se revisa una vez. Ajusta solo con el conjunto de desarrollo. Ejecuta el conjunto de prueba cuando un cambio esté listo e informa su resultado tal como es. Un cambio realizado después de ver los resultados de prueba necesita ejemplos de prueba nuevos.

I3. Refactoriza cuando se acumulen los parches. Un prompt que ha acumulado muchas correcciones pequeñas se aleja de P1: las reglas se repiten, entran en conflicto o están lejos del paso que rigen. Entonces reescríbelo con esta estructura, conservando cada comportamiento que solicite. Enumera cada comportamiento como conservado, fusionado, reformulado o eliminado, y no elimines nada en silencio. Reproduce el conjunto de desarrollo antes y después; una refactorización debe cambiar la redacción, no el comportamiento.

I4. Verifica la configuración antes del prompt. Algunos fallos no son del prompt: confundir letras deletreadas es un límite de audición (prueba la audición Plus), una respuesta lenta puede deberse al nivel de inteligencia o de audición, o a la configuración de detección de final de turno. Descarta problemas de configuración antes de reescribir el texto.