Decide una aprobación de herramienta
Apruebe o deniegue una llamada de herramienta retenida como uno de sus aprobadores. Debe haber iniciado sesión usted mismo: se rechazan las claves de API y las llamadas en nombre de un usuario final. La decisión no ejecuta la herramienta. El llamador que hizo la solicitud tiene 24 horas para continuar su respuesta con una respuesta de aprobación que contenga la misma decisión, lo que ejecuta una llamada aprobada una vez. Repetir su propia decisión devuelve la aprobación sin cambios; una decisión tomada por otra persona, o una que difiera de la suya, responde 409 tool_approval_already_decided, y una aprobación fuera de plazo responde 409 tool_approval_expired.
Autorizaciones
Send Authorization: Bearer , using an MKA1 API key for automation or an OAuth API access token for a signed-in application. Use a dynamic security callback to refresh OAuth access tokens. Browser session-only operations still require their declared cookie.
Encabezados
Optional external end-user identifier forwarded by the API gateway.
Parámetros de ruta
El ID del elemento de solicitud de aprobación (mcpr_... o tapr_...).
1 - 255Cuerpo
approve permite que la continuación de quien llama ejecute la llamada; deny le permite solo registrar la denegación.
approve, deny ¿Por qué, mostrado al solicitante y registrado en el libro mayor de auditoría.
2000Respuesta
Está bien
Una llamada de herramienta retenida para aprobación. Las aprobaciones que nombran aprobadores permanecen listadas durante 30 días después de que se deciden o caducan; las demás se eliminan en su fecha límite.
El ID del elemento de la solicitud de aprobación en la salida de la respuesta (mcpr_... o tapr_...).
El tipo del elemento de solicitud de aprobación: mcp_approval_request para una llamada MCP, tool_approval_request para una herramienta integrada.
mcp_approval_request, tool_approval_request pendiente hasta que un aprobador decida, o, en el caso de una aprobación sin aprobadores, hasta que la continuación del llamador la responda. caducada cuando se superó el plazo sin una decisión.
pending, approved, denied, expired El tipo de la herramienta mantenida: mcp, o un tipo de herramienta integrado como web_search o code_interpreter.
El nombre de la herramienta que el modelo llamó.
Solo llamadas MCP: la etiqueta del servidor MCP.
Los argumentos con los que se ejecuta la llamada si se aprueba.
La respuesta que se detuvo para esta aprobación.
El agente guardado para el que se ejecutó la solicitud, si lo hay.
Quién hizo la solicitud cuya llamada a herramienta fue retenida. Solo este llamador puede continuar la respuesta.
Los usuarios a los que la política de herramientas de la organización nombra para decidir esta llamada. Vacío cuando el llamante decide.
Quién decidió: ¿el aprobador, o el solicitante de una aprobación sin aprobadores?
El comentario o motivo dado junto con la decisión.
Si la continuación del llamador ha consumido la decisión. Una llamada aprobada se ejecuta solo cuando esto ocurre, y solo una vez.
Cuando se realizó la llamada.
El plazo para el siguiente paso: la decisión mientras está pendiente, luego la continuación del llamante. Una decisión le da al llamante 24 horas.
Cuando se tomó la decisión.