SuperAPI AI 工具集

making-forms-demo

办公与效率

查看项目

更新于 10-28 06:16

技能介绍

making-forms-demo 是一个示例技能,位于 googlecloudplatform/devrel-demos 仓库,用于演示如何在聊天窗口内构建访谈式交互界面,向用户收集生成 Web 表单所需的关键实现细节。

用途:在构建 Web 表单之前,通过提问确认用户对表单校验方式与校验提示位置的偏好,并把这些偏好持久化保存,供后续智能体调用。

主要能力:

  1. 状态读取:检查工作区根目录是否存在 user_prefs.json;若存在,则读取其中的 FORMS 对象,识别此前保存的偏好,并告知用户已识别到表单以及需要回答或确认几个问题。
  2. 询问校验类型:调用 ask_question 工具展示选项选择界面,问题为“How would you like to handle field validation? (select all that apply)”,选项包括 Client-side validation 与 Server-side validation,选中值作为 FIELD_VALIDATION_TYPE。若已有保存值,则在对应选项前加“(Current Setting) ”并排在最前。
  3. 询问校验提示位置:再次调用 ask_question 工具,问题为“How would you like to handle validation messages?”,选项包括 Above the field、Below the field、Summary Card、Tooltip,选中值作为 FIELD_VALIDATION_LOCATION;已有保存值时同样加前缀并置顶。
  4. 持久化偏好:使用 write_to_file 工具把选择写入工作区根目录的 user_prefs.json(或覆盖已有内容),结构为 FORMS 下的 FIELD_VALIDATION_TYPE 数组与 FIELD_VALIDATION_LOCATION 字符串。
  5. 输出确认:按“<FIELD_NAME>: <SELECTED_VALUE>”模板向用户输出表单选择作为确认。

使用方式:该技能为 mock 技能,仅用于说明如何在聊天窗口内创建访谈者 UI,并不会真正创建表单。实际流程为读取或询问偏好、写入 user_prefs.json、输出确认结果。

适用场景:演示智能体在生成表单前的需求访谈、偏好复用与状态持久化模式,适合作为开发参考示例。

限制:不执行实际表单构建;功能范围仅限上述问答、读写 user_prefs.json 和确认输出;其他能力暂未提供。