Sites

Sites 让 Codex 可以创建、保存、部署和检查由 OpenAI 托管的网站、web apps 和 games。当你想把 prompt 或兼容的现有 project 变成 hosted site，而不想单独设置 deployment workflow 时，请使用 Sites plugin。

每个 Sites deployment URL 都是 production deployment。如果你想在上线前 review build，请让 Codex 保存一个 version，但不要部署它。

Sites is in preview 和 currently 可用 for ChatGPT Business 和 Enterprise workspaces, 使用 more plans rolling out later。For ChatGPT Enterprise workspaces, an admin must turn it on through role-based access control (RBAC) 之前 members can 使用 it。Compare support by plan in Feature availability .

Enable Sites for an Enterprise workspace

如果 you 使用 ChatGPT Enterprise, ask your workspace admin 到 打开 the RBAC controls in ChatGPT admin settings 和 turn on Sites for the appropriate role。ChatGPT Business workspaces can skip this step because Sites is enabled by 默认.

添加 the Sites plugin

如果 Sites isn’t already 可用, 打开 Plugins in the Codex app, find Sites, 和 添加 it 到 Codex。启动 a 新的 thread 之后 installing a plugin.

启动 a Sites task

In a thread, describe the site you want 到 create 或 publish。You can name the plugin explicitly 使用 @Sites, especially 当 your task should end in a hosted deployment.

检查 whether 到 save 或 deploy

Ask Codex 到 validate the site’s build。Then tell it either 到 save a deployable version for 检查 或 到 deploy the approved saved version.

Return 到 deployed sites

打开 Sites in the app sidebar 到 return 到 your Sites projects。You can also ask Codex 到 inspect saved versions, check deployment status, 或 change who can access a deployed site.

For a 新的 website, dashboard, 或 internal tool, include the audience, core experience, 和 必需 data:

@Sites Build a project request dashboard for my operations team. Let team
members submit 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
request data saved between visits.

For an 已有 project, ask Sites 到 prepare 和 publish the 当前 app:

@Sites Deploy this project. Check whether it is compatible with Sites, make any
required changes, and give me the deployment URL.

当 a site needs durable application data 或 uploaded files, say so in the request:

@Sites Add persistent player scores and avatar uploads to this game. Use
the appropriate Sites storage and deploy the updated game.

Browse the Sites showcase for deployed internal apps 和 the full prompts used 到 create them.

A Sites project links a local source project 到 hosting managed through Sites。Codex stores that linkage 和 可选 storage binding names in .openai/hosting.json。A newly created local starter can begin 不使用 a project_id；Sites adds one 之后 it provisions the hosted project.

例如, a provisioned site that uses a relational database binding 和 no file storage can contain:

{
  "project_id": "<project-id>",
  "d1": "DB",
  "r2": null
}

Sites publishing has two separate stages:

Ask Codex 到 列出 或 inspect saved versions 当 you need 到 identify a previous deployment candidate.

Sites hosts projects that build Cloudflare Worker-compatible output as ES modules。For 新的 projects, the Sites workflow can 启动 使用 its recommended site starter。For an 已有 site, ask Codex 到 确认 that the project’s build can produce compatible deployment artifacts 之前 you request a deployment.

Tell Codex about the product behavior you need so it can 选择 the appropriate site shape:

Don’t request durable storage for temporary presentation state, such as a theme choice 或 a dismissed banner。Do request it for product data that people expect the hosted site 到 remember.

设置 the audience 之前 you share a deployed URL。For a 新的 site, keep access limited 到 the owner 和 workspace admins until you have reviewed the content, data handling, 和 expected audience.

You can ask Sites 到 应用 one of these access modes:

例如:

@Sites Change this deployed site's access to everyone in my workspace after
showing me the current site and confirming the deployment URL.

打开 Sites in the app sidebar 和 选择 a project 到 添加, update, 或 移除 hosted environment variables 和 secrets in the Sites panel。Don’t store these values in .openai/hosting.json。Keep local .env 和 .env.example files aligned 使用 the keys needed for local development, 和 don’t commit secret values.

当 you 添加, update, 或 移除 hosted environment values, ask Codex 到 redeploy the approved saved version so the next deployment uses the updated configuration.

Before you deploy 或 widen access: