【ITニュース解説】PromptCraft: Mini AI Prompt Generator App Spring AI and Spring Boot

PromptCraftは、Java言語でアプリケーション開発を効率化する「Spring Boot（スプリングブート）」と、新しく登場したAI連携のための「Spring AI（スプリングエーアイ）」、そして最新の人工知能モデルを提供する「OpenAI（オープンエーアイ）」という三つの技術を組み合わせた、AIプロンプト生成アプリケーションである。このシステムは、AIへの指示文（プロンプト）を効率的に作成・管理し、AIの力をアプリケーションに簡単に組み込むことを目指している。

まず、Spring Bootとは、Javaアプリケーションを迅速に構築・実行するための非常に人気のあるフレームワークである。通常、Javaでアプリケーションを開発する際には、多くの初期設定やライブラリの準備が必要になるが、Spring Bootはこれらを最小限に抑え、すぐにコードを書き始められるように設計されている。これにより、開発者は煩雑な設定作業に時間を取られることなく、WebアプリケーションやAPI（異なるソフトウェアが情報をやり取りするための仕組み）、各種サービス開発に集中できるという大きな利点がある。

次に、Spring AIは、Spring Bootアプリケーションに人工知能の機能を手軽に統合するために開発された比較的新しいプロジェクトである。このライブラリを使うことで、開発者は複雑なAIモデルの内部構造を意識することなく、JavaのコードからAIの強力な機能を呼び出すことができるようになる。特に、ChatGPTなどの先進的なAIモデルで知られるOpenAIとの連携が非常にスムーズに行える点が、Spring AIの大きな特徴の一つだ。

そして、OpenAIは、人間のようにテキストを理解し、自然な文章を生成したり、質問に答えたり、さらにはプログラムコードを作成したりする能力を持つ、高性能なAIモデルを提供している企業である。 PromptCraftは、これらのSpring Boot、Spring AI、OpenAIを組み合わせることで、人間のように「考え」「応答する」ことができる、非常に強力なAIアプリケーションを少ない労力で構築することを可能にする。これにより、AIを搭載したチャットボットやコンテンツ生成ツール、あるいはクリエイティブな作業を支援するアシスタントなどを、効率的に開発できるのだ。

PromptCraftの開発は、いくつかの具体的なステップを経て進められる。 最初のステップは、新しいSpring Bootプロジェクトを作成することだ。これは、Springが提供する「Spring Initializr（スプリングイニシャライザ）」というWebサイトを通じて行う。ここでは、プロジェクトの形式（Maven）、使用言語（Java）、Spring Bootのバージョン、そしてWebアプリケーションを構築するための「Spring Web」という基本的な機能（依存関係）を選択し、プロジェクトのひな形をダウンロードする。このひな形には、アプリケーションの基本的な骨組みがすでに含まれているため、開発者はゼロからすべてを準備する必要がない。ダウンロードしたファイルを解凍し、IntelliJ IDEAやEclipseといった統合開発環境（IDE）で開けば、すぐに開発を始められる状態になる。

次に、Spring AIの機能を使用するために、プロジェクトに必要な部品（依存関係）を追加する。これは、プロジェクトの設定ファイルである「pom.xml」というファイルに、Spring AIとOpenAIを連携させるための特定の記述を追加することで行う。この記述によって、アプリケーションがSpring AIのライブラリを通じてOpenAIのAIモデルにアクセスできるようになる。

AIサービスを利用するには、OpenAIから「APIキー」と呼ばれる秘密の認証情報を取得する必要がある。これは、OpenAIの公式ウェブサイトにアクセスし、アカウントを登録またはログインした後、「API Keys」セクションで新しいキーを生成する手順を踏む。このAPIキーは、アプリケーションがOpenAIのサービスを利用する際の「身分証明書」のようなものであり、その管理には最大限の注意が必要だ。もしこのキーが第三者に漏洩すると、不正利用され、予期せぬ費用が発生する可能性もある。そのため、APIキーはプログラムコードに直接書き込まず、環境変数や安全な設定ファイルに保管し、決して公開しないようにすることが推奨される。

取得したAPIキーは、アプリケーションの設定ファイルである「application.yml」に記述する。ここでは、AIが使うモデルとして「gpt-4o-mini」を指定したり、AIの応答の創造性やランダム性を示す「temperature（温度）」の値を設定したりできる。この設定ファイルは、アプリケーションの動作に関する様々なパラメータを管理するために用いられる。

続いて、アプリケーションが外部からのリクエストを受け付け、AIに対する処理を指示するための「コントローラー」を作成する。PromptControllerという名前のこのクラスは、RESTful APIという形式で機能を提供する。具体的には、「/api/templates」というURLを通じて、保存されているテンプレートの一覧表示や、新しいテンプレートの追加・更新を処理する。また、「/api/generate」というURLでは、AIモデルを使ったテキスト生成リクエストを受け付ける役割を果たす。

アプリケーション内外でのデータのやり取りを明確にするために、「DTO（Data Transfer Object）」と呼ばれるデータ構造を定義する。PromptDefinitionはテンプレートの詳細（名前、説明、システム指示、ユーザーテンプレート）を、GenerateRequestはテキスト生成リクエストの内容（テンプレート名、変数、モデルなど）を、GenerateResponseはAIからの生成結果を、CreateOrUpdateTemplateRequestはテンプレートの作成や更新リクエストの情報をそれぞれ格納するためのシンプルなレコードとして定義される。これらにより、データの受け渡しが型安全かつ効率的に行われる。

AIプロンプトのテンプレートを保存し、管理するための「TemplateStore」クラスも作成される。これは、アプリケーションが起動している間だけテンプレートデータを保持する、簡易的なインメモリデータベースのような役割を果たす。このクラスには、あらかじめ「Twitterのフック生成」「要約」「トーン変更」といったいくつかのテンプレートが初期データとして登録されており、新しいテンプレートの追加や既存テンプレートの取得が容易に行える。

そして、AIモデルとの実際の通信とプロンプトの生成ロジックを担当する「PromptCraftService」クラスを作成する。このサービスは、Spring AIが提供する「ChatClient」という機能を利用してOpenAIのAIモデルと連携する。主な機能としては、テンプレートに含まれるプレースホルダー（例: {topic}）を実際の値に置き換えてユーザープロンプトを生成する「renderTemplate」メソッド、システムからの指示とユーザーからの指示を組み合わせてAIに送信し、その応答を受け取る「generate」メソッドがある。最終的に、「generateFromTemplate」メソッドは、テンプレートから生成されたユーザープロンプトとシステムプロンプトを用いて、AIにテキスト生成を依頼し、その結果を返す一連の処理を統合する。

これらのステップを経て開発されたPromptCraftアプリケーションの機能は、Webブラウザの開発者ツールや「curl」コマンドのようなツールを使ってテストできる。例えば、特定のURLにJSON形式のデータを含むリクエストを送信することで、新しいテンプレートを登録したり、登録済みのテンプレートや指定した条件に基づいてAIにテキストを生成させたりする動作を確認できる。

PromptCraftは、このようにSpring BootとSpring AIを組み合わせることで、AIプロンプトの作成、保存、再利用を容易にする軽量なAIプロンプト生成アプリケーションだ。シンプルに設計されたREST APIを通じて、開発者はAIの応答を迅速に生成したり、異なるAIモデルの性能を比較したり、AIプロンプト管理の機能を自身のアプリケーションに組み込んだりすることが可能になる。これにより、AIを活用した新しいアプリケーション開発の可能性が大きく広がることになる。