菜单
Use when integrating Gravity Forms with OpenAI via Gravity Connect: configuring OpenAI Fields (real-time pre-submission AI) or OpenAI Feeds (async post-submission processing), setting token ceilings, routing through OpenRouter, using GPT Image generation, voice-to-text transcription, or building AI-powered form workflows.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | wp-gravity-connect |
| description | Use when integrating Gravity Forms with OpenAI via Gravity Connect: configuring OpenAI Fields (real-time pre-submission AI) or OpenAI Feeds (async post-submission processing), setting token ceilings, routing through OpenRouter, using GPT Image generation, voice-to-text transcription, or building AI-powered form workflows. |
| license | GPL-2.0-or-later |
| optional | true |
Gravity Connect (OpenAI Connection) integrates Gravity Forms directly with OpenAI for AI text generation, image creation, voice transcription, and automated entry processing. Part of the Gravity Wiz ecosystem, installed via Spellbook.
| Resource | URL |
|---|---|
| Gravity Connect docs | https://gravitywiz.com/documentation/gravity-connect/ |
| OpenAI Connection docs | https://gravitywiz.com/documentation/gravity-connect-openai/ |
| Fields reference | https://gravitywiz.com/documentation/gravity-connect-openai/#fields |
| Feeds reference | https://gravitywiz.com/documentation/gravity-connect-openai/#feeds |
| GPT Image guide | https://gravitywiz.com/how-to-generate-ai-images-in-gravity-forms/ |
| AI text generation | https://gravitywiz.com/generate-text-gravity-forms-openai/ |
| AI moderation | https://gravitywiz.com/gravity-forms-moderation-gc-openai/ |
| Social media automation | https://gravitywiz.com/spotlight-social-media-gravity-forms-openai/ |
| Installation (via Spellbook) | https://gravitywiz.com/documentation/spellbook/ |
| Account dashboard | https://account.gravitywiz.com/ |
| Support | https://gravitywiz.com/support/ |
| OpenAI Fields | OpenAI Feeds | |
|---|---|---|
| Trigger | Before submission (real-time) | After submission (async) |
| User waits? | Yes — keep prompts fast | No — background processing |
| Use for | Live translation, grammar check, real-time summary, image preview | Email drafts, DB tagging, routing, moderation, classification |
| Token budget | Small (user is waiting) | Larger acceptable |
Rule: Default to Feeds unless the use case requires real-time display before the user submits.
Gravity Connect is not a standalone plugin — it installs through Spellbook (the Gravity Wiz platform):
# After downloading Spellbook zip
wp plugin install spellbook.zip --activate
# Then install OpenAI Connection from the Spellbook UI in wp-admin
wp-config.php constant, not the settings UI:// wp-config.php
define('OPENAI_API_KEY', getenv('OPENAI_API_KEY'));
{field_label:1}, {all_fields}gpt-4o-mini for cost efficiency)Every feed and field must have Maximum Tokens set to prevent runaway costs.
| Task | Recommended max tokens |
|---|---|
| Categorization / routing | 50–100 |
| Email subject line | 50–75 |
| Email body draft | 200–400 |
| Summary | 150–250 |
| Grammar / rewrite | 100–200 |
| Moderation decision | 50–100 |
| Image prompt → image | 256 (tokens don't apply to image size) |
Route through OpenRouter to use cheaper open-source models:
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)
Use cheaper models for tagging/categorization feeds; expensive models only when quality matters.
Field type: OpenAI → Image. Add to form for pre-submission image preview or post-submission image storage.
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
Set alerts in your OpenAI project dashboard for unexpected spend spikes.
wp-gravity-forms skill — forms and entries setupwp-gravity-wiz skill — Spellbook installationBootstrap a new or existing WordPress project with the full wp-agent-kit system: monorepo detection, Composer/WPackagist/SatisPress setup, Playground local dev, WP Engine dev/staging/production, CI gate, git hooks, and plugin packaging. Use when setting up a new WordPress project from scratch, onboarding an existing codebase, or wiring up a monorepo with multiple plugins/themes.
Use when working with Gravity Forms: installing or updating core and add-ons via wp gf CLI, managing forms and entries programmatically, exporting/importing form JSON for version control, testing notifications, configuring Cloudflare Turnstile anti-spam, or turning forms into MCP-compatible schemas for AI consumption. Also use for the GFAPI PHP class and hook/filter development.
Use when working with Gravity SMTP: installing, configuring, or troubleshooting WordPress transactional email delivery via SendGrid, Mailgun, Postmark, Brevo, SES, or custom SMTP. Critical: always verify version ≥ 2.1.5 to protect against CVE-2026-4020 which leaks API keys via unauthenticated REST endpoint.
Use for Gravity stack setup and orchestration: SatisPress/Composer configuration for the full plugin suite (Gravity Forms, SMTP, Connect, GravityView, Spellbook, Pods), reading the .cursorrules and llms.txt templates, or understanding how all products fit together. For product-specific work, load the individual skill instead.
Use when working with Gravity Wiz products: installing or managing Spellbook (the Gravity Wiz platform), Gravity Perks (48+ form enhancement plugins like GP Populate Anything, Nested Forms, Limit Submissions), or any individual perk. Also use for Gravity Shop (WooCommerce integration).
Use when working with GravityView or GravityKit products: creating Views to display Gravity Forms entries on the front-end, configuring search/sort/filter, entry approval workflows, edit-entry forms, role-based access, merge tags, shortcodes, or the GravityActions/GravityBoard extensions.