Tutorial: tu primer agente

Al terminar tendrás un agente que responde preguntas sobre un PDF que le subas, cita la sección de donde sacó la respuesta y reconoce cuando algo no está en el documento. Diez minutos, sin escribir código.

Antes de empezar

• Cuenta en Studio con cualquier rol (Acceso a Studio).
• Un PDF de texto (no escaneado) de menos de 50 páginas: un reglamento, un manual, una política. Para saber si es de texto, ábrelo y prueba a seleccionar una frase; si no se puede, es una imagen y necesitarás OCR Vision.
• Nada más. Los modelos de InferNode no necesitan credencial.

Paso 1: crear el agente

Abre Agentes > Agentes de IA y pulsa Crear Agente. Studio crea un agente llamado Nuevo agente y abre su editor de inmediato: no hay formulario previo.

Lo que ves: a la izquierda las conversaciones (vacías), al centro el chat de prueba y a la derecha la configuración con Instrucciones, Fuentes, Herramientas y Workflows. Si la columna derecha no aparece, pulsa el botón de panel a la derecha de Compartir.

En la cabecera, pulsa sobre Nuevo agente y escribe Asistente de políticas; en Agrega descripción del agente, Responde preguntas sobre el reglamento interno. La descripción es lo que verás en la lista cuando tengas veinte agentes.

Paso 2: escribir las instrucciones

Pulsa el lápiz de Instrucciones. Verás el PROMPT precargado con cuatro bloques (ROL, CONTEXTO, TAREA, FORMATO). Sustitúyelo por:

[ROL]: Eres el asistente del reglamento interno. Hablas de usted, sin adornos.
[CONTEXTO]: Tus Fuentes contienen el reglamento vigente. 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". No inventes fechas, montos ni artículos.
[FORMATO]: Máximo cuatro frases. Cita la sección o artículo entre paréntesis al final.

Por qué así: el límite "solo con información de las fuentes" al inicio de TAREA es lo que evita que el modelo complete con su conocimiento general; la cita en FORMATO es lo que te permite comprobar cada respuesta.

Paso 3: ajustes avanzados

En el mismo diálogo despliega Ajustes avanzados y deja: Creatividad Preciso, Longitud Corta, Historial Normal, Herramientas Bajo. Guarda.

Preciso baja la variabilidad (un reglamento no admite creatividad); Corta basta para cuatro frases; Normal permite preguntas de seguimiento ("¿y en ese caso qué pasa?"); Bajo porque no usará herramientas.

Paso 4: elegir el modelo

En el selector junto al cuadro de mensaje (por ejemplo Saptiva Omni · Medio) elige un modelo de InferNode y esfuerzo Medio. Los modelos externos (Claude, Gemini) solo aparecen si tu Cliente tiene la credencial; para este tutorial no hacen falta.

Paso 5: subir el documento

En Fuentes, arrastra el PDF al recuadro Arrastra archivos o haz clic para subir. Verás el documento en la lista con estado Procesando y, si despliegas Ver detalle, los seis pasos (Subiendo archivo, Lector, Chunking, Embeddings, Base de datos, Finalizado). Espera a Indexado: un PDF de 30 páginas tarda alrededor de un minuto.

Junto al documento verás Solo tú tienes acceso: las Fuentes son privadas por defecto, aunque compartas el agente.

Paso 6: probar

En el chat, haz tres preguntas:

1. Una cuya respuesta esté en el documento ("¿Cuántos días de permiso da el artículo 12?").
2. Una que no esté ("¿Cuál es el presupuesto de la dirección?").
3. Una de seguimiento ("¿Y si el permiso es sin goce de sueldo?").

Debajo de cada respuesta, el botón Documentos muestra Consultó 1 documento y, al desplegarlo, los fragmentos exactos que leyó. Esa es la prueba de que respondió con tus fuentes y no de memoria.

Resultado

• La primera pregunta se responde en menos de cuatro frases con la cita entre paréntesis.
• La segunda recibe "No está en el reglamento".
• La tercera usa el contexto de la primera (Historial Normal).

Si algo no sale

Qué ves	Causa	Qué hacer
El documento queda en Error con "No se pudo leer el documento"	Es un PDF escaneado o está dañado.	Usa otro PDF o pásalo por un flujo con OCR Vision. Reintentar indexación si fue un fallo puntual.
Responde bien pero sin Documentos debajo	Contestó de memoria.	Refuerza "solo con información de las fuentes" al inicio de TAREA y baja Creatividad a Preciso.
Inventa un artículo	Sigue sin límite explícito o la pregunta usa términos que no están en el documento.	Pregunta con las palabras del documento; revisa que esté Indexado.
"La respuesta quedó cortada"	Longitud Corta insuficiente.	Sube a Media.
No aparece ningún modelo	El Catálogo no está disponible.	Espera un minuto; si persiste, avisa al administrador.

Llevarlo a tu caso

• Sube hasta 5 documentos; mejor cinco de un tema cada uno que un tomo de 200 páginas.
• Comparte el agente con tu equipo desde Compartir en lugar de duplicarlo (Compartir un agente).
• Si el agente debe consultar una tabla (Excel, CSV), no va en Fuentes: agrégala como herramienta Leer CSV y Excel.
• Cuando el agente esté estable, úsalo como nodo en un workflow para exponerlo por WhatsApp o webhook (tu primer workflow).

Siguiente paso

• Tutorial: tu primer workflow
• Escribir las instrucciones, para pasar del ejemplo a tu caso real