AI 对话

函数名：AI / AI

功能描述

AI 对话功能，根据用户提供的提示词进行智能分析和处理。支持数据分析、文本分类、内容生成等多种任务类型，返回 AI 生成的处理结果。

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

语法

=AI(提示词)

参数

参数名	类型	必填	默认值	说明
提示词	String	是	—	提示词，描述需要 AI 完成的任务

返回值

String — 返回 AI 生成的处理结果文本。

使用示例

示例一：数据分析

分析销售数据趋势。

公式：

=AI("分析以下销售数据，找出销售趋势：1月1000，2月1200，3月900，4月1500，5月1800")

结果：

销售趋势分析：1-3月呈波动状态，4-5月呈现明显上升趋势，整体增长50%。

示例二：文本分类

对客户反馈进行分类汇总。

公式：

=AI("将以下客户反馈按正面和负面分类汇总：客户A说产品质量很好；客户B说物流太慢；客户C说价格偏高；客户D说服务态度好")

结果：

正面反馈：产品质量很好、服务态度好
负面反馈：物流太慢、价格偏高

示例三：内容生成

让 AI 根据提示生成一段文案。

公式：

=AI("为一款智能手表写一段50字以内的产品宣传语")

结果：

智能佩戴，健康随行。精准监测心率睡眠，贴心管理日常运动，让科技融入生活每一刻。

技术说明

接口信息

• API 路径：/api/ai-llm/chat
• 请求方式：POST（application/json）
• 超时时间：120 秒（2 分钟）
• 执行模式：异步执行（ExcelAsyncUtil.Run）
• 系统提示词：固定为 "AI_Gen"

请求参数

请求体包含以下字段：prompt（提示词）、machine_code（机器码）、activation_data（激活码）、version（会员等级标识）、system_prompt（系统提示词，固定为 "AI_Gen"）。

响应解析

解析 JSON 响应中的 response 字段并返回。

函数名说明

Excel 中注册的函数名为 AI（C# 方法名为 AI_Task），在单元格中直接使用 =AI(...) 调用。

错误处理

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