ref.openai.apps-sdk-ui-guidelines · implementation
OpenAI Apps SDK UI Guidelines
OpenAI Apps SDK UI guidelines for conversation-embedded surfaces: display-mode selection, a two-action limit, inline cards and carousels, no nested scrolling or deep navigation inside cards, persistent edits, and accessible host-native components. The rules are specific to the ChatGPT host; only the bounded conversational-surface principles generalise beyond it.
https://developers.openai.com/apps-sdk/concepts/ui-guidelines
この標準文書は未翻訳です。以下に英語の原文を表示します。
この情報源から得られる知見
- Generalize into a host-agnostic 'conversation-embedded surface' contract: choose the smallest sufficient display mode, eliminate duplicate assistant/card content, keep actions few and explicit.
- Persistent edits contract: user changes to generated content must persist across conversation turns unless explicitly reset.
- No nested scroll inside card surfaces and no deep navigation — these constraints protect conversational spatial coherence and should be applied to any conversation-embedded UI.
- Always preserve a non-chat/manual path for every task that a conversational agent can perform.
AwesomeDSへの反映先
rule.adaptation.hosted-embedded-surfaces— Adapt product surfaces to the host without surrendering task continuityrule.ai.generative-boundaries— Agents compose approved contractsrule.trust.embedded-ui-boundary— Treat every embedded agent UI as a hostile capability boundary
実装・成果物
直接リンクされた成果物はありません。
注意事項と模倣防止
Transfer the smallest-sufficient-mode, few-explicit-actions, and persistent-edits principles; keep ChatGPT-specific display modes and action counts scoped to OpenAI host context.