Empieza el diseño de un agente por el trabajo que quieres mejorar. Define a quién ayuda, qué datos puede utilizar, qué resultado debe producir y qué decisiones siguen correspondiendo a las personas.
Si estás a cargo del proceso o desarrollas el agente, usa estas guías para preparar una prueba piloto. Describe la tarea con suficiente precisión para que otra persona pueda comprobar si el agente la completó.
Define el trabajo en tres pasos
- Elige un caso de uso útil. Compara las tareas candidatas por su utilidad, la evidencia disponible, su reversibilidad y el esfuerzo necesario para evaluar los resultados.
- Define el trabajo concreto del agente. Especifica el inicio, los datos de entrada, la tarea, el resultado, la transferencia, los límites y las condiciones para darla por terminada.
- Diseña aprobaciones y transferencias. Decide qué requiere revisión humana, qué información recibe quien revisa y qué ocurre mientras se espera la revisión.
Facilita la inspección del resultado
Para preparar un informe de una reunión semanal de proyecto, define un trabajo que se pueda probar:
- Inicio: La persona responsable del proyecto solicita la preparación para la próxima reunión.
- Datos aprobados: La agenda vigente, el registro del proyecto y las notas aprobadas de reuniones anteriores.
- Borrador: Un resumen de la agenda, preguntas pendientes y enlaces a las fuentes de las afirmaciones comprobables.
- Criterio de éxito: Cada afirmación comprobable cuenta con una fuente enlazada que la respalda; las suposiciones quedan marcadas para revisión.
- Criterio de detención: Si falta la agenda o las fuentes discrepan, el agente señala el faltante o el conflicto, deriva la consulta a la persona responsable del proyecto y espera una aclaración, sin elegir una versión ni inferir un compromiso.
Usa el caso habitual y el caso de detención como ejemplos de evaluación distintos. La guía para definir el trabajo concreto del agente amplía estos campos; la guía de evaluación ayuda a probarlos.
Pasa del diseño al piloto
Usa la guía de conocimiento, herramientas y conexiones para decidir qué necesita el flujo de trabajo. Después, sigue la guía de evaluación antes de producción para probar el diseño. Para conocer los conceptos de configuración de AgentShelf, consulta la página sobre el harness del agente.
Todas las guías de este tema
- Cómo elegir un caso de uso para un agente de IA: Elige un trabajo con una persona responsable, pasos variables, información aprobada, un resultado revisable y una señal útil de éxito.
- Define un trabajo acotado para un agente: Una definición útil del trabajo de un agente nombra el desencadenante, la persona usuaria, el resultado, el contexto aprobado, las acciones permitidas, las condiciones para detenerse y la derivación a una persona.
- Revisión humana para agentes de IA: La revisión humana aporta más valor en puntos de decisión claros, donde una aprobación, una corrección o un escalamiento pueden cambiar el resultado.
- Diseña traspasos de trabajo entre agentes y sistemas: Mantén pendiente un traspaso entre sistemas hasta que el sistema receptor confirme la solicitud e indique qué ocurrió después.
- Usa salidas estructuradas para que los resultados del agente se puedan revisar: Define los campos obligatorios, los valores permitidos, las referencias de evidencia y las condiciones de revisión; luego valida la estructura y los hechos.