Cover

SeaTable Skill

简介
SeaTable Skill 用于连接 AI Agent 与 SeaTable。安装并完成连接配置后，用户可以通过自然语言查询、筛选和分析 SeaTable Base 中的数据。
SeaTable Skill 不局限于某个特定产品，支持 Skill 机制的 Agent 均可使用。本文以 WorkBuddy 为例，介绍 SeaTable Skill 的安装、配置和使用方法。其他 Agent 的界面和操作入口可能有所不同，请以实际界面为准。
功能介绍
通过 SeaTable Skill，AI Agent 可以根据用户的自然语言指令访问指定的 SeaTable Base。
主要使用场景包括：
  • 查看 Base 中的表格
  • 读取指定表格中的记录
  • 根据字段条件筛选数据
  • 查询指定日期范围内的数据
  • 对数据进行分类、统计和汇总
  • 根据表格数据生成分析结果
例如，可以在 WorkBuddy 中输入： 
            
                
                

                        使用 SeaTable Skill 列出当前 Base 中的所有表格。
或者： 
            
                
                

                        使用 SeaTable Skill，根据“创建时间”字段，获取“任务管理”表中本周的数据。
使用前准备
使用 SeaTable Skill 前，需要准备以下内容：
  1. 支持 Skill 机制的 Agent
  2. SeaTable 服务器地址
  3. 目标 Base 的 API Token
  4. 可以访问 SeaTable 服务器的网络环境
本文后续操作均以 WorkBuddy 为例。
服务器地址示例：
准备需要连接的 SeaTable 服务器地址，例如： 
            
                
                

                        https://cloud.seatable.cn
如果使用私有部署版 SeaTable，请填写对应的服务器地址。
Base API Token
  • Token 属于需要访问的 Base
  • Token 当前有效
  • Token 具有完成任务所需的权限
如果只需要查询和分析数据，建议使用只读权限的 Token，以降低数据被误修改的风险。
安装 SeaTable Skill
执行安装命令
在 WorkBuddy 中打开支持 Skill 安装的操作入口，输入以下命令： 
            
                
                

                        npx skills add seatable/skills@seatable
该命令用于下载并安装 SeaTable Skill
安装过程中，请等待命令执行完成，不要关闭当前页面或中断安装。
确认安装结果
安装完成后， WorkBuddy 会显示对应的执行结果。如果结果中提示 SeaTable Skill 已成功安装，即可继续配置连接信息。
如果安装失败，可以优先检查：
  • 当前环境是否可以访问网络
  • 是否可以正常执行   npx   命令
  • 安装命令是否完整
  • Skill 地址是否输入正确
  • 当前 WorkBuddy 环境是否支持 Skill
配置 SeaTable 连接
安装完成后，需要配置以下信息：
  • SeaTable 服务器地址
  • Base API Token
调用 SeaTable Skill
在 WorkBuddy 中输入一个需要访问 SeaTable 的任务，例如： 
            
                
                

                        使用 SeaTable Skill 列出当前 Base 中的所有表格。
WorkBuddy 识别到该任务后，会调用 SeaTable Skill。
填写连接信息
首次调用时，请根据提示填写 SeaTable 连接信息。
服务器地址示例： 
            
                
                

                        https://cloud.seatable.cn
Base API Token： 
            
                
                

                        目标 Base 对应的 API Token
配置完成后，SeaTable Skill 将使用这些信息连接目标 Base。
验证连接
输入以下指令： 
            
                
                

                        使用 SeaTable Skill 列出当前 Base 中的所有表格。
如果 WorkBuddy 能够返回 Base 中的表格名称，说明以下配置均已生效：
  • SeaTable Skill 已正确安装
  • SeaTable 服务器地址正确
  • Base API Token 有效
  • Token 具有数据读取权限
  • 当前网络可以访问 SeaTable 服务器
如果无法获取表格，请检查：
  • 服务器地址是否正确
  • 服务器地址是否包含   http://   或   https://
  • Base API Token 是否完整
  • Token 是否属于目标 Base
  • Token 是否已失效
  • Token 是否具有数据读取权限
  • 当前网络是否能够访问 SeaTable 服务器
使用 SeaTable Skill 示例
配置完成后，可以在 WorkBuddy 中通过自然语言查询和分析 SeaTable 数据。
为了让 ChatGPT 更准确地执行任务，建议在指令中明确以下信息：
  • 使用 SeaTable Skill
  • 目标表格名称
  • 查询或筛选字段
  • 筛选条件
  • 日期范围
  • 排序方式
  • 需要返回的字段
  • 期望的输出格式
读取指定表格中的记录
读取指定表格的前 10 条记录： 
            
                
                

                        使用 SeaTable Skill 读取“库存表”中的前 10 条记录。
只返回指定字段： 
            
                
                

                        使用 SeaTable Skill 读取“库存表”中的前 10 条记录，
                

            
                

                        只返回货品名称、类别、当前库存和状态。
按照指定字段排序： 
            
                
                

                        使用 SeaTable Skill 读取“库存表”中的记录，
                

            
                

                        按照当前库存数量从大到小排序，返回前 10 条。
按条件筛选数据
筛选指定库存类别的任务： 
            
                
                

                        使用 SeaTable Skill 读取“库存表”中
                

            
                

                        类别为“电器类”的记录。
同时使用多个筛选条件： 
            
                
                

                        使用 SeaTable Skill 读取“库存表”中
                

            
                

                        类别为“五金类”且状态为“可用”的记录。
适用范围
适用范围说明
SeaTable Skill 适用于支持 Skill 机制的 Agent。
本文仅使用 WorkBuddy 展示安装、配置和使用流程。其他支持 Skill 机制的 Agent 也可以安装和使用 SeaTable Skill，但具体安装入口、配置位置和结果展示方式可能有所不同。