a2ui-project / a2ui-project/a2ui

[FEATURE]: Ability for Agent to do append-only content generation without managing surfaces and surfaceIds

未关闭
#1,979 2 条评论 0 个 reaction 已指派 1 人 已被 @gspencergoog 认领 在 GitHub 查看
P2
主要语言
TypeScript
星标
16.4k
派生
1.3k
平均合并
2 天 13 小时
30 天内合并 PR
134

描述

One source of errors that we've always had with Gen UI and A2UI is when agents don't manage surface IDs correctly, e.g. they create duplicate surfaces or forget to create surfaces at all.

In the most common Gen UI use cases, the agent is just generating content as part of a turn, and never needs to update that content, so there is no need for it to write, read or reason about surface IDs. We should have some well-lit path (even a default!) which makes it this way.

This would eliminate this class of errors, and reduce latency by reducing the output tokens necessary to express a layout.

## Option 1: Hide `surfaceId` from LLM and programmatically inject surface IDs instead

We make it so that the inference format doesn't have any concept of `CreateSurface`. Instead, the LLM just defines components and then we automatically add a `CreateSurface` message.
- The inference APIs need some concept of "parse session" or "turn" etc, so that they know when to inject a new `CreateSurface` message with a surfaceId, and then add that surfaceId to all subsequent updateDataModel and updateComponents messages. We probably need this anyway, to help with validation.
- We can just use UUIDs etc for surfaceId
- This could be an option in the Express inference format etc, for chat use cases. Perhaps a boolean config like `manageSurfacesAutomatically`.

## Option 2: One MessageProcessor per Turn

We could recommend an integration approach where each turn in a conversation has a separate message processor handling the messages for it.

On the agent, we prompt it to just create a surface with any ID, or use option 1) above to inject some arbitrary surface ID so the LLM doesn't need to express it.

There are never surface ID conflicts, because each Turn now has a separate surface ID space. The downside is that the server does not have any ability to update surfaces on previous turns, because new content is always fed to a brand new `MessageProcessor`. But this is fine, and better, for most chat-based use cases.

## Recommendation

I think we should do option 1 first, because it is simpler to set up for the developer, and it's a nice step towards 2) anyway.

贡献指南

打开贡献指南

调研方向

The issue describes modifying the inference format and APIs to automatically manage surface IDs. Start by examining the Express inference format and the message processor logic to understand where `CreateSurface` messages are generated. Look for existing validation or session/turn management code. The goal is to add a configuration option like `manageSurfacesAutomatically` that injects surface IDs and removes the need for the LLM to handle them.

由索引模型根据 Issue 内容生成。

评估

技术栈
typescript
领域
backend-api-design
Issue 类型
功能
难度
4/5
预计耗时
3-5 天
活跃度
冷清
描述清晰度
基本清楚
新手友好度
35/100

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。