综合决策

更新时间:
复制 MD 格式

本文介绍如何使用 AI_DECIDE,通过决策模型对同一输入提出一个或多个问题,并返回各问题的主要答案或详细结果。

使用限制

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

语法

AI_DECIDE(
    MODEL => MODEL <model_name>,
    STATE => <state>,
    QUESTION => <questions_json>
    [, DETAILS => <details>]
    [, CONFIG => <config>]
    [, FAIL_ON_ERROR => <fail_on_error>]
)

入参

参数

数据类型

是否必填

默认值

说明

MODEL

MODEL

是

无

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

STATE

STRING 或 VARIANT

是

无

待判断的内容。

QUESTION

STRING

是

无

非空 JSON 对象的字符串常量,以问题 ID 为键。支持 noul、choice、score 三类问题。

DETAILS

BOOLEAN

否

FALSE

是否返回完整答案。须为布尔字面量。

CONFIG

MAP<STRING, STRING>

否

无

调用级配置,键和值须为字符串常量。配置方式请参见通用调用。

FAIL_ON_ERROR

BOOLEAN

否

TRUE

预测最终失败时是否使作业报错。须为布尔字面量。

问题的定义格式请参见问题定义及百炼决策模型 API“请求参数”中的 questions 部分。

输出

主要答案和完整答案的返回类型如下。

问题数量

DETAILS

返回类型

一个

FALSE

对应问题的主要答案。noul、score 为 DOUBLE,choice 为 STRING。

多个

FALSE

ROW。字段名称及顺序对应问题 ID,字段类型对应问题类型。

一个或多个

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_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。

相关文档