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
What this source teaches
- 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.
Where AwesomeDS applied it
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
Implementations and artifacts
No directly linked artifacts.
Caveats & anti-imitation
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.