微件工具

您可以使用 widget 工具以灵活的方式为界面创建丰富的互动式界面元素。配置此工具时,您需要提供类型(轮播、比较等)以及有关 widget 架构的信息。在回答查询时,代理可能会决定使用此工具和配置将 widget 数据发送回您的客户端。然后,客户端会处理这些数据,并在界面中显示相应 widget。 当用户做出选择时,您会将此信息发送回代理。

配置

以下配置设置可用:

  • 名称: 工具的唯一名称(必需)。
  • 说明: 工具的功能说明(可选)。 这有助于代理的语言模型了解何时使用此工具以及如何填充数据。
  • 微件类型: 此工具所代表的富媒体内容微件的具体类型。 这决定了载荷的预期结构以及客户端应如何呈现载荷。 类型如下:
    • PRODUCT_CAROUSEL:显示可滚动的商品轮播界面。
    • PRODUCT_DETAILS:显示单个商品的详细信息。
    • QUICK_ACTIONS:显示建议的回复按钮或用户可以采取的操作的列表。
    • PRODUCT_COMPARISON:并排显示多个商品的比较结果。
    • ORDER_SUMMARY:显示订单摘要。
  • 参数: widget 数据的输入架构。 代理在调用工具时会使用该架构。 这是使用架构对象定义的,用于指定 widget 内容的预期字段和数据类型。

工具说明示例

以下是一些有效的工具说明示例:

微件类型 工具说明示例
商品轮播界面 生成界面轮播组件。每当用户要求查看选项或目录时,都需要提供此参数。您必须在 productDetails 中提供商品列表,系统会自动呈现视觉卡片。
商品详情 在您获取商品信息并尝试向用户展示该商品后,应调用此工具。
快捷操作 每当系统提示用户选择其身份是企业、学校还是非营利组织时,都应调用此工具。包含 3 个快速操作,分别为“我是商家”“我是学校”和“我是公益组织”。
产品比较 当您需要比较 2 款产品时,应调用此工具。
订单摘要 当用户准备好完成购买时,请使用此工具。它会生成商品的结构化视觉摘要、价格明细(包括税费和运费)以及已记录的付款方式。仅在用户确认要继续进入结账阶段后调用此工具。