本文介绍如何使用 AI_DECIDE,通过决策模型对同一输入提出一个或多个问题,并返回各问题的主要答案或详细结果。
使用限制
仅实时计算引擎 VVR 11.10.preview1 及以上版本支持。
使用前需开通 Flink AI服务(内置模型)。
模型注册、执行要求和错误处理,请参见决策函数使用概述。
语法
AI_DECIDE(
MODEL => MODEL <model_name>,
STATE => <state>,
QUESTION => <questions_json>
[, DETAILS => <details>]
[, CONFIG => <config>]
[, FAIL_ON_ERROR => <fail_on_error>]
)
入参
参数 | 数据类型 | 是否必填 | 默认值 | 说明 |
MODEL | MODEL | 是 | 无 | 已注册的决策模型,输出列须为 |
STATE | STRING 或 VARIANT | 是 | 无 | 待判断的内容。 |
QUESTION | STRING | 是 | 无 | 非空 JSON 对象的字符串常量,以问题 ID 为键。支持 |
DETAILS | BOOLEAN | 否 | FALSE | 是否返回完整答案。须为布尔字面量。 |
CONFIG | MAP<STRING, STRING> | 否 | 无 | 调用级配置,键和值须为字符串常量。配置方式请参见通用调用。 |
FAIL_ON_ERROR | BOOLEAN | 否 | TRUE | 预测最终失败时是否使作业报错。须为布尔字面量。 |
问题的定义格式请参见问题定义及百炼决策模型 API“请求参数”中的 questions 部分。
输出
主要答案和完整答案的返回类型如下。
问题数量 | DETAILS | 返回类型 |
一个 | FALSE | 对应问题的主要答案。 |
多个 | FALSE |
|
一个或多个 | TRUE |
|
完整答案可包含判定结果、置信度和概率分布等内容,具体结构及字段含义请参见百炼决策模型 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_DECIDE(
MODEL => MODEL jev_model,
STATE => content,
QUESTION => '{
"need_help": {
"type": "noul",
"instructions": "用户是否仍有需要客服处理的诉求?"
}
}'
) AS need_help
FROM tickets;
need_help 的类型为 DOUBLE。
示例二:回答多个问题
以下示例同时判断是否需要跟进、处理团队及影响程度。
CREATE TEMPORARY VIEW ticket_decisions AS
SELECT
id,
AI_DECIDE(
MODEL => MODEL jev_model,
STATE => content,
QUESTION => '{
"need_help": {
"type": "noul",
"instructions": "用户是否仍有需要客服处理的诉求?"
},
"category": {
"type": "choice",
"instructions": "应由哪个团队处理?",
"criteria": {
"售后": "退换货和商品质量问题",
"物流": "配送、揽收和取件问题",
"其他": "其他客服诉求"
}
},
"impact": {
"type": "score",
"instructions": "问题对用户使用的影响有多大?",
"criteria": [
"不影响使用",
"部分功能受影响",
"无法继续使用"
]
}
}'
) AS decision_result
FROM tickets;
SELECT
id,
decision_result.need_help AS need_help,
decision_result.category AS category,
decision_result.impact AS impact
FROM ticket_decisions;
decision_result 的类型为:
ROW<need_help DOUBLE, category STRING, impact DOUBLE>
以下仅为输出格式示例,实际结果以模型返回为准。
id | need_help | category | impact |
1 | 0.99 | 售后 | 1.98 |
2 | 0.98 | 物流 | 1.20 |
示例三:保留详细结果
以下示例使用前文创建的模型和 tickets 视图,通过 DETAILS => TRUE 保留完整答案。
CREATE TEMPORARY VIEW ticket_decision_details AS
SELECT
id,
AI_DECIDE(
MODEL => MODEL jev_model,
STATE => content,
QUESTION => '{
"need_help": {
"type": "noul",
"instructions": "用户是否仍有需要客服处理的诉求?"
},
"category": {
"type": "choice",
"instructions": "应由哪个团队处理?",
"criteria": {
"售后": "退换货和商品质量问题",
"物流": "配送、揽收和取件问题",
"其他": "其他客服诉求"
}
},
"impact": {
"type": "score",
"instructions": "问题对用户使用的影响有多大?",
"criteria": [
"不影响使用",
"部分功能受影响",
"无法继续使用"
]
}
}',
DETAILS => TRUE
) AS decision_result
FROM tickets;
SELECT
id,
decision_result
FROM ticket_decision_details;
decision_result 的类型为 VARIANT。