Agent Skills
返回列表
Fillout 表单连接器

Fillout 表单连接器

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_15292d5a/yjkj-oo-fillout。

技能介绍

要解决什么问题

如果你在 Agent 里要查 Fillout 表单、拉提交记录或按 schema 创建 submission，直接拼 Fillout API 往往还要自己管 API Key、记端点与分页参数。本技能走 OOMOL 已连接的 Fillout 账号：通过 oo CLI 调用 fillout connector，凭据在服务端注入，Agent 侧不必接触原始 token。

技能如何工作

每个动作对应 connector 里的一条 action。动手前先 oo connector schema 看清当前 input/output 契约，再按 schema 构造 --data（JSON 字符串或 @file.json，省略则 {}）。响应形如 { "data": ..., "meta": { "executionId": "..." } }，便于追踪执行。

暴露的 6 个动作大致分工如下：

  • 只读：list_forms、get_form_metadata、list_submissions、get_submission — 列表单、读元数据与题目配置、按表单列/查单条提交
  • 写操作：create_submissions — 为表单创建一条或多条 submission
  • 破坏性：delete_submission — 按 submission ID 删除

文档假定用户已安装 oo、已登录且已连接 Fillout；不要在每次调用前主动跑登录或打开连接页，仅在命令因鉴权/连接失败时再走一次性配置。

边界与注意点

  • 读类 action 可直接执行；创建/更新类会改 Fillout 状态，执行前应与用户确认 payload 与预期效果。
  • 删除不可逆，必须明确目标 ID 并取得明确同意。
  • 各 action 的参考说明在技能附带的 reference 文件中；构造 --data 前以 live schema 为准，避免字段漂移。
  • 计费或额度问题（如 HTTP 402）需在 OOMOL 控制台处理后再重试，与 Fillout API 本身无关。

使用场景

  • Agent 接到「列出账号下所有 Fillout 表单」后，用 `list_forms` 拿到表单 ID 再让用户选定目标表单。
  • 营销同事要核对某活动表单的题目与字段名，先 `get_form_metadata` 再对照下游 CRM 映射规则。
  • 需要把某表单最近一页提交导出做汇总时，用 `list_submissions` 按文档分页与筛选条件拉取记录。
  • 误填或重复提交需清理时，先 `get_submission` 核对内容，经确认后再 `delete_submission` 按 ID 删除。

适合人员

  • 在 OOMOL 里用 Agent 读写 Fillout 线索表、不想在对话里粘贴 API Key 的营销运营。
  • 要把 Fillout 提交字段对齐内部工单或数据库、需先读 schema 再构造 payload 的集成工程师。
  • 用 `oo` connector 编排「列表单 → 查元数据 → 拉提交」自动化脚本的平台或 DevOps 同学。
  • 需要在测试环境按表单契约批量造 submission、再核对 `create_submissions` 返回数据的 QA 或后端开发。