> ## Documentation Index
> Fetch the complete documentation index at: https://docs.veadk.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# A2UI

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

<Note>
  A2UI 依赖可选组件包：`pip install "veadk-python[a2ui]"`。
</Note>

## 启用

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

```python title="agent.py" lines theme={null}
from veadk import Agent

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

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

## 查看效果

A2UI 界面由前端渲染。用 [VeADK Frontend](/productions/veadk/archives/1.0.3/zh/components/frontend/veadk-frontend) 启动界面，与智能体对话即可看到返回的卡片等组件。

## 自定义组件

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

* **后端**：声明一份组件清单，告诉模型有哪些可用组件；
* **前端**：为每个组件提供一个渲染器。

把自定义组件清单传给智能体的 `a2ui_catalog` 即可启用。前端渲染器的接入方式见 [VeADK Frontend · 添加企业自定义组件](/productions/veadk/archives/1.0.3/zh/components/frontend/veadk-frontend#添加企业自定义组件)。

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