A2UI（智能体驱动 UI）

A2UI 让智能体不只返回纯文本，还能返回富交互界面——卡片、表单、行列布局等，由前端以原生组件渲染。适合状态卡片、信息摘要、选项列表、简单表单等天然适合可视化的场景。

A2UI 依赖可选组件包：pip install "veadk-python[a2ui]"。

启用

创建智能体时设置 enable_a2ui=True，智能体即可在合适的时候返回界面。默认使用内置的基础组件集，包含卡片、文本、按钮、分割线等常用组件：

agent.py

from veadk import Agent

agent = Agent(
    name="ui_agent",
    instruction="当答案天然适合可视化（状态卡片、摘要、选项、简单表单）时，用富界面回复；其余情况用纯文本。",
    enable_a2ui=True,
)

是否返回界面由模型按 instruction 判断——在提示词里说明「何时该用界面」，效果最佳。

A2UI 界面由前端渲染。用 VeADK Frontend 启动界面，与智能体对话即可看到返回的卡片等组件。

内置组件之外，企业可以扩展自己的组件（如营收图表、订单卡片）。一个自定义组件分两部分：

把自定义组件清单传给智能体的 a2ui_catalog 即可启用。前端渲染器的接入方式见 VeADK Frontend · 添加企业自定义组件。

未提供渲染器的组件会回退为可折叠的 JSON 视图，因此不会导致界面出错。