本文介绍如何使用 AI_CHOICE,通过决策模型从给定的候选类别中选择一个类别。
使用限制
仅实时计算引擎 VVR 11.10.preview1 及以上版本支持。
使用前需开通 Flink AI服务(内置模型)。
模型注册、执行要求和错误处理,请参见决策函数使用概述。
语法
AI_CHOICE(
MODEL => MODEL <model_name>,
STATE => <state>,
QUESTION => <question>,
CRITERIA => <criteria>
[, DETAILS => <details>]
[, CONFIG => <config>]
[, FAIL_ON_ERROR => <fail_on_error>]
)
入参
参数 | 数据类型 | 是否必填 | 默认值 | 说明 |
MODEL | MODEL | 是 | 无 | 已注册的决策模型,输出列须为 |
STATE | STRING 或 VARIANT | 是 | 无 | 待分类的内容。 |
QUESTION | STRING | 是 | 无 | 描述分类目标的非 |
CRITERIA | MAP<STRING, STRING> | 是 | 无 | 候选类别及描述。键为类别标签,值为类别描述,均须为字符串常量。MAP 不得为空,标签不得重复。 |
DETAILS | BOOLEAN | 否 | FALSE | 是否返回完整答案。须为布尔字面量。 |
CONFIG | MAP<STRING, STRING> | 否 | 无 | 调用级配置,键和值须为字符串常量。配置方式请参见通用调用。 |
FAIL_ON_ERROR | BOOLEAN | 否 | TRUE | 预测最终失败时是否使作业报错。须为布尔字面量。 |
类别描述用于解释标签的业务含义。例如,标签可设置为“物流”,描述设置为“配送、揽收和取件问题”。
输出
返回 STRING,表示模型选择的类别标签。
设置 DETAILS => TRUE 后返回 VARIANT,可包含类别选择结果、置信度及各候选类别的概率等信息。具体结构及字段含义请参见百炼决策模型 API“返回参数”中的 answers 部分。
设置 FAIL_ON_ERROR => FALSE 后的返回结构,请参见错误处理。
STATE 为 NULL 时返回 NULL。
示例
测试语句
CREATE TEMPORARY MODEL jev_model
INPUT (state STRING)
OUTPUT (answer VARIANT)
WITH (
'provider' = 'dashscope',
'task' = 'decision',
'model' = 'decision-model-preview'
);
CREATE TEMPORARY VIEW tickets(id, content) AS VALUES
(1, '商品无法开机,申请退货。'),
(2, '退款已经到账了,现在的问题是退件一直没人来取。');
SELECT
id,
AI_CHOICE(
MODEL => MODEL jev_model,
STATE => content,
QUESTION => '应由哪个团队处理用户当前尚未解决的问题?',
CRITERIA => MAP[
'售后', '退换货和商品质量问题',
'物流', '配送、揽收和取件问题',
'其他', '其他客服诉求'
]
) AS category
FROM tickets;
输出结果
以下仅为输出格式示例,实际分类以模型返回为准。
id | category |
1 | 售后 |
2 | 物流 |
获取详细结果
以下示例使用前文创建的模型和视图,通过 DETAILS => TRUE 获取完整答案。
CREATE TEMPORARY VIEW category_results AS
SELECT
id,
AI_CHOICE(
MODEL => MODEL jev_model,
STATE => content,
QUESTION => '应由哪个团队处理用户当前尚未解决的问题?',
CRITERIA => MAP[
'售后', '退换货和商品质量问题',
'物流', '配送、揽收和取件问题',
'其他', '其他客服诉求'
],
DETAILS => TRUE
) AS decision_result
FROM tickets;
SELECT
id,
decision_result
FROM category_results;