Saltar al contenido principal
Las aprobaciones de agente registran decisiones humanas sobre una acción de agente propuesta en un entorno de espacio de trabajo. Son independientes de las aprobaciones del motor de flujo de trabajo, las concesiones de permisos, los recibos de acciones criptográficas y la ejecución temporal.

Antes de empezar

  • Usar un agente activo del mismo espacio de trabajo y entorno que su credencial.
  • Cree solicitudes utilizando una clave API del espacio de trabajo o un usuario del espacio de trabajo con sesión iniciada.
  • Los revisores deben ser miembros humanos activos del espacio de trabajo con el permiso tenant:governance:approve a nivel de espacio de trabajo. Un rol solo de organización es insuficiente.
  • El solicitante no puede aprobar o rechazar su propia solicitud. Cada revisor puede decidir una vez. Las claves API no pueden emitir votos humanos.
En Console, abra Agentes de IA → Aprobaciones de Agentes. Los formularios de solicitud, revisión y cancelación tienen cada uno una página dedicada. Guarde el enlace de la solicitud para volver a ella después de que salga de la cola pendiente.

Crear una solicitud

Este ejemplo solicita dos aprobaciones independientes en una ventana de una hora. Reemplace el identificador del agente con un agente de sandbox existente; un agente de producción no se puede usar con una credencial de sandbox.
La respuesta 201 contiene id, requested_by, status: "pending", current_approvals: 0 y expires_at. Guarde id; la creación no publica el informe ni crea un flujo de trabajo en segundo plano.

Revisar con una sesión humana

Use Console para decisiones interactivas. Si su integración utiliza la API, proporcione la sesión de portador del espacio de trabajo de corta duración del revisor. No sustituya una clave de API ni incruste un token de sesión en el código fuente.
La primera aprobación en este ejemplo devuelve status: "pending" y current_approvals: 1. Un revisor autorizado diferente debe proporcionar el segundo voto. Reutilizar el mismo revisor devuelve un conflicto. Un rechazo cambia inmediatamente la solicitud a rejected independientemente de las aprobaciones anteriores. El servicio verifica los permisos de membresía actuales, la propiedad de la solicitud, la caducidad y los votos existentes dentro de la transacción de decisión. Los votos y el evento de auditoría se confirman juntos. Las decisiones no se pueden editar ni eliminar a través de estas API.

Verificar y hacer cumplir el resultado

La respuesta detallada incluye el historial del revisor. Proceda solo cuando status sea approved y la solicitud aún coincida con el agente, la acción, el recurso y el alcance exactos que su aplicación pretende usar. Su aplicación también debe hacer cumplir los permisos de acceso actuales, el estado del agente y sus propios controles de un solo uso o de repetición. Estos registros de aprobación no proporcionan un mecanismo automático de ejecución o consumo. La fecha límite de revisión limita cuándo se pueden enviar las decisiones. No convierte una solicitud ya aprobada en un token de acceso que caduca. Defina cualquier fecha límite de ejecución en su propia aplicación.

Cola, cancelación y errores

GET /v1/approvals devuelve una matriz de como máximo 100 solicitudes pendientes más antiguas y no vencidas. No tiene paginación ni filtro de estado histórico. La cola omite el historial de decisiones individuales; obtenga una solicitud por ID para ese historial. El solicitante original puede enviar POST /v1/approvals/{approvalID}/cancel con un reason no vacío. Una solicitud no puede reabrirse después de su cancelación, rechazo, aprobación o vencimiento. Cree una nueva solicitud si la acción propuesta cambia. Estos registros respaldan su proceso de revisión; no establecen el cumplimiento de SOC 2, la certificación ISO, la verificación de documentos de identidad o la corrección de la evidencia presentada.