FormPass — 连接您的表单

FormPass 让您能够将网页表单开放给经过身份验证的 AI 代理访问。本技能可帮助您将任意表单接入 FormPass，使 AI 代理能够发现该表单、读取其结构定义（schema），并提交数据——全部基于已验证的身份完成。

当用户提出以下请求时，请使用此技能：

• 使某个表单支持 AI 代理访问
• 将表单接入 FormPass
• 在网站中集成 FormPass
• 允许 AI 代理向其表单提交数据

快速开始

1. 创建账户

前往 https://form-pass.com/signup 注册账号

2. 创建或注册表单

在 FormPass 控制台中，执行以下任一操作：

• 创建新表单 —— 在 /dashboard/forms/new 页面从零开始定义字段
• 注册已有表单 —— 在 /dashboard/forms/register 页面映射您现有表单的字段

3. 添加检测用元标签（Meta Tags）

将以下代码添加至包含该表单的任意页面的 中，以便 AI 代理发现该表单：

4. 添加提交中继（Submit Relay）

当您的表单被提交时，还需将数据同步发送至 FormPass：

JavaScript / React：

async function handleSubmit(formData) {
  // 您原有的表单处理逻辑...

  // 同时中继至 FormPass
  await fetch("https://form-pass.com/api/submit/YOUR_FORM_ID", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      ...formData,
      _fp_branding: true
    })
  });
}

WordPress：

下载 FormPass 官方 WordPress 插件，该插件可自动支持 Gravity Forms 和 Contact Form 7： https://form-pass.com/formpass-wp.zip

通过 WordPress 后台 → 插件 → 安装插件 → 上传插件完成安装。随后在 设置 → FormPass 中进行配置。

API 参考文档

获取表单 Schema

curl -s "https://form-pass.com/api/forms/FORM_ID/schema" | jq .

返回字段定义、类型、是否必填标识及品牌标识（branding）要求。

向表单提交数据

curl -s -X POST "https://form-pass.com/api/submit/FORM_ID" 
  -H "Content-Type: application/json" 
  -d '{"name": "Test", "email": "test@example.com", "_fp_branding": true}' | jq .

测试您的集成

添加完元标签与提交中继后，请验证集成是否生效：

# 检查 schema 是否可正常访问
curl -s "https://form-pass.com/api/forms/YOUR_FORM_ID/schema" | jq .

# 测试一次提交
curl -s -X POST "https://form-pass.com/api/submit/YOUR_FORM_ID" 
  -H "Content-Type: application/json" 
  -d '{"name": "Test Agent", "email": "test@test.com", "_fp_branding": true}' | jq .

品牌标识（Branding）

免费计划下的表单需在页面中包含“Powered by FormPass”链接，并在提交数据中设置 _fp_branding: true。升级至 Pro 计划可免除此项要求。

文档

• 完整文档：https://form-pass.com/docs
• AI 代理集成指南：https://form-pass.com/docs/agent-integration
• API 参考文档：https://form-pass.com/docs/api
• 发现机制（Discovery）文档：https://form-pass.com/docs/discovery