Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design

Daten und Verbindungen

Speichere Datensätze, verbinde Apps und füge deiner Website eine Anmeldefunktion hinzu

Vielleicht soll deine Website Anfragen speichern, Fortschritte festhalten oder Informationen aus verbundenen Apps anzeigen. Sag ChatGPT, was die Website speichern soll, woher die Informationen stammen und wer darauf zugreifen darf.

Funktionen für Speicherung und Anmeldung auswählen

Bei neuen Projekten kann Sites mit der empfohlenen Website-Vorlage starten. Lass dir bei einem bestehenden Projekt von ChatGPT bestätigen, dass das Projekt kompatible Bereitstellungsartefakte erzeugen kann. Fordere erst dann die Bereitstellung an.

Beschreibe, was die Website leisten soll, damit ChatGPT die erforderlichen Funktionen für Datenspeicherung und Identitätsverwaltung auswählen kann.

Was deine Website braucht Was du bei Sites anfordern kannst
Website mit Schwerpunkt auf Inhalten oder Landingpage Eine Website, die den Anwendungszustand nur dann dauerhaft speichert, wenn die Nutzung das erfordert
Gespeicherte Datensätze, persönliche Fortschritte oder Punktestände in Spielen D1, eine relationale Datenbank zur dauerhaften Speicherung strukturierter Daten
Bilder, Dokumente, Audio- und Videodateien oder andere Uploads R2, ein Objektspeicher für Dateien
Hochgeladene Dateien mit durchsuchbaren Metadaten D1 für Metadaten und R2 für Dateiinhalte
Interne Website, die wissen muss, welches Workspace-Mitglied sie gerade nutzt Die über den Workspace authentifizierte Identität
Öffentliche Anmeldung oder externer Identitätsanbieter Eine Website mit aktivierter Authentifizierung

Fordere für vorübergehende Anzeigeeinstellungen wie ein ausgewähltes Design oder ein ausgeblendetes Banner keinen dauerhaften Speicher an. Fordere ihn für Produktdaten an, die aus Sicht der Nutzenden auf der gehosteten Website erhalten bleiben sollen.

Anmeldung mit ChatGPT hinzufügen

Öffentliche Websites können für alle zugänglich bleiben und eine freiwillige Anmeldung mit ChatGPT anbieten. Damit können sie Fortschritte speichern, personalisierte Ansichten anzeigen oder Datensätze einer bestimmten Person zuordnen. Websites, auf die nur Workspace-Mitglieder zugreifen dürfen, nutzen bereits die ChatGPT-Identität, um ihre Freigabeeinstellungen durchzusetzen.

Bitte Sites, die Anmeldung hinzuzufügen.

Füge dieser öffentlichen Website die Anmeldung mit ChatGPT hinzu. Die Website soll auch ohne Anmeldung zugänglich bleiben. Zeige Personen, die nicht angemeldet sind, die Option „Mit ChatGPT anmelden“. Begrüße sie nach der Anmeldung mit ihrem vollständigen Namen, sofern er verfügbar ist, andernfalls mit ihrer E-Mail-Adresse. Füge die Option „Abmelden“ hinzu und entscheide im serverseitigen Code, welche Zugriffe zulässig sind.
So funktioniert es

Sites nutzt für die An- und Abmeldung die von der Plattform bereitgestellten Pfade und leitet die Person anschließend zurück zu deiner Website.

<a href="/signin-with-chatgpt">Sign in with ChatGPT</a>
<a href="/signout-with-chatgpt">Sign out</a>

Nach der Anmeldung übermittelt Sites die Identität der Person in diesen Anfrage-Headern an den Server:

  • oai-authenticated-user-email enthält die authentifizierte E-Mail-Adresse.
  • oai-authenticated-user-full-name kann einen Profilnamen enthalten. Diese Angabe ist optional. Fehlt der Name oder ist er leer, verwende die E-Mail-Adresse.

Entscheide im serverseitigen Code, welche Zugriffe zulässig sind. Verlass dich dabei nicht auf Header, die den Namen in einzelne Bestandteile aufteilen.

Eine private Website mit einem SIWC-Bypass-Token aufrufen

Verwende ein Bypass-Token für die Anmeldung mit ChatGPT (Sign in with ChatGPT, SIWC), wenn ein Skript oder Dienst eine Website aufrufen muss, die eine Anmeldung erfordert. Mit dem Token kann die Anfrage die Anmeldeprüfung der Website ohne interaktive Browsersitzung passieren.

Wenn dir die Website gehört, bitte ChatGPT Work oder Codex, ein Token für sie zu generieren.

Generiere für diese Website ein Bypass-Token für die Anmeldung mit ChatGPT, damit mein Dienst die Website ohne Anmeldung im Browser aufrufen kann.

Der Agent verwendet generate_siwc_bypass_token und gibt siwc_bypass_bearer_token zurück. Wenn du ein neues Token generierst, ersetzt es das bisherige Token dieser Website. Aktualisiere deshalb alle Dienste, die den bisherigen Wert verwenden.

Sende das Token in diesem HTTP-Anfrage-Header:

OAI-Sites-Authorization: Bearer <siwc_bypass_bearer_token>

Sites wertet diesen Header aus und entfernt ihn, bevor es die Anfrage an deine Website weiterleitet. Wenn deine Website zusätzlich eigene API-Zugangsdaten erfordert, sende diese separat im regulären Authorization-Header. Diesen Header leitet Sites unverändert weiter.

Anfragen mit einem Bypass-Token sind keiner angemeldeten Person zugeordnet. Sie erhalten weder die oben beschriebenen Header mit den Daten einer authentifizierten Person noch Zugriff auf deren verbundene Apps. Führe zusätzliche Berechtigungsprüfungen im serverseitigen Code deiner Website durch. Verwende den regulären Anmeldevorgang für Funktionen, die von der Identität oder den Plugin-Berechtigungen der Person abhängen, die deine Website nutzt.

Halte das Token geheim. Wer es besitzt, kann die Anmeldeprüfung dieser Website passieren. Bewahre es im Geheimnisspeicher deines Dienstes auf. Halte es aus Browsercode, URLs und der Versionsverwaltung heraus. Wird das Token offengelegt, generiere ein neues und aktualisiere alle Skripte und Dienste, die das Token verwenden. Das neue Token funktioniert sofort. Das bisherige Token kann bis zum Ablauf der zwischengespeicherten Konfiguration noch bis zu fünf Minuten gültig bleiben.

Mit Plugins persönliche Daten auf deiner Website anzeigen

Mit Plugins in Sites kannst du eine Website erstellen, die für jede Person Daten aus ihren eigenen verbundenen Apps lädt. Ein Issue-Dashboard kann dir beispielsweise die Issues anzeigen, die dir zugewiesen sind. Andere Teammitglieder sehen jeweils die ihnen zugewiesenen Issues. Wer die Website besucht, meldet sich mit ChatGPT an und wählt aus, welche verbundenen Konten die Website nutzen und worauf sie zugreifen darf.

Im Workspace muss die Nutzung von Plugins aktiviert sein. Die Website darf nur innerhalb dieses Workspaces zugänglich sein. Wer die Website nutzt, muss dem Workspace angehören und greift mit den eigenen bestehenden App-Berechtigungen auf die Daten zu. Admins können die Berechtigungen einzelner Plugins und die Einschränkungen für Mandanten prüfen. Einzelheiten dazu stehen im Abschnitt Nutzung von Plugins in Sites aktivieren.

Eine Website mit Daten aus verbundenen Apps erstellen

  1. Bitte ChatGPT Work oder Codex, eine Website zu erstellen. Nenne den Plugin-Konnektor und beschreibe, was er tun soll, oder frage, welche Plugins verfügbar sind.
  2. Teste die Vorschau mit echten Daten. Der Agent nutzt deine verfügbaren Verbindungen, wenn er die Website erstellt und die Vorschau anzeigt.
  3. Bitte den Agenten, die Website für deinen Workspace zu veröffentlichen und den Link mit deinem Team zu teilen.

Beispiel:

Erstelle eine Website, die meinen verbundenen Issue-Tracker nutzt und die mir zugewiesenen Issues nach Priorität gruppiert anzeigt. Füge Projektfilter, Links zu den ursprünglichen Issues und eine Schaltfläche „Aktualisieren“ hinzu.

Du kannst auch eine Dokumentensuche erstellen, die auf die Originaldokumente verweist, oder eine Projektübersicht, die Tickets und Nachrichten zusammenführt.

Daten laden

Beim Laden der Seite ruft Sites die Daten über die Verbindung und mit den Berechtigungen der Person ab, die die Website gerade nutzt. Sites kümmert sich um das Zwischenspeichern und erneute Laden der Daten. Bitte ChatGPT Work oder Codex bei Bedarf, eine Option zum manuellen Aktualisieren hinzuzufügen.

Wenn der Konnektor einen Cursor zurückgibt, bietet Sites standardmäßig die Aktion Mehr laden an, um die nächste Ergebnisseite abzurufen.

Technische Referenz zur Ermittlung von Plugin-Aktionen

Sites ermittelt mit getContext(), welche Aktionen ein Plugin anbietet. Die Funktion gibt die zwischengespeicherten Tool-Namen, Beschreibungen und Schemas zurück, ohne die verfügbaren Aktionen erneut zu ermitteln.

Welche Aktionen für verbundene Apps unterstützt werden und wann sie verfügbar sind, erfährst du im Hilfecenter im Artikel Websites mit ChatGPT Sites erstellen und nutzen.

Wer die Website nutzt, wählt die eigenen Verbindungen aus

Wer Funktionen für verbundene Apps nutzen möchte, meldet sich mit ChatGPT an und prüft, welche App-Zugriffe die Website anfordert. Die Person wählt das verbundene Konto aus, legt die zulässigen Zugriffe fest und kehrt zur Website zurück. Wenn du die Website teilst, erhält dadurch niemand Zugriff auf deine verbundenen Konten. Die Website erhält für jede Person Daten aus den Apps, für die diese Person den Zugriff erlaubt hat.

Die Website lässt sich auch ohne Freigabe des App-Zugriffs weiter nutzen. Funktionen, die diesen Zugriff benötigen, stehen dann nicht zur Verfügung. Wenn eine App nicht verfügbar ist, prüfe, ob sie im richtigen Workspace verbunden ist und die Workspace-Einstellungen ihre Nutzung zulassen.