Una instrucción no necesita ser larga, pero sí debe ser precisa. Debe indicar el objetivo, la información que se puede utilizar, el criterio de evaluación, el resultado esperado y las restricciones.
¿Qué es una instrucción?
Una instrucción explica al agente o a la etapa de Buk AI qué debe hacer, qué información puede utilizar y qué resultado debe entregar. En algunos contextos técnicos también se utiliza la palabra prompt, pero en Buk Studio recomendamos hablar de instrucción porque ayuda a recordar que el texto forma parte de una configuración de proceso.
Cuando el objetivo, el alcance o el formato de salida quedan implícitos, el resultado puede ser demasiado general o incluir casos que no querías analizar. Una buena instrucción funciona como un encargo claro: indica qué debe revisar, con qué criterio y cómo debe comunicar lo encontrado.
¿Qué elementos debería incluir?
Una instrucción efectiva suele incluir los siguientes elementos:
- Objetivo: qué debe lograr el proceso.
- Fuente: qué información puede utilizar.
- Alcance: qué personas, áreas o períodos debe revisar.
- Criterio: qué regla, umbral o condición debe aplicar.
- Excepciones: qué casos requieren atención.
- Resultado: qué debe informar y en qué formato.
- Restricciones: qué no debe hacer.
El objetivo explica qué debe lograr el proceso. El alcance limita las personas, áreas o períodos. El criterio define qué debe buscar o comparar. Las excepciones indican qué casos requieren atención y el formato de salida permite que el resultado sea útil para quien lo recibe.
Ejemplo completo
Revisa las ausencias de los colaboradores durante la última semana. Utiliza únicamente la información de asistencia disponible para las áreas autorizadas. Identifica a las personas que tengan tres o más ausencias sin justificación registrada. Para cada caso, informa el nombre, área, fechas involucradas y estado de la justificación. Si no encuentras casos, indica que no se detectaron excepciones. No modifiques información ni envíes notificaciones adicionales.
¿Por qué funciona este ejemplo? Porque define el período, la fuente, el umbral, los datos que deben aparecer en el resultado, qué hacer cuando no hay casos y la acción que no debe realizarse.
Ejemplos según el objetivo
- Seguimiento de documentos
- Revisa los documentos pendientes de firma de los colaboradores del área de Operaciones. Identifica los documentos que llevan más de cinco días pendientes. Entrega un resumen con colaborador, tipo de documento, fecha de envío y días transcurridos. No modifiques documentos ni envíes recordatorios sin aprobación.
- Revisión de remuneraciones
- Revisa el proceso de remuneraciones del período actual e identifica colaboradores con deducciones superiores al porcentaje definido por la política interna. Informa los casos encontrados y los datos utilizados. No realices modificaciones.
- Seguimiento de onboarding
- Revisa las tareas de onboarding de los colaboradores incorporados durante los últimos 30 días. Identifica las tareas vencidas o sin responsable. Agrupa los resultados por responsable y entrega un resumen para seguimiento.
¿Cómo solicito alertas solo ante excepciones?
Debes explicar qué se considera normal, qué se considera una excepción y qué debe ocurrir cuando no hay excepciones. Por ejemplo, puedes indicar que, si todos los casos cumplen la condición definida, el agente debe informar únicamente que no se detectaron excepciones. Si encuentra uno o más casos fuera de la condición, debe informar solo esos casos con el contexto necesario.
Esta precisión evita recibir informes extensos cuando no hay nada que revisar y ayuda a que la notificación se concentre en los casos que requieren una decisión.
¿Cómo acoto el alcance?
El alcance puede limitarse mediante los filtros disponibles, como empresa, área, cargo, sucursal, estado del colaborador, tipo de proceso, período, responsable, módulo o estado de una solicitud. La instrucción también debe indicar el período exacto y qué hacer cuando un dato no esté disponible.
Los filtros de la configuración y los permisos del usuario trabajan conjuntamente. Escribir en la instrucción que el agente debe revisar toda la empresa no amplía los permisos ni permite consultar fuentes que no estén habilitadas.
¿Cuáles son los errores más frecuentes?
Una instrucción como “Revisa la asistencia” es demasiado general porque no indica qué período, población o condición debe analizar. Es mejor escribir: “Revisa las ausencias de la última semana y reporta solo aquellas que no tengan una justificación registrada”.
También es frecuente omitir el período. En lugar de “Identifica los documentos pendientes”, indica: “Identifica los documentos que llevan más de cinco días pendientes al momento de la ejecución”. Otro error es no definir el formato de salida. En lugar de “Informa los problemas”, indica: “Para cada caso, informa colaborador, área, fecha, tipo de problema y recomendación”.
¿Cómo pruebo una instrucción?
Antes de activar el proceso, utiliza una población de prueba con el botón de "Probar ”y comprueba un caso que debería activar la instrucción y otro que debería quedar fuera. Prueba también qué ocurre cuando falta información, cuando hay varios resultados y cuando no existe ninguna excepción.
Checklist de prueba
- ¿El agente revisó el período correcto?
- ¿Incluyó solo la población esperada?
- ¿Aplicó correctamente el criterio?
- ¿Informó los datos solicitados?
- ¿Actuó correctamente cuando no encontró casos?
- ¿Respetó los permisos y restricciones?
- ¿Se notificó a los destinatarios correctos?
Revisa el contenido y el formato de la respuesta. Si el proceso tiene impacto en otras personas o módulos, solicita una revisión antes de activarlo de forma gradual.
Artículos relacionados
- Crear y administrar agentes.
- Configurar una etapa de Buk AI.
- Revisar ejecuciones.
- Seguridad y permisos.