Guía de implementación para administradores

Usa esta guía para planificar una implementación de ChatGPT Enterprise en estos ámbitos administrativos:

• Acceso al espacio de trabajo.
• Política de ejecución local para las funciones incluidas en la aplicación de escritorio de ChatGPT, Codex CLI y la extensión para IDE.
• Codex Cloud.
• Acceso a la Plataforma API.
• Acceso a complementos y conectores.
• Permisos en los sistemas conectados.

Completa los pasos en orden para una implementación nueva o usa las páginas vinculadas para modificar un solo ámbito.

En la configuración del espacio de trabajo, Codex Local es una etiqueta que agrupa determinados controles de acceso local y de tokens de acceso; no es un producto ni un cliente independiente. El control actual Permitir que los miembros usen Codex Local abarca el uso local en la aplicación de escritorio de ChatGPT, Codex CLI y la extensión para IDE. La configuración administrada es una capa de políticas independiente que puede restringir el comportamiento durante la ejecución de las funciones compatibles incluidas en esos clientes. Esta guía menciona cada interfaz por separado cuando el comportamiento o la disponibilidad difieren.

Comienza con el mapa de referencia de Roles y permisos del espacio de trabajo. Consulta las indicaciones del Centro de ayuda para conocer los procedimientos vigentes del espacio de trabajo de ChatGPT y la documentación para desarrolladores vinculada sobre el comportamiento de las ejecuciones locales y alojadas.

Para conocer las protecciones empresariales de seguridad, privacidad y ejecución, consulta Aprobaciones y seguridad de agentes y el informe técnico sobre la seguridad de Codex.

Paso 1: asignar responsables y elegir un plan de implementación

Asigna una persona responsable a cada parte de la implementación:

• Acceso al espacio de trabajo: membresía, licencias, roles y funciones compatibles del espacio de trabajo.
• Política de ejecución local: aprobaciones, perfiles de permisos, acceso al sistema de archivos y a la red, y otros requisitos para clientes locales compatibles.
• Codex Cloud: entornos alojados, conexiones a repositorios y política de ejecución en la nube.
• Sistemas conectados: instalación de la aplicación en el proveedor, cuentas y permisos.
• Informes y cumplimiento: acceso a datos analíticos, exportaciones de auditoría y tratamiento de datos en sistemas posteriores.

Decide si cada grupo de usuarios necesita las funciones locales incluidas en la aplicación de escritorio de ChatGPT, Codex CLI, la extensión para IDE, Codex Cloud o una combinación. Considera el acceso a la Plataforma API como un ámbito independiente de organización y proyecto cuando un flujo de trabajo use autenticación mediante claves de API.

Paso 2: configurar el acceso al espacio de trabajo y la identidad

Usa la membresía, las licencias y los grupos del espacio de trabajo de ChatGPT, así como los permisos RBAC compatibles, para otorgar a los grupos de usuarios previstos las funciones compatibles del espacio de trabajo. Verifica el acceso a los clientes locales y a Codex Cloud según las indicaciones vigentes del espacio de trabajo, en lugar de suponer que el mismo rol controla todas las interfaces. Limita los roles administrativos integrados a las personas que administran el espacio de trabajo.

Los controles y las etiquetas del espacio de trabajo cambian con el tiempo. Consulta estas fuentes para conocer los procedimientos vigentes:

• Administrar miembros, tipos de licencia, roles y acceso
• Configurar el control de acceso basado en roles
• Administrar la configuración del espacio de trabajo
• Grupos y aprovisionamiento
• Autenticación

Prueba el inicio de sesión y el acceso a las funciones con un miembro representativo antes de ampliar la implementación. El acceso al espacio de trabajo no otorga acceso a repositorios, archivos ni acciones en un servicio conectado.

Paso 3: configurar los requisitos de ejecución local

Los requisitos locales limitan el comportamiento durante la ejecución cuando un usuario inicia una ejecución local compatible en la aplicación de escritorio de ChatGPT, Codex CLI o la extensión para IDE. Distribuye requirements.toml mediante un canal compatible en la nube, en el dispositivo o en el sistema. Mantén esta política separada de los roles y grupos del espacio de trabajo de ChatGPT.

Usa perfiles de permisos para los clientes locales compatibles en lugar de crear nuevas implementaciones basadas en restricciones heredadas del modo sandbox. Por ejemplo:

default_permissions = ":workspace"

[allowed_permission_profiles]
":read-only" = true
":workspace" = true

Para deshabilitar Uso de la computadora en todas las interfaces compatibles del navegador y de la aplicación de escritorio, restringe cada clave pública de función que participa en la experiencia:

[features]
browser_use = false
browser_use_full_cdp_access = false
browser_use_external = false
in_app_browser = false
computer_use = false

Para consultar la lista oficial de claves, el funcionamiento de la distribución, la precedencia y más ejemplos, consulta Configuración administrada y la referencia de requirements.toml.

Paso 4: estandarizar la configuración del repositorio

Usa una configuración específica del repositorio para compartir los valores predeterminados, las reglas y las habilidades del proyecto sin duplicar la configuración para cada usuario. Incorpora la configuración al repositorio en .codex o .agents, según la ubicación documentada de la función:

La configuración del repositorio puede proporcionar valores predeterminados y flujos de trabajo reutilizables. No puede otorgar acceso al espacio de trabajo, a modelos, a la Plataforma API ni a sistemas conectados.

Paso 5: configurar Codex Cloud

Codex Cloud usa entornos alojados y repositorios de código fuente conectados. Planifica cada ámbito:

1. Otorga al grupo de usuarios previsto acceso a Codex Cloud mediante los controles compatibles del espacio de trabajo.
2. Instala y configura la integración compatible con el sistema de origen.
3. En el sistema de origen, limita el acceso a los repositorios que cada grupo de usuarios necesite.
4. Configura los entornos en la nube, los secretos y el acceso a Internet para esos repositorios.
5. Configura flujos de trabajo alojados opcionales, como la revisión de código.
6. Realiza pruebas con un usuario representativo que tenga los permisos previstos del espacio de trabajo y del repositorio.

Codex Cloud respeta los permisos y las protecciones del repositorio que proporciona el sistema de origen conectado. El acceso al espacio de trabajo no permite eludir esos controles. Consulta Entornos en la nube, Integración con GitHub y Aprobaciones y seguridad de agentes para obtener instrucciones sobre la configuración y la ejecución de Codex Cloud.

Paso 6: configurar complementos y funciones conectadas

Evalúa como decisiones independientes la instalación de complementos, las habilidades incluidas, las funciones que dependen de conectores, las acciones de conectores y la autorización del sistema de origen. Deshabilitar una función que depende de un conector no necesariamente desinstala el complemento ni sus habilidades incluidas.

Antes de incluir un complemento o una habilidad en la implementación:

1. Confirma su origen, quién es responsable, el grupo de usuarios previsto y la fecha de revisión.
2. Revisa las habilidades incluidas, los conectores, los servidores MCP, los hooks, además de los datos y las acciones que requiere cada función.
3. Pruébalo con datos no confidenciales y el nivel mínimo de acceso que necesita.
4. Registra quién es responsable de volver a revisarlo y retirarlo.

Los complementos funcionan en Chat y Work en las versiones web, de escritorio y para dispositivos móviles de ChatGPT, en Codex dentro de la aplicación de escritorio de ChatGPT y mediante el explorador de complementos de Codex CLI. No están disponibles en la extensión para IDE. ChatGPT y Codex comparten un único directorio público universal de complementos; los controles del espacio de trabajo determinan a cuáles de esos complementos pueden acceder los miembros.

Consulta Controles de complementos y Controles de habilidades para conocer el modelo completo.

Paso 7: configurar la gobernanza y la observabilidad

Elige la opción de informes que mejor responda a la pregunta:

• Usa Análisis del espacio de trabajo para consultar de forma interactiva los análisis del espacio de trabajo de ChatGPT y los análisis de Codex.
• Usa la Analytics API para generar informes agregados de forma programática mediante la Codex Analytics API.
• Usa la API de Cumplimiento para acceder a registros de auditoría e investigación.
• Usa Límites de uso y controles de gasto de ChatGPT cuando la actividad de Codex que depende del plan consuma créditos elegibles del espacio de trabajo de ChatGPT.

Usa las referencias autenticadas de la API para consultar información actualizada sobre los requisitos de acceso, los esquemas, los campos, la retención y el comportamiento de las solicitudes. No desarrolles una integración a partir de una copia del contrato incluida en esta guía.

Protege el perímetro de integración:

• Almacena las claves de API y otras credenciales de integración en el sistema de gestión de secretos de la organización.
• Limita el acceso a los sistemas de destino y a los datos conservados al grupo de usuarios autorizado.
• Protege los registros exportados de la API de Cumplimiento según su nivel de sensibilidad y la Política de retención de la organización, y prueba los flujos de trabajo de recopilación y eliminación con el contrato vigente.

Paso 8: verificar y mantener la implementación

Verifica todos los ámbitos aplicables con identidades representativas:

• Membresía, licencia y permisos de roles compatibles en el espacio de trabajo de ChatGPT.
• Funciones locales incluidas en la aplicación de escritorio de ChatGPT, Codex CLI y la extensión para IDE, incluidos el inicio de sesión y los requisitos de ejecución aplicables.
• Acceso a Codex Cloud, configuración del entorno y permisos del repositorio.
• Acceso a la organización y al proyecto de la Plataforma API para flujos de trabajo con claves de API.
• Instalación de complementos, habilidades incluidas, acceso a conectores y acciones compatibles.
• Autorización y acceso a datos en sistemas conectados.
• Acceso de los administradores responsables a las funciones de análisis y cumplimiento.

Registra, para cada control, quién es el responsable y cuál es la fuente vigente del procedimiento. Este registro permite a los administradores actualizar los procedimientos cuando haya cambios en la interfaz de usuario o en la política sin tener que cambiar el modelo de administración.

Después de la implementación inicial, revisa el acceso, las funciones conectadas, el uso de créditos, los comentarios del equipo de soporte y los flujos de trabajo que los equipos realmente usan. Ajusta el alcance de la implementación y la guía para administradores cuando cambien esos indicadores.