AI助手命令

观看本节视频

功能概述

AI 助手命令是活字格提供的自动化 AI 交互能力，允许开发者通过配置化的方式在应用运行时调用 LLM 服务。主要特性包括：

• 支持页面端和服务端调用

• 可嵌入业务逻辑的任意环节

• 提示词模版支持公式、变量、关键字等

• 支持 JSON 结构化数据提取

命令配置

基础设置

输入输出配置

1. 用户输入：

• 直接输入文本

• 引用单元格值（如=A1）

• 公式计算结果（如=Text(Today(),"yyyy-MM-dd")）

• 该输入在用户提示词中的关键字为[%AiUserInput%]

2. 保存结果至：指定结果保存至变量

   保存至：result (文本结果)

高级设置

错误处理：设置超时时间（默认 100s）

使用场景

基础应用

场景 1：智能翻译

• 用户提示词："将以下内容翻译成英语：[%AiUserInput%]"

• 输入源：A1单元格("你好")

• 输出：result变量("Hello")

场景 2：数据清洗

• 系统提示词："你是一个数据专家，请规范以下地址格式。输出格式：{ "省":"","市":"","详细地址":""}"

• 用户提示词："原始的地址：[=原始地址]"

• 返回结果类型：尝试提取JSON字符串

业务集成

场景 3：智能审批

• 申请提交触发AI命令

• 提示词："评估采购申请合理性，参数：

  • 金额：[=采购申请记录.Amount]

  • 供应商：[=采购申请记录.供应商]

  • 历史记录：[%AiDataSource=(采购历史表)%]"

• 返回建议保存至审批意见字段

场景 4：动态报表

用户通过自然语言描述报表需求，比如选择分析维度（时间/产品线）。

AI函数定义配置多个预置函数，命令中导出不同配置的报表

最佳实践

1. 提示词优化：

• 使用明确指令格式（"请按以下格式返回："）

• 提供示例样本（Few-shot learning）

2. 安全建议：

• 敏感字段脱敏处理

调试技巧

1. 日志查看：

• 可通过服务端测试或浏览器控制台查看命令调用日志

• 日志中详细记录有提示词模版的最终文本结果，以及函数调用过程

2. 测试模式：

• 可直接单独测试 AI 助手命令

3. 错误诊断：

   403：API密钥无效

   504：模型响应超时

   422：配置错误