本文介绍如何使用 AI_SCORE,通过决策模型按照自定义的有序等级对输入内容评分。
使用限制
仅实时计算引擎 VVR 11.10.preview1 及以上版本支持。
使用前需开通 Flink AI服务(内置模型)。
模型注册、执行要求和错误处理,请参见决策函数使用概述。
语法
AI_SCORE(
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 | ARRAY<STRING> | 是 | 无 | 按等级从低到高排列的描述数组,每项对应一个等级,且须为字符串常量。 |
DETAILS | BOOLEAN | 否 | FALSE | 是否返回完整答案。须为布尔字面量。 |
CONFIG | MAP<STRING, STRING> | 否 | 无 | 调用级配置,键和值须为字符串常量。配置方式请参见通用调用。 |
FAIL_ON_ERROR | BOOLEAN | 否 | TRUE | 预测最终失败时是否使作业报错。须为布尔字面量。 |
评分等级的数量限制请参见百炼决策模型 API“请求参数”中的 questions 部分。
输出
返回 DOUBLE。包含 N 个等级时,等级索引从 0 到 N−1,评分范围为 0~N−1。
评分可以为小数。例如:
ARRAY['不影响使用', '部分功能受影响', '无法继续使用']
对应的等级索引为 0、1、2,评分范围为 0~2。
设置 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 feedback(id, content) AS VALUES
(1, '主要功能都能正常使用,偶尔有一点卡顿。'),
(2, '部分功能无法使用,但仍可继续工作。'),
(3, '一直无法登录,已经不能继续使用。');
SELECT
id,
AI_SCORE(
MODEL => MODEL jev_model,
STATE => content,
QUESTION => '问题对用户使用的影响有多大?',
CRITERIA => ARRAY[
'不影响使用',
'部分功能受影响',
'无法继续使用'
]
) AS impact
FROM feedback;
输出结果
以下仅为输出格式示例,实际评分以模型返回为准。
id | impact |
1 | 0.20 |
2 | 1.10 |
3 | 1.98 |
获取详细结果
以下示例使用前文创建的模型和视图,通过 DETAILS => TRUE 获取完整答案。
CREATE TEMPORARY VIEW impact_results AS
SELECT
id,
AI_SCORE(
MODEL => MODEL jev_model,
STATE => content,
QUESTION => '问题对用户使用的影响有多大?',
CRITERIA => ARRAY[
'不影响使用',
'部分功能受影响',
'无法继续使用'
],
DETAILS => TRUE
) AS decision_result
FROM feedback;
SELECT
id,
decision_result
FROM impact_results;