a2ui官方旅行规划示例可以通过脚本同时准备python服务和react客户端,用内置的录制行程先查看真实界面,再按需要接入在线模型。环境要求为python 3.11或更高、node.js 20或更高;选择flutter客户端时,另需flutter 3.38或更高。

The React client: flight cards in the conversation, the trip so far beside it
下载示例并启动React客户端
git clone https://github.com/a2ui-project/labs cd labs/samples/travel-a2ui ./scripts/quickstart.sh react
脚本按示例配置准备依赖并启动服务,Python服务使用8080端口。按终端输出打开React页面,先查看预置行程;这是无需模型Key的录制路径。若选择同时启动Flutter和React,可使用脚本的both选项,只有React环境时不必安装Flutter。

The Flutter client in a phone layout, with the trip sheet open
区分页面代码与A2UI组件
聊天输入区和应用外壳由应用代码提供,行程卡片等内容由A2UI消息交给渲染器绘制。Catalog页显示Agent可用的组件,Wire页可对照模型写出的Express格式与客户端接收的A2UI JSON。检查这两处能帮助判断问题发生在消息生成还是组件渲染。

The Wire tab: the Express the model wrote, beside the A2UI JSON the client received
再切换到在线模型
实时对话需要按示例要求配置Gemini API Key,并保持Python服务与客户端均可访问。只在自己控制的开发环境使用Key,不把Key提交到仓库。该样例用于理解协议、流式消息和客户端交互,正式部署还需要补齐认证、权限及业务提交检查。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











