wp-gravity-connect

Gravity Connect — OpenAI Integration

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
フィードのリファレンス	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

• 旧オープンソースの参考資料：https://github.com/gravitywiz/gravityforms-openai

---

FieldsとFeeds — 適切な連携方法を選ぶ

	OpenAI Fields	OpenAI Feeds
トリガー	送信前（リアルタイム）	送信後（非同期）
ユーザーの待機	はい — プロンプトは短時間で処理できるようにしてください	いいえ — バックグラウンド処理
用途	ライブ翻訳、文法チェック、リアルタイム要約、画像プレビュー	メールの下書き、DBのタグ付け、ルーティング、モデレーション、分類
トークン予算	少なめ（ユーザーが待機するため）	多めでも問題ありません

ルール：ユーザーが送信する前にリアルタイムで表示する必要がある場合を除き、デフォルトでは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. 重要：設定UIではなく、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のマージタグ（{field_label:1}、{all_fields}）を使用してPromptを記述します
4. Maximum Tokensを設定します — 必ず設定してください

4) OpenAI Feedsを設定する（送信後）

1. フォーム → Settings → OpenAI
2. Add New Feedを選択します
3. モデルを選択します（例：コスト効率に優れたgpt-4o-mini）
4. マージタグを使用してプロンプトを記述します
5. Maximum Tokensを設定します（必須 — 以下のトークン上限を参照）
6. AIの応答をフィールドに割り当てるか、通知のマージタグで送信します

5) トークン上限 — 必ず設定してください

暴走するコストを防ぐため、すべてのフィードとフィールドで Maximum Tokens を設定する必要があります。

タスク	推奨最大トークン数
カテゴリ分類／ルーティング	50–100
メールの件名	50–75
メール本文の下書き	200–400
要約	150–250
文法チェック／書き換え	100–200
モデレーションの判断	50–100
画像プロンプト → 画像	256（トークンは画像サイズには適用されません）

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)

タグ付け／カテゴリ分類のフィードには低コストのモデルを使用し、品質が重要な場合にのみ高コストのモデルを使用します。

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 プロジェクトのダッシュボードでアラートを設定します。

参考資料

• wp-gravity-forms スキル — フォームとエントリーのセットアップ
• wp-gravity-wiz スキル — Spellbook のインストール
• OpenAI Platform：https://platform.openai.com/
• OpenRouter：https://openrouter.ai/