aitable-workflow-cli 0.1.13-beta.1

package/templates/support-qa/profiles/aitable/wiki/faq-support/18-/345/274/200/345/217/221/350/200/205/346/214/207/345/215/227/AI/350/241/250/346/240/274/345/255/227/346/256/265/346/250/241/347/211/210 /344/275/277/347/224/250/346/214/207/345/215/227/AI /350/241/250/346/240/274 AI /345/255/227/346/256/265/345/270/270/350/247/201/346/212/245/351/224/231/350/257/264/346/230/216.md"

@@ -0,0 +1,649 @@
+# AI 表格 AI 字段常见报错说明
+
+## 功能概述
+
+AI 字段是 AI 表格中用于快速批量处理数据的功能模块，支持 AI 提取、AI 分类、AI 翻译、AI 生图等多种能力。在 AI 字段执行过程中，可能因为配置、服务、权限等原因出现错误。本文档汇总了常见的错误信息及对应的解决方案，帮助你快速定位和解决问题。
+
+---
+
+## 错误说明
+
+### 用户需求火爆，AI 调用繁忙，请稍后再试。若需操作，可尝试选中单元格后点击更新
+
+*   **原因说明**：当前使用 AI 的用户较多，AI 模型请求量过大，导致服务繁忙、限流或超时。也可能是字段模板配置异常导致无法正常调用 AI 服务。
+    
+*   **解决方案**：
+    
+    1.  等待 1-2 分钟后重试
+        
+    2.  如果需要立即操作，可以选中单个单元格后点击"更新"按钮，逐条生成
+        
+    3.  避免同时对大量记录执行字段模板
+        
+    4.  如果持续出现，请检查字段模板配置是否完整，或联系开发者排查
+        
+
+---
+
+### AI字段配置异常，请检查后重试
+
+*   **原因说明**：字段模板的任务参数非法或配置数据损坏，服务端无法正常执行该任务。
+    
+*   **解决方案**：
+    
+    1.  编辑字段模板，检查配置项是否填写完整
+        
+    2.  确认引用的字段和参数设置正确
+        
+    3.  如果问题持续，尝试删除该字段模板后重新创建
+        
+
+---
+
+### 指令引用字段已被删除或为非法字段，请修改配置后重试
+
+*   **原因说明**：字段模板依赖的引用字段已被删除、修改或不存在，导致无法正常执行。
+    
+*   **解决方案**：
+    
+    1.  编辑字段模板配置，重新选择一个有效的引用字段
+        
+    2.  如果引用字段被误删，可通过操作历史恢复
+        
+
+---
+
+### 所选字段形成循环引用，数据处理异常，请检查
+
+*   **原因说明**：多个字段模板之间形成了循环依赖关系（如字段 A 引用字段 B，字段 B 又引用字段 A），导致无法正常计算。
+    
+*   **解决方案**：
+    
+    1.  检查字段模板之间的引用关系
+        
+    2.  调整引用链路，确保不存在环形依赖
+        
+    3.  如果不确定哪些字段形成了循环，可以逐个检查字段模板的引用配置
+        
+
+---
+
+### AI 服务繁忙，请稍后再试
+
+*   **原因说明**：字段模板插件在执行过程中出现异常，或 AI 模型调用超时。
+    
+*   **解决方案**：
+    
+    1.  稍等片刻后重试
+        
+    2.  检查字段模板配置是否正确
+        
+    3.  如果持续出现，请联系开发者排查
+        
+
+---
+
+### 当前 AI 表格归属其他组织，AI 功能仅限该组织成员使用。请联系文档所有者操作或申请加入后重试。
+
+*   **原因说明**：你当前所在的组织与 AI 表格所属的组织不同，AI 功能不支持跨组织调用。
+    
+*   **解决方案**：
+    
+    1.  确认你在正确的组织环境下操作
+        
+    2.  联系文档所有者帮你执行操作
+        
+    3.  申请加入该组织后重试
+        
+
+---
+
+### 由于可能涉及敏感内容或临时限制，AI暂时无法回答此问题，建议你尝试其他提问。
+
+*   **原因说明**：输入或输出内容触发了平台的内容安全审核机制，被判定为可能涉及敏感内容。
+    
+*   **解决方案**：
+    
+    1.  检查输入数据中是否包含敏感信息
+        
+    2.  修改提示词（Prompt），避免引导生成不当内容
+        
+    3.  尝试换一种表述方式重新提问
+        
+    4.  如果认为是误判，请联系开发者反馈
+        
+
+---
+
+### 附件解析失败，请稍后重试
+
+*   **原因说明**：附件在格式转换过程中出现异常，可能是附件格式不标准或文件损坏。
+    
+*   **解决方案**：
+    
+    1.  检查附件格式是否正确
+        
+    2.  尝试重新上传附件
+        
+    3.  如果是从其他平台导入的附件，尝试先下载到本地再重新上传
+        
+
+---
+
+### 引用的字段中没有找到合适的附件，AI无法为你生成内容。目前支持钉钉文档和本地文件（文件类型：.pdf .docx .png .jpeg .jpg .webp）
+
+*   **原因说明**：字段模板引用的字段中不包含支持的附件类型，或附件字段为空。
+    
+*   **解决方案**：
+    
+    1.  确认引用的附件字段中有文件
+        
+    2.  检查附件格式是否在支持范围内（.pdf .docx .png .jpeg .jpg .webp）
+        
+    3.  如果附件格式不支持，请转换为支持的格式后重新上传
+        
+
+---
+
+### 附件文件超出大小限制：图片不超过10 MB，视频和音频不超过1 GB，PDF 不超过 50 MB
+
+*   **原因说明**：附件文件大小超出了字段模板的处理上限。
+    
+*   **解决方案**：
+    
+    1.  压缩或裁剪附件文件
+        
+    2.  图片确保不超过 10 MB
+        
+    3.  视频和音频确保不超过 1 GB
+        
+    4.  PDF 确保不超过 50 MB
+        
+
+---
+
+### 引用字段不能为空，请填写后重试
+
+*   **原因说明**：字段模板配置中引用了某个字段，但该字段的值为空。
+    
+*   **解决方案**：
+    
+
+方案一：在引用的字段中填写内容后重试
+
+方案二：打开字段配置面板，设置允许引用字段为空
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/8oLl95257zd7Mlap/img/d271080a-a510-4f80-9470-559205a524c2.png)
+
+---
+
+### 你没有权限访问该文件，请检查权限后再试
+
+*   **原因说明**：字段模板引用的附件或文档，当前用户没有查看/下载权限。
+    
+*   **解决方案**：
+    
+    1.  确认你对引用的文件有查看或下载权限
+        
+    2.  联系文件所有者授予权限后重试
+        
+
+---
+
+### AI字段使用超限，请明日再试。建议通过关闭自动更新以减少不必要的AI算力消耗。
+
+*   **原因说明**：当日字段模板执行次数已达到每日上限。
+    
+*   **解决方案**：
+    
+    1.  等待次日额度自动刷新后再执行
+        
+    2.  关闭不必要的自动更新，减少 AI 算力消耗
+        
+    3.  合理规划执行频率，避免不必要的重复执行
+        
+
+---
+
+### 当前AI字段正在运行中
+
+*   **原因说明**：同一字段已有正在执行的任务，不能重复提交。
+    
+*   **解决方案**：
+    
+    1.  等待当前任务执行完成后再发起新任务
+        
+    2.  如果任务长时间未完成，可以尝试取消后重新执行
+        
+
+---
+
+### AI字段运行超时，请稍后重试
+
+*   **原因说明**：字段模板的子任务执行时间超过了系统限制。
+    
+*   **解决方案**：
+    
+    1.  减少单次执行的数据量，分批执行
+        
+    2.  稍后重试
+        
+    3.  如果持续超时，请联系开发者排查
+        
+
+---
+
+### 数据写入失败，请稍后重试
+
+*   **原因说明**：字段模板执行结果在写入表格时失败，可能是网络问题或权限问题。
+    
+*   **解决方案**：
+    
+    1.  检查表格是否有写入权限
+        
+    2.  稍后重试
+        
+    3.  如果持续失败，请联系开发者排查
+        
+
+---
+
+### 系统错误，请联系技术支持
+
+*   **原因说明**：FaaS 插件执行过程中出现未知系统异常。
+    
+*   **解决方案**：
+    
+    1.  稍后重试
+        
+    2.  如果持续出现，请联系插件开发者或技术支持
+        
+
+---
+
+### 字段模板运行超时，请联系插件开发者
+
+*   **原因说明**：FaaS 插件执行时间超过了系统限制。
+    
+*   **解决方案**：
+    
+    1.  减少单次处理的数据量
+        
+    2.  联系插件开发者优化性能
+        
+
+---
+
+### 字段模板运行错误，请联系插件开发者
+
+*   **原因说明**：FaaS 插件运行时出现异常。
+    
+*   **解决方案**：
+    
+    1.  联系插件开发者排查问题
+        
+    2.  检查字段模板配置是否正确
+        
+
+---
+
+### 请求的服务超出限制，请稍后重试
+
+*   **原因说明**：FaaS 插件请求频率超过了限制。
+    
+*   **解决方案**：
+    
+    1.  降低执行频率，分批执行
+        
+    2.  稍后重试
+        
+
+---
+
+### 账号用量已耗尽，请检查配置并重试
+
+*   **原因说明**：FaaS 插件的调用额度已耗尽。
+    
+*   **解决方案**：
+    
+    1.  联系插件开发者确认额度情况
+        
+    2.  检查是否有其他可用的账号配置
+        
+
+---
+
+### 字段模板配置错误，请联系插件开发者
+
+*   **原因说明**：FaaS 插件配置参数有误。
+    
+*   **解决方案**：
+    
+    1.  检查字段模板配置，确认参数填写正确
+        
+    2.  联系插件开发者获取正确的配置方式
+        
+
+---
+
+### 授权错误，请检查是否正确关联账号
+
+*   **原因说明**：FaaS 插件的授权信息无效或已过期。
+    
+*   **解决方案**：
+    
+    1.  重新关联账号授权
+        
+    2.  检查授权是否已过期，如已过期请重新授权
+        
+
+---
+
+### 当前算粒资源不足，请开通后继续使用
+
+*   **原因说明**：当前用户或组织的 AI 算粒额度不足，无法继续执行字段模板。
+    
+*   **解决方案**：
+    
+    1.  前往算粒管理页面查看剩余额度
+        
+    2.  联系组织管理员充值或调整额度分配
+        
+    3.  等待额度按周期自动刷新
+        
+
+---
+
+### 暂不支持当前模型
+
+*   **原因说明**：字段模板配置的 AI 模型不被当前系统支持。
+    
+*   **解决方案**：
+    
+    1.  编辑字段模板，更换为支持的模型
+        
+    2.  联系管理员确认当前可用的模型列表
+        
+
+---
+
+### 输入内容长度超出上限，请缩短自定义提示/要求内容或者引用内容
+
+*   **原因说明**：输入的提示词（Prompt）或引用的内容长度超过了模型的最大限制。
+    
+*   **解决方案**：
+    
+    1.  精简自定义提示词内容
+        
+    2.  减少引用字段中的文本长度
+        
+    3.  如果引用了多个字段，尝试减少引用字段数量
+        
+
+---
+
+### 参考图需满足：格式为 PNG，且分辨率不超过 1280×1280 像素
+
+*   **原因说明**：图片编辑场景中，参考图的格式或分辨率不符合要求。
+    
+*   **解决方案**：
+    
+    1.  将参考图转换为 PNG 格式
+        
+    2.  确保图片分辨率不超过 1280×1280 像素
+        
+    3.  使用图片编辑工具调整后重新上传
+        
+
+---
+
+### 图片分辨率过大或过小，请调整后重试
+
+*   **原因说明**：图片分辨率不在支持的范围内。
+    
+*   **解决方案**：
+    
+    1.  调整图片分辨率到合适的范围
+        
+    2.  重新上传调整后的图片
+        
+
+---
+
+### 图片尺寸必须在384到5000像素之间
+
+*   **原因说明**：图片的宽或高尺寸不在 384 到 5000 像素的范围内。
+    
+*   **解决方案**：
+    
+    1.  使用图片编辑工具调整图片尺寸
+        
+    2.  确保宽和高都在 384 到 5000 像素之间
+        
+
+---
+
+### 文字超过限制，请缩短文本内容
+
+*   **原因说明**：输入的文本内容长度超过了音频生成的处理上限。
+    
+*   **解决方案**：
+    
+    1.  缩短输入的文本内容
+        
+    2.  将长文本拆分为多段分别生成
+        
+
+---
+
+### 视频分辨率和时长不匹配，请调整后重试
+
+*   **原因说明**：视频文件的分辨率和时长组合超出了处理能力。
+    
+*   **解决方案**：
+    
+    1.  降低视频分辨率或缩短视频时长
+        
+    2.  压缩视频文件后重试
+        
+
+---
+
+### 文档不存在或没有权限，请检查后重试
+
+*   **原因说明**：引用的文档不存在或当前用户没有访问权限。
+    
+*   **解决方案**：
+    
+    1.  确认引用的文档仍然存在
+        
+    2.  确认你对该文档有查看权限
+        
+    3.  联系文档所有者授予权限
+        
+
+---
+
+### 文件类型不支持
+
+*   **原因说明**：当前字段模板不支持该文件类型。
+    
+*   **解决方案**：
+    
+    1.  查看字段模板支持的文件类型列表
+        
+    2.  将文件转换为支持的格式后重新上传
+        
+
+---
+
+### 文件大小超出限制
+
+*   **原因说明**：文件大小超过了字段模板的处理上限。
+    
+*   **解决方案**：
+    
+    1.  压缩文件或拆分为更小的文件
+        
+    2.  确保文件大小在限制范围内
+        
+
+---
+
+### 文件页数超出限制
+
+*   **原因说明**：文件页数超过了字段模板的处理上限。
+    
+*   **解决方案**：
+    
+    1.  减少文件页数后重试
+        
+    2.  将文件拆分为多个较小的文件分别处理
+        
+
+---
+
+### 文件内容为空
+
+*   **原因说明**：引用的文件内容为空，无法进行处理。
+    
+*   **解决方案**：
+    
+    1.  确认文件内容不为空
+        
+    2.  重新上传包含内容的文件
+        
+
+---
+
+### 音频文件解码失败，请检查文件格式
+
+*   **原因说明**：音频文件无法正常解码，可能是文件格式不标准或文件损坏。
+    
+*   **解决方案**：
+    
+    1.  检查音频文件格式是否正确
+        
+    2.  尝试使用音频编辑工具重新编码后上传
+        
+    3.  更换为其他格式的音频文件
+        
+
+---
+
+### 音频文件采样率不符合要求
+
+*   **原因说明**：音频文件的采样率不在支持的范围内。
+    
+*   **解决方案**：
+    
+    1.  使用音频编辑工具转换采样率
+        
+    2.  重新上传符合要求的音频文件
+        
+
+---
+
+### 音频文件过长，请缩短音频时长
+
+*   **原因说明**：音频文件时长超过了处理上限。
+    
+*   **解决方案**：
+    
+    1.  裁剪音频文件，确保时长在限制范围内
+        
+    2.  将长音频拆分为多段分别处理
+        
+
+---
+
+### 音频有效时长过短
+
+*   **原因说明**：音频文件的有效时长过短，无法进行处理。
+    
+*   **解决方案**：
+    
+    1.  使用更长的音频文件
+        
+    2.  确保音频中包含足够的有效内容
+        
+
+---
+
+### 文件加密或损坏，请检查后重试
+
+*   **原因说明**：文件被加密保护或文件已损坏，无法正常读取。
+    
+*   **解决方案**：
+    
+    1.  解除文件的加密保护
+        
+    2.  重新获取未损坏的文件
+        
+    3.  尝试用其他工具打开文件确认是否可正常读取
+        
+
+---
+
+### 视频时长超出限制，请缩短视频后重试
+
+*   **原因说明**：视频文件时长超过了字段模板的最大处理限制。
+    
+*   **解决方案**：
+    
+    1.  裁剪视频，确保时长在限制范围内
+        
+    2.  将长视频拆分为多段分别处理
+        
+
+---
+
+### 因运单号无效或缺失查询信息，暂时无法查询相关物流信息，暂不支持国际物流，如运单号存在，可以去菜鸟裹裹平台查询是否存在物流信息
+
+*   **原因说明**：物流字段受限于底层物流查询服务，所以可能会出现不支持或者查不到的情况
+    
+*   **解决方案**：
+    
+
+1. 顺丰要手机号 2. 海外快递不支持 3. 查询可能有延迟 4. 极兔基本不能支持 5. 韵达查询经常失败，可以闲时再试 6. 非淘天的包裹都有可能失败 7. 能不能查到可以去菜鸟裹裹平台确认一下
+
+## 常见问题
+
+### 问：错误面板上的"联系开发者"按钮是做什么的？
+
+答：点击"联系开发者"按钮会打开插件开发者提供的咨询群链接。如果你遇到的问题无法通过上述方案解决，可以通过该入口联系插件开发者获取帮助。
+
+### 问：错误面板上的"复制错误信息"按钮是做什么的？
+
+答：点击"复制错误信息"按钮会将完整的错误信息（包含错误标题、描述、Sheet ID、Record ID 等调试信息）复制到剪贴板。你可以将这些信息提供给开发者，帮助他们更快地定位问题。
+
+### 问：为什么同一个字段模板，有些记录成功了，有些记录失败了？
+
+答：字段模板是逐条记录执行的，每条记录的输入数据不同，可能导致部分记录触发特定的错误条件。常见原因包括：
+
+1.  部分记录的引用字段为空
+    
+2.  部分记录的附件格式不支持或大小超限
+    
+3.  部分记录的内容触发了安全审核建议检查失败记录的输入数据，针对性地修复后重试。
+    
+
+### 问: 为什么我的 AI 字段不能自动更新
+
+1.  AI 字段没有开启自动更新，目前需要创建时手动开启的
+    
+    ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/ybEnB5jkEVrZzlP1/img/301da0ef-9f20-49bb-b695-b00c51338daa.png)
+    
+2.  今天运行次数过多，导致使用超限了
+    
+3.  AI 字段引用公式/查找引用/关联引用字段，公式看起来计算完了，但 AI 字段没更新
+    
+    很有可能公式在服务端还未计算完，所以不会触发 AI 字段更新 ，可以通过打开AI表格加速来验证，开启加速后前端展示结果与服务端一致
+    
+    ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/ybEnB5jkEVrZzlP1/img/064ac00d-f5cd-4512-bd83-3043bd5fb80a.png)
+    
+4.  自动化触发的变更，暂不支持 AI 字段自动更新
+    
+    如需要可联系  $\color{#0089FF}{@张悦(玥又)}$ 开启灰度，但灰度开启后，AI 字段变更无法触发自动化
+    
+5.  【表单提交、自动化新增行等】场景，由于计算列过多、计算过于慢，导致无法触发 AI 字段，同上 4 开启表格加速，或者 $\color{#0089FF}{@甘停(象龙)}$ 申请灰度开关

package/templates/support-qa/profiles/aitable/wiki/faq-support/18-/345/274/200/345/217/221/350/200/205/346/214/207/345/215/227/AI/350/241/250/346/240/274/345/255/227/346/256/265/346/250/241/347/211/210 /344/275/277/347/224/250/346/214/207/345/215/227/Dify/346/231/272/350/203/275/344/275/223.md"

@@ -0,0 +1,55 @@
+# Dify智能体
+
+> ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/eLbnj1boXeEdNlaN/img/7609bf00-ac2b-4814-b177-701fb1936d81.png)
+
+## 快速使用入口：
+
+添加或修改表头的字段类型，选择“探索字段模板”，搜索“dify”即可添加此类型字段。
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/eLbnj1boXeEdNlaN/img/f18643f0-f1f9-4005-ad1b-b2a9d5d60210.png)
+
+## 配置教程：
+
+### 添加表头后，首先须关联账号（即Dify的APP key）。
+
+##### 钉钉端：
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/eLbnj1boXeEdNlaN/img/c7b04763-d957-4889-a9ac-4be11ff84fad.png)      ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/eLbnj1boXeEdNlaN/img/95f14d68-7cec-4d4d-9e79-9e280b772da6.png)
+
+##### Dify端：
+
+每個智能体的编辑页左上角，点击配置按钮，打开“API密钥”。
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/eLbnj1boXeEdNlaN/img/675909dd-96ea-4827-a292-b6c6c03e5fa2.png)
+
+#### 复制密钥
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/1X3lE5jJZ0KoXlJb/img/5bc9d8c3-2238-4234-8178-fa7a643a8204.png)
+
+### 完成表头配置。
+
+##### 配置项定义：
+
+:::
+**模式选择****\***：根据Dify智能体类型来选择（Chatflow对话流，Workflow工作流）
+
+**问题/提示（对话流必填）**：即提示词，支持表格字段引用
+
+**附件字段（可选）**：当需要输入图片时使用。前置条件：表格中有附件类型字段 + Dify智能体开启files功能。
+
+**Dify API地址****\***：默认仅支持 Dify 官方Saas版的API地址。自架设Dify须群内@管理员 增加白名单。
+
+**输入参数配置（可选）**：当使用工作流或对话流，开始节点有自定义字段时使用。Json格式，根据Dify智能体的字段配置。（如：{"question":"\[字段1\]"} ）图例：![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/eLbnj1boXeEdNlaN/img/318b0952-3b24-4bf9-97ed-d84fdccdb95f.png)
+
+**工作流结果变量（工作流必填）**：按照Dify智能体输出值设定。图例：![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/eLbnj1boXeEdNlaN/img/3d8235d9-67e0-4154-90f8-dd22e1a78e40.png)
+
+**会话ID（可选）**：仅在对话流中且需要对话记忆时需要。
+:::
+
+##### 对话流模式参考案例：
+
+##### 工作流模式参考案例：
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/1X3lE5jJZ0KoXlJb/img/b95080b2-1f2b-407b-87e1-be49df46f126.png)
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/1X3lE5jJZ0KoXlJb/img/cb8201c0-2b3c-4f46-9594-9e7453cd192f.png)