Back to Details

chatgpt-app-builder

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Creating Apps For LLMs

为LLM创建应用

ChatGPT apps are conversational experiences that extend ChatGPT through tools and custom UI widgets. They're built as MCP servers invoked during conversations.
⚠️ The app is consumed by two users at once: the human and the ChatGPT LLM. They collaborate through the widget—the human interacts with it, the LLM sees its state. Internalize this before writing code: the widget is your shared surface.
SPEC.md keeps track of the app's requirements and design decisions. Keep it up to date as you work on the app.
No SPEC.md? Stop. → Read discover.md first. Nothing else until SPEC.md exists.
ChatGPT应用是通过工具和自定义UI组件扩展ChatGPT的对话式体验。它们以MCP服务器的形式构建，在对话过程中被调用。
⚠️ 该应用同时服务两类使用者：人类用户和ChatGPT LLM。他们通过组件协作——人类用户与组件交互，LLM则能看到组件的状态。在编写代码前请牢记这一点：组件是你们的共享交互面。
SPEC.md用于记录应用的需求和设计决策。在开发应用过程中请保持其内容更新。
没有SPEC.md？停止操作。 → 先阅读discover.md。在SPEC.md创建完成前，不要进行其他操作。

Setup

环境搭建

  1. Copy template → copy-template.md: when starting a new project with ready SPEC.md
  2. Run locally → run-locally.md: when ready to test, need dev server or ChatGPT connection
  1. 复制模板 → copy-template.md：当开始一个已有现成SPEC.md的新项目时使用
  2. 本地运行 → run-locally.md：当准备测试、需要开发服务器或连接ChatGPT时使用

Architecture

架构设计

Design or evolve UX flows and API shape → architecture.md
设计或优化UX流程与API架构 → architecture.md

Implementation

实现环节

  • Fetch and render data → fetch-and-render-data.md: when implementing server handlers and widget data fetching
  • State and context → state-and-context.md: when persisting widget UI state and updating LLM context
  • Prompt LLM → prompt-llm.md: when widget needs to trigger LLM response
  • UI guidelines → ui-guidelines.md: display modes, layout constraints, theme, device, and locale
  • External links → open-external-links.md: when redirecting to external URLs or setting "open in app" target
  • OAuth → oauth.md: when tools need user authentication to access user-specific data
  • CSP → csp.md: when declaring allowed domains for fetch, assets, redirects, or iframes
  • 获取并渲染数据 → fetch-and-render-data.md：当实现服务器处理器和组件数据获取时使用
  • 状态与上下文 → state-and-context.md：当持久化组件UI状态并更新LLM上下文时使用
  • 提示LLM → prompt-llm.md：当组件需要触发LLM响应时使用
  • UI指南 → ui-guidelines.md：包含显示模式、布局约束、主题、设备和区域设置
  • 外部链接 → open-external-links.md：当重定向到外部URL或设置“在应用中打开”目标时使用
  • OAuth → oauth.md：当工具需要用户认证以访问用户特定数据时使用
  • CSP → csp.md：当声明允许的获取、资源、重定向或iframe域名时使用

Deploy

部署环节

  • Ship to production → deploy.md: when ready to deploy via Alpic
  • Publish to ChatGPT Directory → publish.md: when ready to submit for review
Full API docs: https://docs.skybridge.tech/api-reference.md
  • 上线到生产环境 → deploy.md：当准备通过Alpic部署时使用
  • 发布到ChatGPT目录 → publish.md：当准备提交审核时使用
完整API文档：https://docs.skybridge.tech/api-reference.md