AIライティングツールの作り方：プロンプト、キー、費用と制限

AIライティングツールを作るには、まず1つの具体的な執筆作業を選びます。商品説明、カバーレター、会議の要約などです。それをフォームに変換します。利用者が入力する項目、テストしたプロンプトのテンプレート、そして利用者が変更して保存できるエディターに表示される出力です。文章そのものは、APIで自分のキーを使い、ブラウザではなくサーバーから呼び出す言語モデルが生成します。ツールに価値があるかどうかを決めるのは、モデルよりも、その作業をどれだけ深く理解しているかです。

なぜ「1つの作業」が重要なのか

汎用のチャットアシスタントは、すでに何でも書けます。そのため「文章作成を手伝う」新しいツールは、正面から競合することになります。狭い作業に特化したツールが勝つのは、次の理由からです。

• 適切な入力を求める。 物件掲載文の作成ツールは、寝室の数、所在地、目玉の特徴を尋ねるので、利用者が覚えておく必要がありません。
• プロンプトを隠す。 指示の調整には何時間もかけますが、その成果は利用者がワンクリックで受け取れます。
• 一貫した形式を出力する。 毎回同じ構成、長さ、口調になり、出力がウェブサイトやCRMにそのまま使われる場合には重要です。
• ワークフローに組み込まれる。 保存された下書き、顧客ごとのテンプレート、正しい形式で貼り付けられるコピーボタン。

最初の作業として適しているのは、反復的で、良い版と悪い版の違いが明確で、あなたが接点を持てるグループが行うものです。不動産仲介業者、採用担当者、店舗経営者、報告書のコメントを書く教師などが該当します。

AIライティングツールの構成要素

構築前に決めること

モデルプロバイダー

OpenAI、Anthropic、Googleなどのプロバイダーから、自分のAPIキーを持ち込みます。作業にとっての文章の品質、速度、料金に基づいて選び、決める前に、同じ実際の入力で2、3社を比べてください。あとで切り替えられるよう、プロバイダーはコード内の1つの関数の背後にまとめておきます。トークン、キー、料金体系については LLM APIの使い方 で説明しています。プロバイダー別の設定は OpenAI APIの連携 と Claude APIの連携 を参照してください。

費用の管理

生成のたびにお金がかかり、無料プランは悪用されることがあります。プロバイダーのダッシュボードで月間の利用上限を設定し、アプリ内で利用者ごとの1日の生成回数に上限を設け、入力と出力の長さを制限し、簡単な作業には安価なモデルを選んでください。実際の利用量を自社のプロバイダー請求で測定するまでは、利用者に1回の生成あたりの費用を提示しないでください。

無料、有料、クレジット

少量の無料枠があると、試してもらいやすくなります。その後は、余裕のある上限付きの月額プランが分かりやすい選択です。生成によって負荷が大きく異なるツールには、クレジット制が向いています。SaaS製品の価格設定の方法 を参照してください。

保存するもの

利用者は、顧客情報、未発表の製品計画、学生の情報など、機密性の高い資料を貼り付けることがあります。何を保存するか、どれくらいの期間保存するか、保持される可能性のある形でプロバイダーに送られるかどうかを決めてください。プロバイダーのデータポリシーを読み、プライバシーポリシーに平易にまとめてください。

プロンプトのテンプレートは依頼書のように書く

プロンプトが出力の品質の大部分を決めます。フリーランスのライターへの依頼書のように扱ってください。

1. 役割と作業: 「あなたは英国の住宅の物件掲載文を書きます。」
2. ルール: 長さ、構成、避けること（「存在しない設備を書かない」「『素晴らしい』のような大げさな言葉を使わない」）。
3. 利用者の入力。 はっきりとラベルを付けて示す。
4. 例。 良い出力の例があれば示す。
5. 形式: 見出し、箇条書き、プレーンテキスト、Markdownなど。

実際の入力を10〜20件集めてテストセットを作り、プロンプトを変えるたびに出力を確認してください。言葉をわずかに変えただけで1つのケースが直り、他の3つが壊れることがあります。

AIビルダーへの最初のプロンプト

ListingWriterという、不動産仲介業者向けに物件掲載文を書くウェブアプリを作ってください。ログイン後、利用者は保存された掲載文を見られ、「新規掲載」フォームで次の項目を入力します：物件の種類、寝室数、浴室数、面積、主な特徴（1行に1つ）、周辺の施設、口調（丁寧、温かい、簡潔から選択）、長さ（短いまたは長い）。送信すると、サーバーがこれらの項目からプロンプトを組み立て、秘密の環境変数AI_API_KEYを使ってAIプロバイダーを呼び出します。テキストをページのエディターにストリーミング表示してください。利用者は編集、保存、コピー、再生成ができるようにしてください。掲載文はデータベースに保存し、各利用者は自分の掲載文だけが見えるようにしてください。サーバー側で利用者1人あたり1日30回に制限し、残り回数を表示してください。APIキーをブラウザに送らないでください。シンプルで清潔なデザインにしてください。

ビルダーがキーを必要とする場合は、チャットの本文やコードに貼り付けるのではなく、プロジェクト設定でシークレットとして追加してください。

段階的な構築手順

1. 基本の流れを動かす。 フォーム、サーバーの呼び出し、ストリーミング出力、エディター。実際の入力でテストする。
2. テストセットに合わせてプロンプトを調整する。 出力のほとんどが軽い編集だけで済むようになるまで行う。
3. 保存された下書き用のデータベースを追加し、 次にアカウントを追加する。URLのIDを変えて、他人の下書きが見えないことを確認する。
4. 制限を追加する。 利用者ごとの1日の上限、入力の最大長、上限に達したときの分かりやすいメッセージ。
5. 失敗を処理する。 プロバイダーは時々タイムアウトしたりエラーを返したりします。分かりやすいメッセージを表示し、失敗した生成は利用者の枠に数えないでください。
6. 課金する場合は追加する。 まずテストモードで構築してください。アプリに決済を追加する方法 を参照してください。
7. セキュリティの確認。 キーがブラウザのコードに含まれていないこと、生成のエンドポイントがログインしていない利用者を拒否することを確認する。
8. この作業をしている5人に見せ、使ってもらう。 使いながら観察する。

よくある失敗

• 汎用の「AIライター」を作る。 説明しにくく、人々がすでに使っているチャットアシスタントに勝つのも難しい。
• ブラウザからモデルを呼び出す。 誰でもキーをコピーして、あなたのお金を使えてしまう。
• 利用上限がない。 1本のスクリプトで、一晩のうちに高額な請求が発生することがある。
• 出力を事実として提示する。 モデルは詳細をでっち上げることがあります。利用者には事実を確認するよう伝え、入力にない情報を加えることを禁じるプロンプトを書いてください。
• 「AI検出を回避できる」「盗用のない文章」を約束する。 どちらも保証できず、悪用を招きます。
• テストセットなしでプロンプトを変更する。 その後、利用者の半数で品質が落ちていたことに気づく。

既製の製品がより良い選択になる場合

メール、ブログの下書き、言い換えなど、作業が一般的なものであれば、AIアシスタントや、オフィスソフトやメールソフトに標準で組み込まれた文章作成機能で足りることが多く、自作するより安上がりです。確立されたAIコピーライティングツールは、チーム機能付きで一般的なマーケティング形式もカバーしています。自作が意味を持つのは、作業が特定の業界や業務フローに固有の場合、すべての出力に自社のデータや社内のスタイルを反映させる必要がある場合、または、よく知っているグループに特化したツールとして売りたい場合です。

Mythexで作る

MythexはAIアプリビルダーです。ツールを説明すると、フォーム、サーバー側の呼び出し、エディター、保存された下書きをライブプレビューで作成し、公開URLに公開します。ツール内のAIは自分のプロバイダーキーを使います。キーはプロジェクトのシークレットとして保存され（必要なときにMythexがチャットにシークレットのカードを表示します）、利用料はMythexのビルドクレジットではなく、プロバイダーのアカウントに請求されます。Mythexは、アプリの利用者向けのトークンや、組み込みのレート制限を含みません。制限は依頼してテストしてください。

下書きの保存を依頼すると、MythexがプロジェクトにPostgresデータベースを追加します。利用者のログインには、あなたが選ぶ認証の仕組みを使います。有料プランは、自分のStripeアカウントを使います。自分のAPIキーでAIを追加する方法 と アプリ内のAI のドキュメントには開始プロンプトがあります。既存の製品に追加できる小さなAI機能については、アプリにAI機能を追加する方法 を参照してください。

よくある質問