Airtable Connect 是一个面向 Airtable 工作区完整集成的元技能,旨在让用户通过自然语言与任意 Airtable 基座进行交互,无需手动调用 API、记忆 base ID 或查询表结构。
用途 用户只需说出像“查询我的 Projects 基座”或“向 CRM 添加一条记录”这样的指令,技能即可自动匹配并完成操作。它覆盖从首次配置到日常增删改查的完整流程。
主要能力 技能提供多个标准工作流:
- 工作流 0:配置检查。每个工作流都必须先运行检查脚本,通过 JSON 输出的 ai_action 字段判断后续动作(proceed_with_operation、proceed_with_warning、prompt_for_api_key、run_setup_wizard)。
- 工作流 1:发现基座。查找用户 Airtable 工作区中所有可访问基座并缓存表结构,将结果写入 01-memory/integrations/airtable-bases.yaml。
- 工作流 2:查询记录。按名称(支持模糊匹配)查询任意基座/表的记录,可使用 --filter、--sort、--limit 等参数。
- 工作流 3:创建记录。按目标表结构验证字段,提示用户填写必填项,然后创建记录并返回记录 ID。
- 工作流 4:更新记录。可通过记录 ID 或搜索定位记录,显示当前字段值后接受修改。
- 工作流 5:删除记录。定位记录后需用户确认,再执行删除。
- 工作流 6:批量操作。创建、更新或删除多条记录,每批最多 10 条。
使用方式 首次使用需要配置:运行配置检查脚本检查设置状态,若缺少 API Key,则引导用户创建 Personal Access Token(PAT)(链接 https://airtable.com/create/tokens,所需权限范围:data.records:read、data.records:write、schema.bases:read),并将 token 写入 .env,然后重新验证配置。也可以运行交互式安装向导脚本。 典型命令包括: python 00-system/skills/airtable/airtable-master/scripts/check_airtable_config.py --json python 00-system/skills/airtable/airtable-master/scripts/discover_bases.py python 00-system/skills/airtable/airtable-master/scripts/query_records.py --base <base_id> --table <table_name> [--filter "..."] [--sort ...] [--limit N] python 00-system/skills/airtable/airtable-master/scripts/manage_records.py create --base <base_id> --table <table_name> --fields '{"Name": "...", "Status": "..."}' python 00-system/skills/airtable/airtable-master/scripts/manage_records.py update --base <base_id> --table <table_name> --record <record_id> --fields '{"Status": "Done"}' python 00-system/skills/airtable/airtable-master/scripts/manage_records.py delete --base <base_id> --table <table_name> --record <record_id> python 00-system/skills/airtable/airtable-master/scripts/manage_records.py batch-create --base <base_id> --table <table_name> --records '[{"fields": {...}}, {"fields": {...}}]'
基座名称支持精确匹配、大小写不敏感、部分匹配和词匹配;若匹配到多个基座,会提示用户消歧。
适用场景 适合需要在对话环境中快速查询、创建、更新、删除或批量处理 Airtable 记录的用户,尤其是希望以自然语言替代直接 API 调用的工作流。
限制 所有工作流必须首先执行配置检查。批量操作受 Airtable 限制,每批最多 10 条。遇到权限错误需验证 PAT 权限范围;遇到 429 需等待并重试。基座或表若不在上下文中,需先运行发现工作流。技能依赖 airtable-master 共享库的脚本与参考文档。