AI review

AI review ayuda a personas e IA a entender dónde está el trabajo, qué necesita atención y qué hacer después. Reúne la situación del Caso, su evidencia y las acciones propuestas en un informe.

Su valor continúa entre evaluaciones. Registra un resultado, reevalúa y comprueba si la conclusión anterior sigue siendo válida. El siguiente informe considera el anterior, las propuestas atendidas, tus comentarios y la evidencia actual.

Empieza con un Caso

Abre un Caso en Web y selecciona Evaluar en AI review. Los editores pueden solicitar una evaluación; quienes tienen acceso de trabajo pueden leer el informe guardado. La generación se ejecuta en segundo plano. Leer un informe nunca ejecuta IA.

Una evaluación puede considerar:

• El propósito, las entradas y la situación actual del Caso.
• Las Tareas, sus instrucciones y los resultados registrados.
• Los Registros no eliminados y sus datos estructurados.
• Las instrucciones y resultados esperados de la versión fijada del Playbook, cuando la audiencia del Caso puede leerla.
• El texto guardado disponible de las fuentes externas vinculadas. Los Casos públicos excluyen las fuentes externas de la evaluación.

Las entradas tienen límites de tamaño. Un enlace o un archivo adjunto no implica que Review lo haya abierto, inspeccionado imágenes o ejecutado pruebas. La evidencia ausente o inaccesible permanece sin verificar.

Contrasta el trabajo con sus criterios

Review revisa los resultados y Registros aportados frente al propósito del Caso y, cuando están disponibles, las instrucciones y resultados esperados del Playbook fijado. Busca evidencia que respalde las conclusiones, carencias y contradicciones relevantes. Sin una estimación de costes, por ejemplo, la recomendación de aceptar una solicitud sigue sin verificarse; una estimación registrada que supera los ingresos previstos aporta evidencia para reconsiderarla.

El informe debe distinguir los requisitos del Caso o Playbook de los criterios propuestos por IA. Revisa la evidencia citada y las limitaciones antes de basarte en la conclusión.

Lee el informe y su evidencia

El informe presenta primero lo importante: la situación, los cambios relevantes, los problemas abiertos y las próximas decisiones. Su resumen también aparece en las listas de trabajo.

La evaluación distingue:

Consulta los Registros, las Tareas, el texto guardado de las fuentes o el Playbook citados para comprobar una afirmación. El juicio de IA ayuda a decidir; no sustituye la aprobación formal del revisor designado.

Convierte una propuesta en trabajo

Un informe puede proponer cuatro tipos de trabajo. Revisa todo el contenido guardado antes de confirmar; la creación lo utiliza sin cambios y no admite modificaciones de título, contenido o definición. Crear requiere una acción explícita de una persona o un agente; evaluar por sí solo no crea trabajo.

• Crea una Tarea para reunir evidencia, resolver un problema o avanzar una decisión.
• Crea una Sugerencia para el Playbook para proponer una mejora repetible. El flujo de Sugerencias habitual decide si se incorpora a una nueva versión.
• Crea un Caso para un propósito, responsabilidad o criterio de finalización diferente. Añade un enlace de traspaso dirigido desde el Caso evaluado sin cerrarlo.
• Crea un Playbook con su primera versión cuando hay evidencia de un patrón recurrente y un uso futuro probable. Un Caso completado o una reutilización meramente teórica no bastan; las recomendaciones de creación atendidas no se vuelven a proponer para ese Caso.
• Descarta una propuesta cuando no encaje. Los comentarios opcionales informan la siguiente evaluación.

El texto de la Sugerencia se comparte con la audiencia del Playbook, que puede diferir de la del Caso. Revísalo para evitar compartir detalles privados antes de enviarlo.

Los nuevos Casos y Playbooks utilizan tu cuenta de facturación activa con acceso restringido al creador. No se copian permisos ni fuentes externas del Caso original. Confirma con reportId, proposalId y action; feedback es opcional al descartar. Los reintentos utilizan la identidad de la propuesta, por lo que no debes enviar idempotencyKey.

Registra el resultado y reevalúa

Por ejemplo, una solicitud de cliente tiene un interés comercial claro pero carece de estimación de costes de entrega o soporte. Review señala la falta de evidencia. El equipo crea una Tarea, comprueba los costes y guarda sus conclusiones en un Registro. Una nueva evaluación puede reconsiderar si la solicitud tiene sentido y proponer el siguiente paso.

Una Tarea cerrada es una señal, no una prueba de que el problema subyacente se haya resuelto. Mantén el resultado real y la evidencia en el Caso. Las propuestas atendidas y los comentarios ayudan a que evaluaciones posteriores no repitan trabajo ya adoptado o descartado.

Aparece un aviso de actualización cuando cambia evidencia relevante tras la evaluación. No ejecuta IA automáticamente. Selecciona Reevaluar para actualizar el informe. El aviso es informativo: revisa el informe guardado y la nueva evidencia antes de actuar.

Control, privacidad y créditos

Las evaluaciones se ejecutan actualmente a petición.

Los ajustes de IA del propietario del Caso controlan los permisos de IA integrada y la búsqueda web. No se admiten instrucciones personalizadas de la cuenta propietaria ni prompts por solicitud. La generación consume créditos basados en tokens de esa cuenta propietaria y solo cobra cuando se guarda un informe. Crear una Tarea, Sugerencia o Playbook cuesta 5 créditos. Crear un Caso cuesta 5 créditos más 2 por su enlace de traspaso. Estas acciones se cobran a la cuenta de facturación activa de quien confirma; descartar es gratuito.

Un enlace público de Caso no expone su informe de Review ni el resumen. Cambiar la compartición oculta los informes generados para la audiencia anterior; transferir la propiedad borra los informes y los enlaces de acción derivados. Las conclusiones duraderas que deban sobrevivir a un informe deben guardarse en Registros.

Usa Web, CLI o MCP

El mismo informe guardado y las decisiones sobre propuestas están disponibles en todas las interfaces.

epismo case review generate "$CASE_ID"
epismo case review get "$CASE_ID"
epismo case review act "$CASE_ID" \
  --report-id "$REPORT_ID" --proposal-id "$PROPOSAL_ID" \
  --action create

La generación devuelve metadatos del trabajo. Consulta con get hasta que job.status sea complete, failed o skipped. Para MCP usa epismo_case_review_generate, epismo_case_review_get y epismo_case_review_act.

Referencia

• Ajustes de IA: permisos y ajustes.
• CLI: argumentos y reintentos.
• MCP: argumentos y uso de herramientas.