Protege las claves de API de OpenAI para clasificar solicitudes de soporte
Flujo práctico de seguridad para usar OpenAI en la clasificación de solicitudes de soporte: protege las claves de API, redacta los registros, limita los permisos, rota las credenciales y exige aprobación humana.
Resumen · TL;DR
Para clasificar solicitudes de atención al cliente, guarda la clave de aplicación de OpenAI en un componente de confianza del lado del servidor, envía solo los detalles mínimos y redactados del caso, registra las decisiones en lugar de los secretos o las conversaciones completas y exige que una persona apruebe las acciones dirigidas al cliente. Usa credenciales distintas con los mínimos privilegios necesarios para cada carga de trabajo y documenta cómo rotarlas o revocarlas.
Puntos clave
- No incluyas una clave de API de aplicación en código generado por agentes, un navegador, una imagen de contenedor, el control de versiones ni los registros.
- Redacta la información personal y secreta antes de enviar un caso de soporte a un modelo; después, minimiza también lo que conservas.
- Deja que el modelo sugiera una categoría, prioridad y borrador, pero no cierres casos, emitas reembolsos ni envíes respuestas sin aprobación humana.
- Separa las credenciales por carga de trabajo, concede solo los permisos de API necesarios y ensaya la rotación y revocación de claves.
En esta página (7)
El patrón más seguro: dejar que el modelo aconseje, no que actúe
Para clasificar solicitudes de atención al cliente, el primer paso útil suele ser categorizarlas y resumirlas, no resolverlas de forma autónoma. Un modelo puede sugerir una cola, un nivel de urgencia y un resumen preliminar, mientras un agente de soporte comprueba las pruebas y decide qué hacer a continuación.
Guarda la clave de aplicación de OpenAI en un servicio de confianza del lado del servidor que realice la solicitud a la API. No la expongas en el navegador de un cliente ni en código que se ejecute en el entorno de un agente. La guía de seguridad del entorno aislado de OpenAI advierte que el código generado por agentes puede acceder a los archivos, las credenciales y los recursos de red disponibles en su entorno. Recomienda mantener la clave de aplicación fuera de ese entorno y no incluir claves en el código fuente, las imágenes ni los registros. Guía de seguridad del entorno aislado de OpenAI
Los ejemplos siguientes son ilustrativos; no se han probado como configuración. Adáptalos al cliente de API, tus requisitos de privacidad y tu sistema de soporte.
Flujo mínimo para clasificar solicitudes
- Tu sistema de soporte recibe un caso y elimina los campos que no hacen falta para clasificarlo.
- Un backend de confianza redacta los valores confidenciales y envía el texto restante a OpenAI mediante una credencial del lado del servidor.
- El modelo devuelve una categoría propuesta, una prioridad y un resumen breve.
- Tu aplicación muestra la propuesta a un agente de soporte autorizado. El agente aprueba o modifica la siguiente acción.
- Tu sistema registra la decisión y los metadatos de auditoría necesarios, sin conservar secretos ni duplicar innecesariamente toda la conversación.
Por ejemplo, el backend puede enviar una instrucción deliberadamente acotada y un caso redactado. Evita incluir contraseñas, datos de tarjetas de pago, tokens de autenticación o historial de cuenta no relacionado. Las reglas de redacción deben aplicarse antes de la solicitud, no solo al escribir los registros posteriormente.
# Illustrative pseudocode: provide an already-redacted case to your API client.
# Keep credential loading and the API call in a trusted backend service.
def propose_triage(api_client, redacted_case):
response = api_client.create_response(
instructions=(
"Suggest a support category, priority, and concise summary. "
"Do not claim to have resolved the case or send a reply. "
"If information is insufficient, say what is missing."
),
input=redacted_case,
)
return response
Este esquema no es un ejemplo listo para usar del SDK de OpenAI: los nombres de métodos y los campos de la solicitud dependen del cliente y del endpoint de API que utilices. Antes de implementarlo, consulta la referencia de API actual para verificar el endpoint, los parámetros admitidos y el formato de respuesta. No trates la salida del modelo como autorización para realizar una acción de soporte.
Mantén separadas las claves y los permisos
Siempre que sea práctico, utiliza credenciales distintas para aplicaciones o cargas de trabajo diferentes. Así limitas el alcance de un error y resulta más fácil revocar una credencial sin interrumpir servicios que no guardan relación. Restringe el acceso al sistema que necesita la clave; guárdala en un almacén de secretos gestionado o en otro recurso protegido equivalente del lado del servidor e inyéctala únicamente en el componente de confianza que realiza la solicitud.
Para el entorno de Agents API descrito en la guía de OpenAI, la clave de aplicación necesita api.agents.read y api.agents.write para las sesiones, además de api.responses.write para la inferencia. La gestión de Vault requiere api.vaults.read y api.vaults.write. La guía diferencia la clave de entorno de la clave de aplicación: la clave de entorno permite conectar entornos y no puede autorizar otras acciones de API. Sigue los permisos que exijan las funciones de API que realmente utilizas; no concedas permisos de Vault a un servicio de clasificación que no gestione Vault.
Si utilizas un entorno de agente o un entorno aislado, considera que cualquier recurso disponible para su código también está expuesto al código generado por agentes. En el caso de credenciales de terceros, la guía recomienda mantenerlas fuera del entorno y utilizar un proxy de confianza o un enfoque basado en Vault, según corresponda. Un secreto inyectado en el entorno sigue siendo accesible para el código que se ejecute allí.
Redacta los registros sin perder su valor para las auditorías
Los registros ayudan a investigar errores de clasificación, problemas de acceso e incidentes, pero no deberían convertirse en una segunda copia de la bandeja de entrada de soporte. Evita registrar claves de API, encabezados de autorización, instrucciones completas, mensajes originales de clientes o respuestas del modelo que puedan repetir detalles confidenciales.
Es preferible guardar registros estructurados y limitados, como una referencia interna del caso, la hora de la solicitud, el identificador del modelo o endpoint, el estado de redacción, la categoría propuesta, la decisión humana y la clase de error. Aplica controles de acceso y plazos de conservación a estos registros. Si quienes revisan la calidad necesitan ejemplos de conversaciones, crea un conjunto de datos independiente, minimizado y sujeto a una gobernanza específica, en lugar de conservar de forma inadvertida las cargas útiles de producción.
La redacción puede fallar si los datos personales aparecen en texto libre, cadenas de correos citados, archivos adjuntos o formatos poco habituales. Prueba las reglas con casos realistas, inspecciona qué datos salen de tu sistema y ofrece una alternativa segura cuando el servicio no pueda eliminar con suficiente confianza la información confidencial.
Define un procedimiento para rotar y revocar credenciales
Un plan de rotación debe asignar una persona responsable y especificar dónde se guarda la credencial, qué servicios la utilizan, quién puede sustituirla y cómo verificar el cambio. Un procedimiento práctico sería:
- Crea una credencial de sustitución con solo los permisos necesarios.
- Actualiza el almacén de secretos del servicio de confianza y distribuye el cambio o vuelve a cargarlo mediante el proceso habitual de cambios.
- Verifica que una solicitud de clasificación inocua se complete correctamente y que la credencial no aparezca en los diagnósticos.
- Revoca la credencial anterior y confirma que el servicio ya no depende de ella.
- Registra la fecha, la persona responsable, la carga de trabajo afectada y el resultado; nunca el valor del secreto.
Establece una frecuencia de revisión periódica que se ajuste al riesgo y a los requisitos operativos de tu organización. Si sospechas que una clave ha quedado expuesta, revócala cuanto antes; no esperes a la siguiente rotación programada. La guía de OpenAI aconseja expresamente rotar o revocar las claves cuando sea necesario y revocar las credenciales de inmediato si se sospecha que han quedado expuestas.
Aprobación humana y gestión de errores
Haz que la aprobación sea una regla del sistema, no solo una instrucción en la solicitud. En este flujo, el modelo no debería tener acceso directo a herramientas que envíen mensajes a clientes, cambien el estado de una cuenta o emitan reembolsos. Presenta su sugerencia como una propuesta, muestra las pruebas pertinentes ya redactadas y exige que una persona autorizada confirme cualquier acción con consecuencias.
Si la API no está disponible, la respuesta no tiene el formato esperado o falla la redacción, envía el caso a la cola manual existente. No conviertas silenciosamente una clasificación incierta en una acción automática.
Lista de verificación
- La clave de aplicación permanece en un backend de confianza, no en un navegador ni en el entorno de un agente.
- Las credenciales están separadas por carga de trabajo y limitadas a los permisos necesarios.
- Los campos confidenciales se eliminan antes de la inferencia y se excluyen de los registros habituales.
- El resultado de la clasificación es orientativo; una persona aprueba las acciones dirigidas al cliente o que modifican una cuenta.
- Una persona responsable puede sustituir o revocar las credenciales y se ha ensayado el procedimiento.
- Los errores y los resultados inciertos vuelven a un proceso manual seguro.
La decisión clave de diseño es mantener las credenciales y las acciones con consecuencias fuera del alcance del modelo. Usa el modelo para organizar el trabajo de soporte, limita los datos que ve y establece la aprobación humana como último filtro.
FAQ
¿Puedo poner una clave de API de OpenAI en el entorno aislado de un agente?
Evita colocar la clave de aplicación en un entorno de agente. La guía de seguridad del entorno aislado de OpenAI indica que el código generado por agentes puede acceder a los archivos, las credenciales y la red del entorno, y recomienda mantener fuera de él la clave de aplicación. Utiliza un backend de confianza para realizar las solicitudes a la API.
¿Qué deberían incluir los registros de clasificación de solicitudes de soporte?
Conserva solo los metadatos necesarios para las operaciones y las auditorías, como una referencia interna del caso, la fecha y hora, el estado de redacción, la categoría propuesta, la decisión humana y la clase de error. Evita registrar claves de API, encabezados de autorización, mensajes completos de clientes y resultados confidenciales del modelo.
¿Debería el modelo enviar automáticamente una respuesta de soporte?
En un flujo de clasificación con aprobación humana, no. Utiliza la salida del modelo como sugerencia y exige que un agente de soporte autorizado revise y apruebe las acciones dirigidas al cliente o que modifiquen una cuenta.
¿Cuándo debería rotarse una clave de API de OpenAI?
Establece una frecuencia de revisión periódica adecuada a tus riesgos y requisitos operativos, y rota las credenciales cuando sea necesario. Si sospechas que una credencial ha quedado expuesta, revócala de inmediato y sigue el procedimiento de sustitución y verificación.
Artículos relacionados
Guides
Cómo diagnosticar incidentes de la API de OpenAI sin exponer credenciales
Guía práctica para diagnosticar fallos de la API de OpenAI con señales útiles, proteger las claves de API, limitar permisos y planificar la rotación de credenciales.
Guides
Diagnóstico de fallos de la OpenAI API en un flujo de clasificación de soporte con aprobación humana
Una guía práctica para gestionar errores de autenticación, límites de tasa, tiempos de espera agotados y respuestas del modelo mal formadas, sin que los resultados fallidos de clasificación lleguen a los clientes.
Guides
Extracción estructurada segura con OpenAI: claves, registros, permisos y rotación
Flujo de trabajo práctico para extraer datos estructurados con OpenAI: aislar credenciales, restringir permisos, validar la salida JSON, redactar registros y rotar claves de forma segura.
Guides
Protege las claves de la API de OpenAI en un flujo de preguntas y respuestas sobre documentos
Patrón práctico de seguridad para responder preguntas sobre documentos con OpenAI: separa credenciales, limita permisos, redacta los registros y rota las claves de forma segura sin perder la atribución de fuentes.