类别选择

更新时间:
复制 MD 格式

本文介绍如何使用 AI_CHOICE,通过决策模型从给定的候选类别中选择一个类别。

使用限制

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

语法

AI_CHOICE(
    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

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;

相关文档