情感分析

函数名：AI_情感分析 / AI_Sentiment

功能描述

对输入的文本进行情感分析，返回正面、负面或中性的情感评分。调用后台 AI 接口进行自然语言处理，支持直接文本输入或单元格引用。

会员等级：🟢 免费版（Free）

语法

=AI_情感分析(txt, return_raw)

参数

参数名	类型	必填	默认值	说明
txt	String	是	—	用户输入的待分析文本
return_raw	Boolean	否	FALSE	是否返回原始 JSON 数据（FALSE 返回解析后的情感类别，TRUE 返回完整 JSON）

返回值

String — 默认返回情感类别（如"正面"、"负面"、"中性"）；当 return_raw 为 TRUE 时，返回包含 sentiment、score、details 等字段的原始 JSON 字符串。

使用示例

示例一：基本情感判断

判断一句话的情感倾向。

公式：

=AI_情感分析("我很喜欢这部电影")

结果：

正面

示例二：负面情感识别

根据用户评论判断其情感极性。

公式：

=AI_情感分析("服务态度不好，体验很差")

结果：

负面

示例三：返回原始 JSON 数据

获取完整的情感分析结果，包含评分和详情。

公式：

=AI_情感分析("今天天气不错，心情很好", TRUE)

结果：

{"sentiment":"正面","score":0.95,"details":"文本表达积极情绪"}

技术说明

接口信息

• API 路径：/api/ai-llm/sentiment
• 请求方式：POST（application/json）
• 超时时间：120 秒
• 执行模式：异步执行（ExcelAsyncUtil.Run）

请求参数

请求体包含以下字段：text（文本内容）、machine_code（机器码）、activation_data（激活码）、version（会员等级标识）。

响应解析

• return_raw = FALSE：解析 JSON 中的 sentiment 字段，返回情感类别
• return_raw = TRUE：直接返回原始 JSON 响应字符串

错误处理

错误场景	返回值
API 返回错误（含 detail 或 message 字段）	错误：{错误详情}
API 请求失败（非 200 状态码）	错误：API请求失败 ({状态码})
请求过程中发生异常	异常：{异常信息}
异步任务尚未完成	Waiting...