Docs - Crear Agente
El editor de agentes
Cada agente vive en el editor. Rellena los campos, escribe un Screenplay (sistema de instrucciones), elige un idioma, y prueba con Playground.
1. Los campos
Cada agente tiene cinco campos esenciales. Solo el avatar, el nombre y el Screenplay deben tener contenido para publicar.
| Campo | Límite | ¿Requerido para publicar? | Notas |
|---|---|---|---|
| Avatar | 1 imagen | Sí | La identidad visual del agente. Sube una foto de perfil o emoji. |
| Nombre | 128 caracteres | Sí | El nombre público del agente. Aparece en listas de agentes y conversaciones. |
| Intro | 1000 caracteres | No | Descripción pública de qué hace el agente. Se muestra en la tarjeta del agente antes de hablar con él. |
| Screenplay | 50,000 caracteres | Sí | El sistema de instrucciones. Le dice al agente cómo pensar, qué tono usar, cuándo rechazar, cuál es su experiencia. |
| Idioma | en / es / zh | Sí | Se establece una vez en la creación, no se puede cambiar. Determina el idioma de la UI y los supuestos del idioma de respuesta. |
2. El Screenplay — tu sistema de instrucciones
El Screenplay es el corazón de cada agente. Es un bloque de texto (hasta 50,000 caracteres) que instruye al agente: cuál es su rol, qué tono debe adoptar, qué conocimiento tiene, cuándo debe remitirse al usuario, cuáles son sus límites. Escribe tu Screenplay en inglés o como una mezcla de inglés y markdown. Los ejemplos funcionan mejor que las reglas abstractas. Incluye salvaguardas, ejemplos de conversaciones, o reglas específicas del dominio. Cuanto más específico y fundamentado sea tu Screenplay, más predecible será el comportamiento de tu agente.
3. El idioma se establece una vez
Cuando creas un agente, eliges un idioma: inglés, español o chino. Esta elección se bloquea y no se puede cambiar después de la creación. La configuración de idioma afecta el idioma de la UI mostrado al usuario y forma los supuestos de respuesta del agente. Si necesitas un idioma diferente, crea un nuevo agente en ese idioma.
4. Prueba mientras avanzas
El panel Playground aparece a la derecha del editor. Escribe un mensaje y presiona enviar para probar tu agente inmediatamente — no necesitas guardar primero. Observa cómo responde a diferentes indicaciones, refina tu Screenplay, y prueba de nuevo. Usa Playground para detectar comportamiento no deseado, reglas demasiado estrictas, o desajustes de tono antes de publicar.
