Sites
如需完整文档索引,请参阅 llms.txt。文档页面的 Markdown 版本可通过在页面后追加
.md来获取 URL。
Sites 处于公开测试阶段。可用性可能取决于你的计划、地区和 工作区设置。在测试期间,特定计划的使用限制适用于所有 Sites 。 ChatGPT 会显示当前限制,并在你接近 某个限制时通知你。达到限制可能会阻止你创建 Site、添加存储,或 让高使用量的 Site 保持公开,但你仍可编辑和管理现有的 Sites。
Sites 让 ChatGPT 创建、托管、优化和分享网站、Web 应用和游戏。 当你想把提示词或兼容的现有项目转为 托管体验,而无需设置单独的部署工作流时,请使用 Sites。
打开 Sites ,位置在 ChatGPT 桌面应用中。你可以从提示词或 兼容的本地项目开始创建站点,然后返回 Sites 视图进行管理。
在网页端的 ChatGPT 中使用 Sites 来创建和管理托管站点。选择 更多 > Sites,或直接前往 chatgpt.com/sites,以查找你创建的 Sites。
Sites 没有独立的 Codex CLI 管理视图。使用 ChatGPT 网页端或 桌面应用来创建、保存、部署和管理 Sites 项目。你仍然可以使用 来编辑和测试本地项目, Codex CLI 然后再发布它。
Sites 没有独立的 IDE 扩展管理视图。使用 ChatGPT 网页端 或桌面应用执行 Sites 操作,并使用 IDE 扩展来编辑和 测试本地源项目。
每次 Sites 部署 URL 都是生产部署。如果你想在构建上线前进行审查, 请要求 ChatGPT 保存一个版本但不部署 它。
开始使用 Sites
Section titled “开始使用 Sites”在 ChatGPT中,在提示词里包含“website”一词,或提及 @Sites 以
显式启动 Sites 工作流。
-
描述 Site
描述 Site 应使用的受众、目的、所需行为和信息 。
-
审查 Site
审查生成的内容和行为。检查 Site 是否使用了 预期信息,并按预期处理数据。
-
优化 Site
描述你想要的更改。在有助于 完成更改时,添加相关文件或视觉上下文 ChatGPT 。
-
管理并分享 Site
返回 Sites 以重新打开或优化 Site。准备就绪后,选择谁 可以访问它,并分享生成的链接。
在预览中,选择 编辑。在 描述网站编辑下,描述 你想要的更改。在需要更多 截图 或 添加文件和更多 上下文会有帮助时使用 。
使用提示词完成常见 Sites 任务
Section titled “使用提示词完成常见 Sites 任务”对于新网站、仪表板或内部工具,请包含受众、核心 体验和所需信息:
Build a project request dashboard for my operations team. Let team memberssubmit requests, see who owns each one, update the status, and filter the list.Require people to sign in with their workspace account, and keep the requestdata saved between visits.对于现有项目,请让 Sites 准备并发布当前应用:
Deploy this project with Sites. Check whether it is compatible, make anyrequired changes, and give me the deployment URL.当站点需要持久应用数据或上传文件时,请在 请求中说明:
Add player scores and avatar uploads to this game. Keep the scores and uploadedavatars between visits.浏览 Sites 展示 ,查看已部署的内部应用和用于创建它们的完整 提示词。
查看 Site 分析
Section titled “查看 Site 分析”Sites 会自动记录流量,因此你无需添加 analytics 即可了解人们如何使用已部署的 SDKSite。分析视图会显示总唯一 访客数和页面浏览量,以及这两个指标随时间的变化。更改日期范围或 粒度以查看不同时间段。
打开 Sites,找到该 Site,然后选择 更多操作 > 分析。
前往 chatgpt.com/sites,找到该 Site,然后选择 更多操作 > 分析。
Sites 在 CLI 或 IDE 扩展中没有独立的分析视图。打开 网页端或桌面应用中的该 Site ChatGPT 以查看其分析。
交互内容: SitesAnalyticsIllustration 的动态演示请参阅页面顶部的官方原文链接。
分析目前适用于不属于 Enterprise 工作区的 Sites。
添加 Sign in with ChatGPT
Section titled “添加 Sign in with ChatGPT”Public Sites 可以继续向所有人开放,同时提供可选的 Sign in with ChatGPT ,用于支持感知身份的功能,例如保存进度、个性化视图, 或属于特定人员的记录。受工作区限制的 Sites 已经 使用 ChatGPT 身份来强制执行其分享设置。
让 Sites 添加登录体验:
Add Sign in with ChatGPT to this public Site. Keep the Site available to signed-out visitors. Show a Sign in with ChatGPT action when someone is signed out. After they sign in, greet them with their full name when available, or their email address otherwise. Add a Sign out action, and keep authorization decisions in server-side code.Sites 通过平台提供的路径处理登录和退出流程, 然后将访问者返回到你的 Site:
<a href="/signin-with-chatgpt">Sign in with ChatGPT</a><a href="/signout-with-chatgpt">Sign out</a>访问者登录后,Sites 会通过 这些请求标头将其身份转发给服务器:
oai-authenticated-user-email包含已认证的电子邮件地址。oai-authenticated-user-full-name可能包含非空的个人资料名称。将 其视为可选项,并回退到电子邮件地址。
将授权决策保留在服务器端代码中,不要依赖 姓名拆分标头。
了解项目、版本和部署
Section titled “了解项目、版本和部署”Site 是一个持久的托管输出,你可以从 中的 Sites 重新打开、优化、配置 ChatGPT并分享。
Sites 项目会将本地源项目关联到通过 Sites 管理的托管。
Sites 会将该关联以及可选的存储绑定名称存储在
.openai/hosting.json中。新创建的本地起始项目可以在没有
project_id的情况下开始;Sites 会在预配托管项目后添加一个。
例如,使用关系数据库绑定且不使用 文件存储的已预配站点可以包含:
{ "project_id": "<project-id>", "d1": "DB", "r2": null}即使创建 Site 的 ChatGPT Work 聊天结束后,该 Site 仍会显示在你的 Sites 列表中。 你不需要本地项目或清单就能在网页端开始创建 Site。Site 不同于 ChatGPT Project。
Sites 发布有两个独立阶段:
- 保存版本。 ChatGPT 会构建一个可部署版本。对于本地源 项目, ChatGPT 会将该版本与用于 构建的 Git 提交关联。当你想要可审查的部署候选版本时使用此阶段。
- 部署版本。 ChatGPT 会发布已保存的版本,并在部署成功时报告 生产 URL 。当你希望 所选受众访问该站点时才使用此操作。
当你需要识别 ChatGPT 以前的部署候选版本时,请让 列出或检查已保存的版本。
选择受支持的 Site 形态
Section titled “选择受支持的 Site 形态”对于新项目,Sites 工作流可以从其推荐的 Site 起始项目开始。对于现有项目,请让 ChatGPT 确认该项目能否 生成兼容的部署产物,然后再请求部署。
告诉 ChatGPT 你需要的产品行为,以便它选择合适的 站点形态:
| Site 需求 | 要向 Sites 请求什么 |
|---|---|
| 内容主导的网站或落地页 | 没有持久应用状态的 Site,除非体验需要它 |
| 保存的记录、用户进度或游戏分数 | D1,用于持久结构化数据的关系数据库 |
| 图片、文档、音频、视频或其他上传内容 | R2,用于文件的对象存储 |
| 带有可搜索元数据的上传文件 | D1 用于元数据,并且 R2 用于文件内容 |
| 需要当前工作区用户身份的内部站点 | 工作区认证的用户身份 |
| 公开登录或外部身份提供商 | 启用身份验证的 Site |
不要为临时展示状态请求持久存储,例如 主题选择或已关闭的横幅。对于人们 希望托管站点记住的产品数据,请请求持久存储。
控制访问权限和机密信息
Section titled “控制访问权限和机密信息”新 Site 在你更改其 访问权限前,仅限其所有者和工作区管理员访问。在审查内容、数据处理和 预期受众期间,请保持访问权限受限。
根据你的账户和工作区设置,分享选项可能包括:
- 所有者和工作区管理员
- 指定的活跃用户或群组(如受支持)
- 工作区中的任何人(如受支持)
- 互联网中的任何人(仅当启用公开发布时)
分享允许人们访问 Site;不会允许他们编辑它。在 Enterprise 工作区中,公开发布默认关闭,必须由管理员启用。
对于受限分享,受邀访问者必须使用 获得访问权限的账号登录。Public Site 无需 ChatGPT 工作区访问权限即可访问。一个 Site 的受众设置和 Site 内置的任何登录功能是独立的 控制项。
例如:
Change this Site's access to everyone in my workspace after showing me thecurrent Site and confirming its URL.配置运行时环境值
Section titled “配置运行时环境值”打开 Sites,然后打开 Site 的设置,以添加、更新或移除托管的 环境变量和密钥。不要在提示词、附加 文件和 Site 内容中包含密钥值。
前往 chatgpt.com/sites,找到该 Site,然后选择 更多操作 > 设置。
不要将这些值存储在 .openai/hosting.json中。保持本地 .env 和
.env.example 文件与本地开发所需的键保持一致,并且
不要提交密钥值。
当你添加、更新或移除托管环境值时,请让 ChatGPT 重新部署 已批准的已保存版本,以便下一次部署使用更新后的 配置。
连接自定义域名
Section titled “连接自定义域名”在自定义域名可用的地方,你可以连接已拥有的 apex domain 或 subdomain 。Sites 不会为你注册域名,因此你必须能够 更改该域名的 DNS 记录。自定义域名在发布时不适用于 Enterprise 工作区。
连接域名:
- 打开 Site 设置并选择 添加域名。
- 输入你想使用的 apex domain 或 subdomain。
- 复制 Sites 提供的 DNS 记录和值,然后通过你的 域名提供商添加它们。
- 等待几分钟,然后返回 Site 设置并刷新域名 状态。
你也可以让 ChatGPT 帮助将域名指向你的 Site。如果启用了浏览或 计算机使用, ChatGPT 可以在你登录后帮助你导航域名提供商 。
分享前进行审核
Section titled “分享前进行审核”分享 Site 前:
- 检查其内容、生成的文本和图片、链接、上传的文件、表单, 以及交互行为。
- 确认它不会暴露机密或敏感信息、密钥 值,或你无权分享的第三方内容。
- 从预期访客体验出发测试该 Site,包括其访问和 登录行为。
- 检查会收集个人信息或其他访客内容的功能。 决定该 Site 是否应收集、分享或发布这些信息。
- 如果该 Site 使用 Sign in with ChatGPT,请说明它接收哪些访客信息 以及如何使用这些信息。
- 如果该 Site 收集或处理个人数据,请遵守 适用的隐私和数据保护法律。
- 选择符合预期受众的最小范围分享选项。
- 打开已分享的 Site,并确认预期受众可以访问它。
对于基于本地项目构建的 Site,还要检查源代码更改以及任何 数据库迁移,位置在 Codex 审查窗格中。
下线或删除 Site
Section titled “下线或删除 Site”若要在不删除 Site 的情况下移除访问权限,请打开其分享设置并将 访问权限限制为仅自己或指定人员。确认先前的受众 不再能打开它。
永久删除 Site:
- 打开 Sites 并找到该 Site。
- 选择 删除 Site,然后按照提示中的说明操作。
- 输入 Site slug,然后选择 永久删除。
删除 Site 会将其永久移除。已删除的 Site 无法恢复。
了解限制和不支持的用途
Section titled “了解限制和不支持的用途”Sites 托管在受支持的 Sites 运行时中运行的 Web 体验。某些 框架、专用网络、数据库、后台服务和托管 模式不受支持。
Sites 在发布时不支持数据驻留或推理驻留。这 包括已部署的 Sites、Site 代码、 D1 以及 R2 数据和文件存储、生成的 工件和日志。
不要使用 Sites 处理受保护的健康信息或支付卡数据; 面向 13 岁以下儿童或适用的数字同意年龄以下人群;启用 金融交易;传播恶意软件;启用网络钓鱼;冒充个人 或组织;或以其他方式违反 OpenAI 政策。请参阅 创建和管理 ChatGPT Sites 以了解当前限制和政策链接。