Appearance
调研来源
Agent UI 参考了现有 Agent UI 协议、SDK 和产品实现模式。标准不复制它们的 API，而是抽取其中反复出现的稳定 UI 要求。
主要外部参考
| Source | 相关模式 | Agent UI 如何吸收 |
|---|---|---|
| Vercel AI SDK UI | UIMessage parts、streaming text、reasoning/data/tool parts、tool state lifecycle、useChat。 | 证明 message parts 和 tool lifecycle states 应是一等 UI 概念。 |
| assistant-ui | Thread、ThreadList、composer、message part primitives、attachments、tool-call rendering、event-stream runtime adapter。 | 证明 UI components 需要 runtime adapters 和 scoped state access，而不是全局字符串解析。 |
| CopilotKit | Frontend tools、generative UI、shared state、human-in-the-loop、event-stream integrations。 | 证明用户可见工具和 approval UI 必须是受控 runtime interactions。 |
| OpenAI Apps SDK reference | Tool descriptors、structuredContent、component resources、_meta.ui.resourceUri、widget bridge、tool input/output notifications。 | 证明 rich UI 应挂在结构化 tool results 和 component boundaries 上，而不是从正文猜。 |
| OpenAI ChatKit guides | Client tools、file store integration、long-running tool progress、widgets、thread metadata。 | 证明 Agent UI 需要 tool progress、file/artifact contracts 和 chat text 之外的 thread state。 |
| Claude Artifacts help | substantial standalone content 会在主对话之外的 dedicated artifact area 打开。 | 证明 durable deliverables 需要 Artifact 工作区，而不是只停留在 assistant text。 |
Vercel AI SDK UIMessage | UIMessage.parts 包含 text、reasoning、tool、file、source 和 typed data parts。 | 证明 artifacts 应表示为 typed references 或 files，而不是从正文推断。 |
产品实现参考
Agent UI 也吸收了桌面 Agent 工作台规划中的经验：
- Conversation、process、task、artifact、evidence 应分层。
- Runtime 接受工作后，首文本前应显示 runtime status。
- Queue 和 steer 需要不同视觉语义。
- Artifacts 应离开 message body，进入 Artifact 工作区 surface。
- Artifact cards、previews、versions、diffs、exports 和 handoff links 是 UI 语义；完整内容存储仍在 Agent UI 之外。
- Evidence export、review、replay 应消费同一组 runtime facts，而不是 UI 猜测。
- 旧 session hydration 应 shell-first、recent-message-first、timeline-on-demand。
调研后的非目标
本标准刻意不强制：
- 某一种协议传输
- 某一个 React 组件库
- 某一种视觉风格
- 某一种工具 schema
- 某一种 artifact file store
- 某一家 vendor SDK
兼容客户端可以使用上述任意系统，只要保留 projection boundary。