Votre site peut avoir besoin d’enregistrer des demandes, de sauvegarder la progression des utilisateurs ou d’afficher des informations provenant d’applications connectées. Indiquez à ChatGPT quelles données enregistrer, d’où elles proviennent et qui doit y avoir accès.
Choisissez les fonctionnalités de stockage et de connexion
Pour un nouveau projet, le workflow de Sites peut s’appuyer sur le modèle de site recommandé. Pour un projet existant, demandez à ChatGPT de vérifier que le projet peut produire des artefacts de déploiement compatibles avant de demander son déploiement.
Décrivez ce que le site doit faire pour que ChatGPT puisse choisir les fonctionnalités nécessaires au stockage des données et à la gestion des identités.
| Besoin du site | Ce qu’il faut demander à Sites |
|---|---|
| Site axé sur le contenu ou page de destination | Un site sans état applicatif persistant, sauf si l’expérience utilisateur l’exige |
| Enregistrements, progression des utilisateurs ou scores de jeu à conserver | D1, une base de données relationnelle pour conserver durablement des données structurées |
| Images, documents, fichiers audio ou vidéo, ou autres fichiers importés | R2, un service de stockage objet pour les fichiers |
| Fichiers importés dont les métadonnées doivent permettre la recherche | D1 pour les métadonnées et R2 pour le contenu des fichiers |
| Site interne qui doit connaître l’identité du membre de l’espace de travail qui le consulte | L’identité de l’utilisateur authentifié dans l’espace de travail |
| Connexion sur un site public ou recours à un fournisseur d’identité externe | Un site doté d’un mécanisme d’authentification |
Ne demandez pas de stockage durable pour un état temporaire de l’interface, comme le thème choisi ou la fermeture d’une bannière. Demandez-le pour les données du produit que les utilisateurs s’attendent à retrouver sur le site hébergé.
Ajoutez la connexion avec ChatGPT
Un site public peut rester accessible à tous et proposer une connexion facultative avec ChatGPT pour les fonctionnalités qui dépendent de l’identité du visiteur, comme la sauvegarde de sa progression, les vues personnalisées ou l’accès à ses propres enregistrements. Les sites réservés à un espace de travail utilisent déjà l’identité ChatGPT pour appliquer leurs paramètres de partage.
Demandez à Sites d’ajouter la connexion avec ChatGPT.
Fonctionnement
Sites gère la connexion et la déconnexion via les chemins fournis par la plateforme, puis redirige le visiteur vers votre site.
<a href="/signin-with-chatgpt">Sign in with ChatGPT</a>
<a href="/signout-with-chatgpt">Sign out</a>Une fois le visiteur connecté, Sites transmet son identité au serveur dans les en-têtes de requête suivants.
oai-authenticated-user-emailcontient l’adresse e-mail authentifiée.oai-authenticated-user-full-namepeut contenir le nom renseigné dans le profil. Traitez cette valeur comme facultative et utilisez l’adresse e-mail si le nom est absent ou vide.
Gérez les décisions d’autorisation dans le code côté serveur, sans vous appuyer sur des en-têtes distincts pour le prénom et le nom de famille.
Appelez un site privé avec un jeton de contournement SIWC
Lorsqu’un script ou un service doit appeler un site qui exige une connexion, utilisez un jeton de contournement de la connexion avec ChatGPT (Sign in with ChatGPT, ou SIWC). Avec ce jeton, la requête peut franchir le contrôle de connexion du site sans session interactive dans un navigateur.
En tant que propriétaire du site, demandez à ChatGPT Work ou à Codex de générer un jeton pour votre site.
L’agent utilise generate_siwc_bypass_token et renvoie siwc_bypass_bearer_token. Chaque nouveau jeton remplace le jeton existant pour ce site. Mettez donc à jour tous les services qui utilisent l’ancienne valeur.
Envoyez le jeton dans l’en-tête de requête HTTP suivant.
OAI-Sites-Authorization: Bearer <siwc_bypass_bearer_token>Sites traite cet en-tête et le retire avant de transmettre la requête à votre site. Si votre site exige aussi son propre identifiant d’API, envoyez cet identifiant séparément dans l’en-tête standard Authorization, que Sites conserve.
Les requêtes qui utilisent le jeton de contournement ne sont associées à aucun visiteur connecté. Elles ne reçoivent pas les en-têtes d’identité décrits ci-dessus et ne donnent pas accès aux applications connectées d’un visiteur. Effectuez tout contrôle d’autorisation supplémentaire dans le code côté serveur de votre site. Utilisez le parcours de connexion habituel pour les fonctionnalités qui dépendent de l’identité du visiteur ou de ses autorisations d’utilisation des plugins.
Gardez le jeton secret. Toute personne qui le détient peut franchir le contrôle de connexion de ce site. Stockez-le dans le gestionnaire de secrets de votre service. Ne le placez pas dans le code exécuté par le navigateur, dans une URL ou dans un dépôt de code source. En cas de divulgation, générez un nouveau jeton et mettez à jour les scripts et services qui utilisent l’ancien. Le nouveau jeton fonctionne immédiatement, mais l’ancien peut rester valide jusqu’à l’expiration de la configuration mise en cache, pendant cinq minutes au maximum.
Intégrez les données des utilisateurs à votre site grâce aux plugins
Utilisez les plugins dans Sites pour créer un site qui charge les données des applications connectées de chaque visiteur. Par exemple, un tableau de bord peut vous présenter les tickets qui vous sont attribués et montrer à votre collègue ceux qui lui sont attribués. Chaque visiteur se connecte avec ChatGPT, choisit les comptes connectés à utiliser et décide des accès à accorder.
L’utilisation des plugins doit être activée dans l’espace de travail et le site doit être réservé à ses membres. Les visiteurs doivent appartenir à cet espace de travail et utiliser les autorisations dont ils disposent déjà dans les applications. Les administrateurs peuvent consulter les autorisations propres à chaque plugin et les restrictions applicables au locataire dans la section Activation des plugins dans Sites.
Créez un site qui utilise les données d’applications connectées
- Demandez à ChatGPT Work ou à Codex de créer un site. Indiquez le nom du connecteur du plugin et ce qu’il doit faire, ou demandez quels plugins sont disponibles.
- Testez l’aperçu avec des données réelles. L’agent utilise vos connexions disponibles pour créer le site et en afficher un aperçu.
- Demandez à l’agent de publier le site pour votre espace de travail et d’en partager le lien avec vos collègues.
Par exemple :
Vous pouvez aussi créer un outil de recherche documentaire qui renvoie aux documents d’origine ou une vue d’ensemble d’un projet qui regroupe les tickets et les messages.
Chargement des données
Au chargement de la page, Sites récupère les données des applications connectées avec la connexion et les autorisations du visiteur. Sites gère la mise en cache et le rechargement des données. Si nécessaire, demandez à ChatGPT Work ou à Codex d’ajouter une action d’actualisation manuelle.
Par défaut, lorsque le connecteur renvoie un curseur, Sites propose l’action Charger plus pour récupérer la page de résultats suivante.
Référence technique : découverte des plugins
Sites utilise getContext() pour identifier les actions d’un plugin. Cette fonction renvoie les noms, les descriptions et les schémas des outils mis en cache, sans relancer la découverte.
Pour savoir quelles actions des applications connectées sont prises en charge et dans quelles conditions elles sont disponibles, consultez l’article Créer et utiliser des sites avec ChatGPT Sites dans le centre d’aide.
Laissez les visiteurs choisir leurs connexions
Pour utiliser les fonctionnalités connectées, le visiteur se connecte avec ChatGPT, examine les accès aux applications demandés par le site, choisit le compte connecté à utiliser et les accès à accorder, puis revient sur le site. Partager le site ne donne pas accès à vos comptes connectés. Le site reçoit les données des applications auxquelles chaque visiteur lui donne accès.
Les visiteurs peuvent continuer sans accorder l’accès aux applications, mais les fonctionnalités qui en dépendent seront indisponibles. Si une application est indisponible, vérifiez qu’elle est connectée dans le bon espace de travail et que les paramètres de cet espace en autorisent l’utilisation.