Es posible que tu sitio necesite guardar solicitudes, recordar el progreso de los usuarios o mostrar información de apps conectadas. Dile a ChatGPT qué debe guardar, de dónde viene la información y quién debe tener acceso.
Elige las funciones de almacenamiento e inicio de sesión
Para proyectos nuevos, el flujo de trabajo de Sites puede usar la plantilla de sitio recomendada como punto de partida. Si ya tienes un proyecto, pídele a ChatGPT que confirme que el proyecto puede generar artefactos de despliegue compatibles antes de solicitar el despliegue.
Describe qué debe hacer el sitio para que ChatGPT pueda elegir las funciones de almacenamiento e identidad necesarias:
| Necesidad del sitio | Qué pedirle a Sites |
|---|---|
| Sitio web centrado en el contenido o página de destino | Un sitio sin estado persistente de la aplicación, salvo que la experiencia lo requiera |
| Registros guardados, progreso de los usuarios o puntuaciones de juegos | D1, una base de datos relacional para almacenar datos estructurados de forma persistente |
| Imágenes, documentos, audio, video u otros archivos que se suban al sitio | R2, un servicio de almacenamiento de objetos para archivos |
| Archivos subidos que se puedan buscar por sus metadatos | D1 para los metadatos y R2 para el contenido de los archivos |
| Sitio interno que necesita identificar al usuario actual del espacio de trabajo | La identidad del usuario autenticado en el espacio de trabajo |
| Inicio de sesión público o proveedor de identidad externo | Un sitio con autenticación habilitada |
No solicites almacenamiento persistente para el estado temporal de la interfaz, como el tema elegido o un aviso que el usuario haya descartado. Sí debes solicitarlo para los datos del producto que los usuarios esperan que el sitio alojado conserve.
Agrega la opción de iniciar sesión con ChatGPT
Los sitios públicos pueden seguir abiertos a todos y ofrecer la opción de iniciar sesión con ChatGPT para usar funciones que dependen de la identidad del visitante, como guardar el progreso, mostrar vistas personalizadas o acceder a registros que pertenecen a una persona en particular. Los sitios con acceso restringido al espacio de trabajo ya usan la identidad de ChatGPT para aplicar su configuración de uso compartido.
Pídele a Sites que agregue el inicio de sesión:
Cómo funciona
Sites gestiona el inicio y el cierre de sesión mediante rutas que proporciona la plataforma. Después, redirige al visitante a tu sitio:
<a href="/signin-with-chatgpt">Sign in with ChatGPT</a>
<a href="/signout-with-chatgpt">Sign out</a>Cuando un visitante inicia sesión, Sites envía su identidad al servidor mediante estos encabezados de la solicitud:
oai-authenticated-user-emailcontiene la dirección de correo electrónico autenticada.oai-authenticated-user-full-namepuede contener un nombre de perfil que no esté vacío. Trata este dato como opcional y usa la dirección de correo electrónico si no hay un nombre disponible.
Mantén las decisiones de autorización en el código del servidor y evita depender de encabezados que separen el nombre y los apellidos.
Envía solicitudes a un sitio privado con un token que permite omitir el inicio de sesión con ChatGPT (SIWC)
Cuando un script o servicio necesite enviar solicitudes a un sitio que exige iniciar sesión con ChatGPT (SIWC), usa un token que permita omitir ese paso. Con el token, la solicitud puede pasar el control de inicio de sesión del sitio sin necesidad de una sesión interactiva en el navegador.
Como propietario del sitio, pídele a ChatGPT Work o a Codex que genere un token para tu sitio:
El agente usa generate_siwc_bypass_token y devuelve siwc_bypass_bearer_token. Al generar un token, se reemplaza cualquier token existente para ese sitio. Actualiza todos los servicios que usen el valor anterior.
Envía el token en este encabezado de la solicitud HTTP:
OAI-Sites-Authorization: Bearer <siwc_bypass_bearer_token>Sites procesa este encabezado y lo elimina antes de reenviar la solicitud a tu sitio. Si el sitio también requiere una credencial propia para su API, envíala por separado en el encabezado estándar Authorization, que Sites conserva.
Las solicitudes que usan el token no están asociadas a la identidad de un visitante que haya iniciado sesión. No reciben los encabezados de usuario autenticado descritos anteriormente ni tienen acceso a las apps conectadas de ningún visitante. Mantén las comprobaciones de autorización adicionales en el código del servidor de tu sitio. Usa el flujo habitual de inicio de sesión para las funciones que dependan de la identidad del visitante o de los permisos de los complementos.
Trata el token como un secreto. Cualquier persona que lo tenga puede acceder al sitio sin iniciar sesión. Guárdalo en el almacén de secretos de tu servicio y no lo incluyas en el código que se ejecuta en el navegador, en las URL ni en el sistema de control de versiones. Si el token queda expuesto, genera uno nuevo y actualiza los servicios o scripts que lo usen. El nuevo token funciona de inmediato, pero el anterior puede seguir siendo válido hasta que caduque la configuración almacenada en caché, durante un máximo de cinco minutos.
Incorpora datos de los usuarios a tu sitio con complementos
Usa complementos en Sites para crear un sitio que cargue datos de las apps que cada visitante haya conectado. Por ejemplo, en un panel de incidencias, tú puedes ver las incidencias que tienes asignadas y cada integrante de tu equipo puede ver las suyas. Cada visitante inicia sesión con ChatGPT, elige qué cuentas conectadas usar y decide qué acceso conceder.
El uso de complementos debe estar habilitado en el espacio de trabajo y el sitio debe ser privado y accesible solo para los miembros de ese espacio. Los visitantes deben pertenecer al espacio de trabajo y usar los permisos que ya tienen en las apps. Los administradores pueden consultar los permisos de cada complemento y las restricciones del inquilino en Habilitar el uso de complementos en Sites.
Crea un sitio con datos de apps conectadas
- Pídele a ChatGPT Work o a Codex que cree un sitio. Indica qué conector del complemento debe usar y qué debe hacer, o pregunta qué complementos están disponibles.
- Prueba la vista previa con datos reales. El agente usa tus conexiones disponibles mientras crea el sitio y genera la vista previa.
- Pídele al agente que publique el sitio para tu espacio de trabajo y comparta el enlace con tu equipo.
Por ejemplo:
También puedes crear un buscador de documentos con enlaces a los originales o una vista general del proyecto que combine tickets y mensajes.
Carga de datos
Al cargar la página, Sites lee los datos de las apps conectadas con la conexión y los permisos del visitante. Sites gestiona la caché y la recarga de datos. Si necesitas una opción para actualizar los datos manualmente, pídele a ChatGPT Work o a Codex que la agregue.
De forma predeterminada, Sites usa la acción Cargar más para obtener otra página de resultados cuando el conector devuelve un cursor.
Referencia técnica: descubrimiento de complementos
Sites usa getContext() para encontrar las acciones de un complemento. La función devuelve los nombres, las descripciones y los esquemas de las herramientas que están guardados en la caché. No vuelve a ejecutar el descubrimiento.
Para saber qué acciones admiten las apps conectadas y cuándo están disponibles, consulta Cómo crear y usar sitios con ChatGPT Sites en el Centro de ayuda.
Permite que los visitantes elijan sus conexiones
Para usar las funciones que dependen de las apps conectadas, cada visitante inicia sesión con ChatGPT, revisa el acceso a las apps que solicita el sitio, elige la cuenta conectada y el acceso que desea conceder, y regresa al sitio. Compartir el sitio no da acceso a tus cuentas conectadas. El sitio recibe datos de las apps que cada visitante autoriza.
Los visitantes pueden continuar sin conceder acceso a las apps, pero las funciones que requieren ese acceso no estarán disponibles. Si una app no está disponible, comprueba que esté conectada en el espacio de trabajo correcto y que la configuración de ese espacio permita usarla.