@gea-ai/chat-ui
GEA代理聊天消息的公共反应渲染器. 软件包有标准
信件部分行为, 流出 Markdown, 请求 yaml-render,并且安全
在扩展控制下留下视觉身份时掉回.
使用量
import {
type AgentChatMessage,
GeaChatUIProvider,
GeaMessages,
} from "@gea-ai/chat-ui";
import "@gea-ai/chat-ui/styles.css";
export function Chat({
addToolOutput,
messages,
resolveAssetUrl,
}: {
addToolOutput: (input: {
messageId?: string;
tool: "request";
toolCallId: string;
output: unknown;
}) => Promise<void>;
messages: AgentChatMessage[];
resolveAssetUrl: (url: string) => string | null;
}) {
return (
<GeaChatUIProvider
actions={{
addToolOutput,
resolveAssetUrl,
}}
locale="zh-CN"
theme={{ accent: "#e46161", radius: "16px" }}
>
<GeaMessages messages={messages} status="streaming" />
</GeaChatUIProvider>
);
}
主办方拥有运输和授权权. 制造器从不开始聊天 请求保护资源本身.
GEA自己的网络/桌面 app-ui 使用同样的 GeaRequestPart 财务报告和审定财务报表
GeaYamlRender 运行时间、 注射宿主动作、 地点、 和薄阴影视觉
组件通过 yamlComponents请求
状态绑定、流出预览、跳出/提交状态以及提交
因此,语义在第一党和扩展党之间有一个执行
师曰.
自定义 YAML 组件接收规范绑定, 条形按钮动作,
和实地验证元数据。 视觉适配器应用提供的 ARIA/ data
属性, 调用 onFieldBlur,而使所提供的错误
解析 YAML, 运行验证规则, 自己的形式状态, 推断请求生命周期, 或
实施提交运输.
样式
导入默认样式表并覆盖语义变量或稳定
data-slot 选择者. GeaChatUIProvider 还接受视觉组件插槽
用于信件框、相机和部件渲染器. yamlComponents 替换
视觉执行目录组件而不改变其方案,
状态约束,或动作语义.
<GeaChatUIProvider
components={{ AssistantAvatar: BrandAvatar }}
theme={{ accent: "#c64141" }}
yamlComponents={{ Card: BrandRequestCard }}
>
{children}
</GeaChatUIProvider>
yaml-render
交互请求 UI 直接从一个 request 工具组件。 新设
特工打电话来 request({ yaml: "root: ..." })· ; yaml 包含完整
源代码没有 Markdown 栅栏,并将初始值放入顶级 YAML
state。无效的规格和遗留的请求键输入失败。 文本
yaml-render 栅栏仍然只显示,从未与请求相接.
当AI SDK部分 input-streaming,渲染器显示一个语义
加载占位符直到部分 YAML 有有效的根,然后使
最后一个有效的 spec作为锁定的预览。 它重载一次最终状态 当
部分变成 input-available,进行严格的请求验证,以及
立即解锁活动窗体, 即使相邻的助手文本继续
流畅.
提交通知
addToolOutput({ messageId, tool: "request", toolCallId, output }) 行动。 这个
渲染器包括固定助理 messageId 当它从一个
,但它并不具有持久性或连续性。 一个
扩展主机应通过
app.gea.chats.submitToolOutput(...),然后更新本地聊天状态和
恢复溪流。 没有动作, 主动请求失败 。 当a
更新消息使一个未回复的请求不活跃, 窗体仍然可见
锁定控件和 a Skipped编号 :已跳过 提交标签; 它不提交
窗体状态为用户消息.
字段绑定 checks 走向与他们相同的州道 value (或 checked 页:1
复选框). 运行时间支持 required, (中文(简体) ), requiredIf, (中文(简体) ), email, (中文(简体) ), url, (中文(简体) ),
numeric、长度/距离、模式和跨外地比较检查。 提交
调用前总是验证每个字段 addToolOutput· ; validateOn
较早的控件 change编号 :blur 反馈。 空的可选字段跳过其它
检查,而所需的复选框和评分字段需要肯定
选择。 要求必须用 required 或者说 requiredIf
检查;标签中的"需要"等词没有验证意义.
name:
type: Input
props:
label: Name
value: { $bindState: /name }
checks:
- type: required
message: Name is required
validateOn: blur
children: []
完成请求 YAML 有不支持的规则,无效的规则参数,或 不安全的状态引用失败 。 验证消息生成 UI 复制并应当使用与对话相同的语言.