业务评分

更新时间:
复制 MD 格式

本文介绍如何使用 AI_SCORE,通过决策模型按照自定义的有序等级对输入内容评分。

使用限制

模型注册、执行要求和错误处理,请参见决策函数使用概述。

语法

AI_SCORE(
    MODEL => MODEL <model_name>,
    STATE => <state>,
    QUESTION => <question>,
    CRITERIA => <criteria>
    [, DETAILS => <details>]
    [, CONFIG => <config>]
    [, FAIL_ON_ERROR => <fail_on_error>]
)

入参

参数

数据类型

是否必填

默认值

说明

MODEL

MODEL

是

无

已注册的决策模型,输出列须为 VARIANT。

STATE

STRING 或 VARIANT

是

无

待评分的内容。

QUESTION

STRING

是

无

描述评分目标的非 NULL 字符串常量。

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;

相关文档