mcpField
W
wp-gravity-connect

wp-gravity-connect

github.com/kylebrodeur开发149 次安装1 周前更新
代码仓库

关于 wp-gravity-connect

wp-gravity-connect 介绍将 Gravity Forms 与 OpenAI 集成，用于表单填写期间及提交后的 AI 任务。内容涵盖文本、图像和音频流程，以及令牌限制和 OpenRouter 路由。

主要功能

  1. 01表单中的实时 AI 字段
  2. 02提交后的异步处理 Feed
  3. 03文本、图像和音频任务
  4. 04通过 OpenRouter 路由模型
  5. 05令牌与 API 成本控制

适用场景

  1. 01起草或分类已提交的条目
  2. 02审核表单提交内容
  3. 03根据表单数据生成图像
  4. 04转录表单中的语音输入

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/kylebrodeur/wordpress-agent-kit --skill wp-gravity-connect

安装后在 Claude Code 中输入/wp-gravity-connect确认已加载。

详细介绍

Gravity Connect — OpenAI 集成

Gravity Connect（OpenAI Connection）将 Gravity Forms 直接与 OpenAI 集成，可用于 AI 文本生成、图像创建、语音转录和自动处理条目。它是 Gravity Wiz 生态系统的一部分，通过 Spellbook 安装。

适用场景

  • 在表单中设置 AI 文本生成（提交前）
  • 配置提交后的 AI 处理（起草电子邮件、分类、添加标签）
  • 构建 AI 驱动的表单审核
  • 根据表单数据使用 GPT Image 生成图像
  • 在表单中进行语音转文本转录
  • 通过 OpenRouter 路由提示词，以便快速切换模型
  • 设置令牌上限以控制 API 费用

官方文档

资源URL
Gravity Connect 文档https://gravitywiz.com/documentation/gravity-connect/
OpenAI Connection 文档https://gravitywiz.com/documentation/gravity-connect-openai/
字段参考https://gravitywiz.com/documentation/gravity-connect-openai/#fields
Feed 参考https://gravitywiz.com/documentation/gravity-connect-openai/#feeds
GPT Image 指南https://gravitywiz.com/how-to-generate-ai-images-in-gravity-forms/
AI 文本生成https://gravitywiz.com/generate-text-gravity-forms-openai/
AI 审核https://gravitywiz.com/gravity-forms-moderation-gc-openai/
社交媒体自动化https://gravitywiz.com/spotlight-social-media-gravity-forms-openai/
安装（通过 Spellbook）https://gravitywiz.com/documentation/spellbook/
账户控制面板https://account.gravitywiz.com/
支持https://gravitywiz.com/support/

GitHub

字段与 Feed — 选择合适的集成点

OpenAI FieldsOpenAI Feeds
触发时机提交前（实时）提交后（异步）
用户需要等待？是 — 提示词应尽量简短否 — 后台处理
适用场景实时翻译、语法检查、实时摘要、图像预览电子邮件草稿、数据库标签、路由、审核、分类
令牌预算少量（用户正在等待）可接受较多

规则：除非用例要求在用户提交前实时显示结果，否则默认使用 Feeds。

操作流程

1) 通过 Spellbook 安装

Gravity Connect 不是独立插件，而是通过 Spellbook（Gravity Wiz 平台）安装：

  1. 从账户控制面板安装并启用 Spellbook：https://gravitywiz.com/download/spellbook
  2. 在 wp-admin 中：Spellbook → Connect → OpenAI Connection → Install
  3. 或从账户中启用：https://account.gravitywiz.com/
# After downloading Spellbook zip
wp plugin install spellbook.zip --activate
# Then install OpenAI Connection from the Spellbook UI in wp-admin
2) 连接 OpenAI 账户
  1. 创建 API 密钥：https://platform.openai.com/api-keys
  2. 在 wp-admin 中：OpenAI Connection → Settings → Secret Key → 粘贴密钥
  3. 重要：将密钥存储在 wp-config.php 常量中，而不是设置界面中：
// wp-config.php
define('OPENAI_API_KEY', getenv('OPENAI_API_KEY'));
3) 配置 OpenAI Fields（实时）
  1. 表单编辑器 → Advanced Fields → OpenAI field
  2. 设置 Endpoint（Text、Image、Audio）
  3. 使用 Gravity Forms 合并标签编写 Prompt：{field_label:1}、{all_fields}
  4. 设置 Maximum Tokens — 必填
4) 配置 OpenAI Feeds（提交后）
  1. 表单 → Settings → OpenAI
  2. Add New Feed
  3. 选择模型（例如，选择 gpt-4o-mini 以节省费用）
  4. 使用合并标签编写提示词
  5. 设置 Maximum Tokens（必填 — 参见下方令牌上限）
  6. 将 AI 响应映射到某个字段，或通过通知合并标签发送
5）Token 上限——务必设置

每个 Feed 和字段都必须设置 Maximum Tokens，以防成本失控。

任务建议的最大 Token 数
分类 / 路由50–100
邮件主题行50–75
邮件正文草稿200–400
摘要150–250
语法检查 / 改写100–200
审核决策50–100
图像提示词 → 图像256（Token 数不影响图像大小）
6）OpenRouter——无需更改代码即可热切换模型

通过 OpenRouter 路由，以使用更便宜的开源模型：

OpenAI Connection → Settings → Custom Base URL:
  https://openrouter.ai/api/v1

Model examples:
  meta-llama/llama-3-8b-instruct  (cheap, fast)
  anthropic/claude-3-haiku         (quality, affordable)
  mistralai/mistral-7b-instruct    (open source)

对标记 / 分类 Feed 使用更便宜的模型；仅在质量至关重要时使用昂贵的模型。

7）GPT 图像生成

字段类型：OpenAI → Image。将其添加到表单中，以便在提交前预览图像，或在提交后存储图像。

Prompt: "Professional headshot of {Name:1}, corporate style, white background"
Size: 1024x1024
Store URL in: Image Field 5

安全与成本控制

// wp-config.php — credentials in constants, not wp_options
define('OPENAI_API_KEY', getenv('OPENAI_API_KEY'));

// Set spending limits in OpenAI Platform dashboard:
// https://platform.openai.com/account/limits

在 OpenAI 项目控制面板中设置警报，以便在支出意外激增时收到通知。

参考资料

评论

支持 Markdown