Escribir las instrucciones
Las instrucciones (el PROMPT) son la parte del agente que más pesa en la calidad de las respuestas: más que el modelo, más que los ajustes. Studio precarga una plantilla con cuatro bloques para que no empieces en blanco.
La plantilla que Studio precarga
Un agente nuevo trae esto en Instrucciones:
[ROL]: Eres un asistente de IA de Saptiva. Respondes con claridad, precisión y criterio operativo.
[CONTEXTO]: Trabajas dentro de una organización. Usa el contexto disponible de la conversación,
herramientas y documentos autorizados. Si falta información importante, pide solo lo necesario.
[TAREA]: Ayuda al usuario a resolver su solicitud. Identifica el objetivo, ejecuta las acciones
posibles con las herramientas disponibles y evita inventar datos.
[FORMATO]: Responde en el idioma del usuario, con una estructura breve y accionable. ...
| Bloque | Qué decide | Qué escribir |
|---|---|---|
| ROL | Quién es el agente y con qué tono habla. | Un rol concreto ("asistente de soporte de la Dirección de Servicios Escolares"), no "asistente de IA". El nombre si lo va a decir. |
| CONTEXTO | Qué sabe del negocio y de dónde debe sacar la información. | Qué documentos tiene en Fuentes, qué sistemas ve por herramientas, qué no debe asumir. |
| TAREA | Qué hace con cada mensaje. | El verbo principal (responder, clasificar, extraer, redactar) y sus límites ("solo con información de las fuentes"). |
| FORMATO | Cómo entrega la respuesta. | Idioma, longitud, estructura (lista, JSON, tabla), qué citar. |
Sustituye el texto de cada bloque; conserva las etiquetas entre corchetes. Los agentes de las plantillas de workflow usan el mismo esquema (por ejemplo, el Agente OCR Vision de Extracción de Información: rol de extractor, contexto "recibes un documento adjunto", tarea "usa la herramienta OCR Vision", formato "devuelve únicamente el resultado de la herramienta").
Tres ejemplos por caso de uso
Responder preguntas sobre documentos (Fuentes)
[ROL]: Eres el asistente del reglamento de becas. Hablas de usted, sin adornos.
[CONTEXTO]: Tus Fuentes contienen el reglamento vigente y su anexo de fechas. No conoces casos individuales.
[TAREA]: Responde solo con información de las fuentes. Si la respuesta no está en ellas, di
"No está en el reglamento" y sugiere a quién preguntar. No inventes fechas ni montos.
[FORMATO]: Máximo cuatro frases. Cita el artículo o sección entre paréntesis al final.
Clasificar y extraer (para usar dentro de un workflow)
[ROL]: Eres un clasificador de solicitudes de soporte.
[CONTEXTO]: Recibes el texto de un correo. Las categorías válidas son: acceso, facturación, error_tecnico, otro.
[TAREA]: Devuelve la categoría y un resumen de una línea. Si dudas entre dos, elige "otro".
[FORMATO]: Solo JSON: {"categoria": "...", "resumen": "..."}. Sin texto adicional.
Redactar con criterio (Creatividad alta)
[ROL]: Eres redactor de comunicados internos de Recursos Humanos.
[CONTEXTO]: Recibes puntos clave y el público (toda la organización o un área).
[TAREA]: Redacta el comunicado completo. Mantén los datos tal como llegan; no agregues cifras.
[FORMATO]: Título, dos párrafos y una línea de contacto. Español neutro, sin siglas sin explicar.
Ajustes que acompañan a cada caso
| Caso | Creatividad | Longitud | Historial | Herramientas |
|---|---|---|---|---|
| Preguntas sobre documentos | Preciso | Corta o Media | Normal | Bajo |
| Clasificar o extraer | Preciso | Corta | Apagado | Bajo (o Normal si usa OCR) |
| Redactar | Creativo o Balanceado | Media o Larga | Normal | Bajo |
| Asistente con herramientas (web, workflows) | Balanceado | Media | Normal | Normal o Intensivo |
Detalle de cada control en Configuración.
Errores frecuentes y cómo se ven
| Síntoma en el chat de prueba | Causa habitual en las instrucciones | Corrección |
|---|---|---|
| Inventa datos con seguridad | No hay límite explícito ("solo con información de las fuentes"). | Ponlo en TAREA, al inicio, y baja Creatividad a Preciso. |
| Responde bien la primera vez y luego se desvía | Historial amplio arrastra respuestas anteriores. | Historial Normal o Apagado si cada mensaje es independiente. |
| Respuesta cortada a mitad | Longitud máxima corta para lo que pides. | Longitud Media o Larga, o pide respuestas más cortas en FORMATO. |
| Usa una herramienta cuando no hace falta | Herramientas activas que la tarea no necesita. | Quita las que no usa; el modelo elige entre las que ve. |
| Contesta en otro idioma o con otro tono | FORMATO vacío. | Fija idioma, tono y estructura. |
| No cita el documento | No se lo pediste. | "Cita la sección" en FORMATO; revisa en la respuesta el panel Documentos consultados. |
Cómo iterar
- Escribe la instrucción y prueba con tres mensajes: uno típico, uno que no debería poder responder y uno ambiguo.
- Lee la respuesta y su panel de Documentos o Herramienta usada (Probar un agente): ahí ves si usó lo que esperabas.
- Cambia una sola cosa por iteración (una frase, un ajuste). Si cambias tres, no sabrás cuál funcionó.
- Cuando el agente esté estable, compártelo en lugar de copiarlo: dos copias divergen en semanas.