[]
        
立即试用
(Showing Draft Content)

AI.TEXTSENTIMENT

用户可以使用AI.TEXTSENTIMENT函数分析单元格中文本的情感倾向,返回“积极”“消极”或“中性”的结果。

语法

AI.TEXTSENTIMENT(array, positive, negative, [neutral])

参数

该函数包含以下参数:

参数

描述

array

[必需] 要传递给函数的数据数组,例如区域引用。

positive

[必需] 当情感分析结果为积极时返回的值。

negative

[必需] 当情感分析结果为消极时返回的值。

neutral

[可选] 当情感分析结果为中性时返回的值。

示例

以下示例展示如何调用OpenAI GPT - 4.1模型,并使用AI.TEXTSENTIMENT函数进行单句和批量文本的情感分析。

// 要使用此示例,请将以下依赖项添加到项目中:com.openai:openai-java:4.6.1
// 配置模型请求处理程序,并根据需要选择不同的大模型提供商。此处示例使用OpenAI GPT - 4.1;使用时请替换为您的API密钥。
Workbook.setAIModelRequestHandler(new OpenAIModelRequestHandler("https://api.openai.com/v1", "sk-xxxx", "gpt-4.1"));
// DeepSeek模型。
// Workbook.setAIModelRequestHandler(new OpenAIModelRequestHandler("https://api.deepseek.com/v1", "sk-xxxx", "deepseek-chat"));
// 通义千问模型。
// Workbook.setAIModelRequestHandler(new OpenAIModelRequestHandler("https://dashscope.aliyuncs.com/compatible-mode/v1", "sk-xxxx", "qwen-plus"));

// 初始化工作簿并设置数据。
Workbook workbook = new Workbook();
IWorksheet sheet = workbook.getWorksheets().get(0);
sheet.getColumns().get(0).setColumnWidth(55);
sheet.getColumns().get(1).setColumnWidth(55);
sheet.getRange("A1:B1").合并();
sheet.getRange("A1").setValue("示例:客户产品评价");
sheet.getRange("A1").getFont().setBold(true);
sheet.getRange("A1").getFont().setSize(16);
sheet.getRange("A1").getFont().setColor(Color.GetWhite());
sheet.getRange("A1").getInterior().setColor(Color.FromArgb(90, 126, 158));
sheet.getRange("A1").setHorizontalAlignment(HorizontalAlignment.Center);
sheet.getRange("A1").setVerticalAlignment(VerticalAlignment.Center);
sheet.getRange("A1").setRowHeight(35);
sheet.getRange("A3").setValue("公式:");
sheet.getRange("A3").getFont().setBold(true);
sheet.getRange("A3").getFont().setSize(11);
sheet.getRange("A3").getInterior().setColor(Color.FromArgb(217, 225, 242));
sheet.getRange("B3").setValue("=AI.TEXTSENTIMENT(A6:A13,\"积极\",\"消极\",\"中性\")");
sheet.getRange("B3").getFont().setItalic(true);
sheet.getRange("B3").getFont().setColor(Color.FromArgb(68, 114, 196));
sheet.getRange("B3").set自动换行(true);
sheet.getRange("A5:B5").setValue(new Object[][] {
        { "评价文本", "AI情感倾向" }
});
sheet.getRange("A5:B5").getFont().setBold(true);
sheet.getRange("A5:B5").getInterior().setColor(Color.FromArgb(155, 194, 230));
sheet.getRange("A5:B5").setHorizontalAlignment(HorizontalAlignment.Center);
sheet.getRange("A6:A13").setValue(new Object[][] {
        { "我绝对喜欢这个产品!它超出了我所有的期望!" },
        { "这是我做过最糟糕的一次购物。完全是浪费钱。" },
        { "产品还可以,没什么特别的,但能完成工作。" },
        { "质量卓越,客户服务一流!" },
        { "对质量很失望。不值这个价。" },
        { "一般般。能用,但可以更好。" },
        { "太棒了!有史以来最好的产品!强烈推荐给大家!" },
        { "糟糕的体验。不会推荐给任何人。" }
});
for (int i = 6; i <= 13; i++) {
    if ((i - 6) % 2 == 0) {
        sheet.getRange("A" + i).getInterior().setColor(Color.FromArgb(242, 242, 242));
    }
    sheet.getRange("A" + i).getBorders().setLineStyle(BorderLineStyle.Thin);
    sheet.getRange("A" + i).getBorders().setColor(Color.FromArgb(200, 200, 200));
    sheet.getRange("A" + i).set自动换行(true);
}

// 定义AI情感分析公式,将A6:A13区域的内容分类为“积极”“消极”或“中性”。
sheet.getRange("B6").setFormula2("=AI.TEXTSENTIMENT(A6:A13,\"积极\",\"消极\",\"中性\")");
for (int i = 6; i <= 13; i++) {
    sheet.getRange("B" + i).getFont().setBold(true);
    sheet.getRange("B" + i).getFont().setSize(11);
    sheet.getRange("B" + i).setHorizontalAlignment(HorizontalAlignment.Center);
    sheet.getRange("B" + i).getBorders().setLineStyle(BorderLineStyle.Medium);
    sheet.getRange("B" + i).getBorders().setColor(Color.FromArgb(200, 200, 200));
}

// 对情感分析结果应用条件格式。
IFormatCondition positiveCondition = (IFormatCondition) sheet.getRange("B6:B13").getFormatConditions().add(
        FormatConditionType.CellValue,
        FormatConditionOperator.Equal,
        "=\"积极\"",
        null);
positiveCondition.getInterior().setColor(Color.FromArgb(226, 239, 218));
positiveCondition.getFont().setColor(Color.FromArgb(0, 128, 0));
IFormatCondition negativeCondition = (IFormatCondition) sheet.getRange("B6:B13").getFormatConditions().add(
        FormatConditionType.CellValue,
        FormatConditionOperator.Equal,
        "=\"消极\"",
        null);
negativeCondition.getInterior().setColor(Color.FromArgb(255, 199, 206));
negativeCondition.getFont().setColor(Color.FromArgb(192, 0, 0));
IFormatCondition neutralCondition = (IFormatCondition) sheet.getRange("B6:B13").getFormatConditions().add(
        FormatConditionType.CellValue,
        FormatConditionOperator.Equal,
        "=\"中性\"",
        null);
neutralCondition.getInterior().setColor(Color.FromArgb(255, 242, 204));
neutralCondition.getFont().setColor(Color.FromArgb(128, 100, 0));

// AI函数作为异步计算执行,因此您需要等待计算完成。
workbook.calculate();
workbook.waitForCalculationToFinish();

// 设置页面以适应单页。
sheet.getPageSetup().setFitToPagesTall(1);
sheet.getPageSetup().setFitToPagesWide(1);
sheet.getPageSetup().setIsPercentScale(false);

// 另存为PDF文件。
workbook.save("AITEXTSENTIMENT.pdf");
/**
 * 针对OpenAI API的IAIModelRequestHandler实现。
 */
public class OpenAIModelRequestHandler implements IAIModelRequestHandler {
    private String _apiEndpoint;
    private String _apiKey;
    private String _model;
    public OpenAIModelRequestHandler(String apiEndpoint, String apiKey, String model) {
        if (apiEndpoint == null || apiEndpoint.trim().isEmpty())
            throw new IllegalArgumentException("API端点不能为空。");
        if (apiKey == null || apiKey.trim().isEmpty())
            throw new IllegalArgumentException("API密钥不能为空。");
        _apiEndpoint = apiEndpoint.replaceAll("/$", "");
        _apiKey = apiKey;
        _model = model;
    }
    @Override
    public CompletableFuture<AIModelResponse> sendRequestAsync(AIModelRequest request) {
        CompletableFuture<AIModelResponse> result = new CompletableFuture<>();
        if (request == null) {
            AIModelResponse modelResponse = new AIModelResponse();
            modelResponse.setSuccess(false);
            System.err.println("请求不能为空。");
            result.complete(modelResponse);
            return result;
        }
        OpenAIClientAsync openAIClient = OpenAIOkHttpClientAsync.builder()
               .apiKey(_apiKey)
               .baseUrl(_apiEndpoint)
               .build();
        ChatCompletionCreateParams.Builder builder = ChatCompletionCreateParams.builder();
        for (AIMessage item : request.getMessages()) {
            switch (item.getRole().toLowerCase()) {
                case "system":
                    builder.addSystemMessage(item.getContent());
                    break;
                case "user":
                    builder.addUserMessage(item.getContent());
                    break;
                default:
                    throw new RuntimeException("未知的消息角色: " + item.getRole());
            }
        }
        builder.model(_model);
        ChatCompletionCreateParams params = builder.build();
        CompletableFuture<ChatCompletion> chatCompletion = openAIClient.chat().completions().create(params);
        chatCompletion.whenComplete((response, exception) -> {
            try {
                if (exception != null) {
                    AIModelResponse errorResponse = new AIModelResponse();
                    errorResponse.setSuccess(false);
                    System.err.println("发生错误: " + exception.getMessage());
                    result.complete(errorResponse);
                } else {
                    if (response != null &&!response.choices().isEmpty()) {
                        StringBuilder contentBuilder = new StringBuilder();
                        for (ChatCompletion.Choice choice : response.choices()) {
                            choice.message();
                            if (choice.message().content().isPresent()) {
                                contentBuilder.append(choice.message().content().get());
                            }
                        }
                        AIModelResponse successResponse = new AIModelResponse();
                        successResponse.setSuccess(true);
                        successResponse.setContent(contentBuilder.toString());
                        result.complete(successResponse);
                    } else {
                        AIModelResponse noContentResponse = new AIModelResponse();
                        noContentResponse.setSuccess(false);
                        System.err.println("未从模型收到内容。");
                        result.complete(noContentResponse);
                    }
                }
            } finally {
                try {
                    openAIClient.close();
                } catch (Exception e) {
                    System.err.println("关闭OpenAI客户端时出错: " + e.getMessage());
                }
            }
        });
        return result;
    }
}

输出如下所示:

image