Constructor de Mensajes de Conversación
Construye y prueba arrays de mensajes de chat completion con edición visual basada en roles
JSON de Salida(0 ({count} mensajes))
[]
¿Qué es un Constructor de Mensajes de Conversación?
Un constructor de mensajes de conversación es una herramienta visual para construir los arrays de mensajes que utilizan las APIs de chat completion de IA. Cuando llamas a la API de Chat Completions de OpenAI, la API de Messages de Anthropic o la API de Gemini de Google, envías un array ordenado de mensajes — cada uno con un rol (system, user o assistant) y contenido. Esta herramienta te permite construir esos arrays visualmente en lugar de escribir JSON a mano.
Escribir arrays de mensajes a mano es tedioso y propenso a errores, especialmente para conversaciones de múltiples turnos, configuraciones de few-shot prompting o system prompts complejos. Olvidar una coma, desemparejar comillas o equivocarse en los nombres de los roles lleva a errores de API que pueden ser difíciles de depurar. Nuestro constructor te ofrece una interfaz visual con codificación de colores por rol, reordenamiento y salida JSON en tiempo real.
La herramienta soporta tanto el formato de OpenAI/Google (mensajes system en el array) como el formato de Anthropic (system prompt separado de los mensajes). Cambia entre formatos con un solo clic y copia el JSON listo para usar directamente en tu código.
Cómo Usar el Constructor de Mensajes
Construir un array de mensajes solo toma unos clics:
- Añade mensajes — Haz clic en los botones "+ System", "+ User" o "+ Assistant" para añadir mensajes. Cada rol tiene un código de color: púrpura para system, azul para user, verde para assistant.
- Escribe contenido — Escribe o pega el contenido de tu mensaje en cada área de texto. La salida JSON se actualiza automáticamente mientras escribes.
- Reordena mensajes — Usa los botones de flechas arriba/abajo para reorganizar el orden de los mensajes. También puedes cambiar el rol de un mensaje usando el desplegable.
- Elige el formato de salida — Selecciona "OpenAI / Google" o "Anthropic" en el desplegable de formato. Para Anthropic, los mensajes system se extraen automáticamente a un campo separado.
- Copia el JSON — Haz clic en "Copiar JSON" para copiar la salida formateada a tu portapapeles, lista para pegar en tu código o herramienta de pruebas de API.
Entendiendo los Roles de los Mensajes
Cada mensaje en un array de chat completion tiene un rol específico que indica al modelo cómo interpretarlo:
Rol System
El mensaje system establece el comportamiento general y las restricciones de la IA. Actúa como instrucciones persistentes que influyen en cada respuesta. Los system prompts comunes incluyen definiciones de persona ("Eres un desarrollador senior"), requisitos de formato de salida ("Siempre responde en JSON"), restricciones de seguridad ("Nunca proporciones consejos médicos") o contexto de dominio. El mensaje system normalmente es el primer mensaje del array.
Rol User
Los mensajes de user representan la entrada del usuario humano. Son las preguntas, instrucciones o datos que el modelo debe procesar. En conversaciones de múltiples turnos, los mensajes de user se alternan con los de assistant para crear un historial de conversación.
Rol Assistant
Los mensajes de assistant representan respuestas previas del modelo de IA. Incluir mensajes de assistant en el array te permite proporcionar historial de conversación o implementar few-shot prompting — donde muestras al modelo ejemplos de pares de entrada/salida deseados antes de hacer tu pregunta real.
Casos de Uso Comunes
- Few-shot prompting — Construye ejemplos de conversación donde los mensajes de user muestran entradas y los de assistant muestran salidas deseadas, enseñando al modelo el patrón.
- Pruebas de system prompt — Prototipa rápidamente diferentes system prompts y observa cómo se combinan con los mensajes de user en el JSON final.
- Pruebas de API — Genera arrays de mensajes para herramientas como Postman, curl o playgrounds de API sin formatear JSON manualmente.
- Migración entre proveedores — Convierte arrays de mensajes entre formatos de OpenAI y Anthropic al cambiar de proveedor.
- Documentación — Construye conversaciones de ejemplo para documentación de API o materiales de incorporación del equipo.
Preguntas Frecuentes
¿Qué es un array de mensajes de chat completion?
Un array de mensajes de chat completion es el formato de entrada que utilizan las APIs de IA como OpenAI, Anthropic y Google. Es una lista ordenada de mensajes, cada uno con un "role" (system, user o assistant) y "content" (el texto del mensaje). El modelo usa este historial de conversación para generar respuestas contextualmente apropiadas.
¿Cuál es la diferencia entre los formatos de mensajes de OpenAI y Anthropic?
OpenAI incluye los mensajes system directamente en el array de mensajes con role: "system". Anthropic separa el system prompt en un parámetro dedicado "system" fuera del array de mensajes, y el array de mensajes solo contiene roles "user" y "assistant". Nuestro constructor maneja esta conversión automáticamente cuando cambias los formatos de salida.
¿Qué hace el mensaje system?
El mensaje system establece el comportamiento, personalidad y restricciones del modelo de IA. Se procesa antes de la conversación y actúa como instrucciones persistentes. Los usos comunes incluyen definir el rol del asistente ("Eres un agente de soporte al cliente"), establecer requisitos de formato de salida o definir directrices de seguridad. No todas las llamadas a la API necesitan un mensaje system, pero se recomienda para aplicaciones en producción.
¿Por qué importa el orden de los mensajes?
El orden de los mensajes define el flujo de la conversación. Los modelos procesan los mensajes secuencialmente, y el orden afecta a cómo el modelo interpreta el contexto. Los mensajes system deben ir primero, seguidos de mensajes alternados de user y assistant. Poner mensajes fuera de orden (por ejemplo, dos mensajes de user seguidos sin respuesta de assistant) puede confundir al modelo o provocar errores de API con algunos proveedores.
¿Puedo usar este constructor para conversaciones de múltiples turnos?
Sí. El constructor soporta mensajes ilimitados, lo que lo hace ideal para construir historiales de conversación de múltiples turnos. Puedes añadir mensajes de user y assistant en orden alternado para simular una conversación completa, y luego copiar el JSON resultante para usarlo en tus llamadas a la API o para probar cadenas de prompts.
Herramientas Relacionadas
Explora más herramientas para construir con APIs de IA:
- Conversor de Formato de Prompt — Convierte entre formatos de prompt de OpenAI, Anthropic y Google
- Linter de Definiciones de Tool/Function — Valida definiciones de herramientas para function calling
- Generador de JSON Schema para IA — Genera schemas para salidas estructuradas
Herramientas Relacionadas
Linter de Definiciones de Tool/Function
Valida y analiza tus definiciones de function calling para formatos de OpenAI, Anthropic, Google y Cohere
Generador de JSON Schema para IA
Genera JSON schemas a partir de datos de ejemplo optimizados para function calling y salidas estructuradas de IA
Conversor de Formato de Prompt
Convierte prompts entre formatos de OpenAI, Anthropic Claude, Google Gemini y otros proveedores de IA