#25 Scalaで学ぶAI API(ChatGPT等)の呼び出し方の基本

#25 Scalaで学ぶAI API(ChatGPT等)の呼び出し方の基本

ChatGPTのようなAI(人工知能)が返す文章を、自分のプログラムから使ってみたいと思ったことはありませんか。実はこうしたAIの多くは「API」という仕組みを通じて、誰でもプログラムから呼び出せるようになっています。今回はScalaという言語を使って、AI APIを呼び出す基本のやり方を見ていきましょう。

AI APIとは何か

API(エーピーアイ)とは「Application Programming Interface」の略です。あるソフトウェアの機能を、別のプログラムから使えるようにするための窓口のようなものです。ChatGPTなどのAIサービスは、インターネット経由でリクエスト(依頼)を送ると、AIが考えた答えをレスポンス(返答)として返してくれるAPIを公開しています。

このやり取りは多くの場合「REST API」と呼ばれる形式で行われます。難しく聞こえますが、要するに「決まった形のURLに、決まった形のデータを送ると、決まった形のデータが返ってくる」というシンプルな約束事だと考えれば大丈夫です。データのやり取りには「JSON」というテキスト形式がよく使われます。JSONは`{"key": "value"}`のように、名前と値をペアで書く、人にも読みやすいデータの書き方です。

ScalaでHTTP通信をするには

ScalaはJava仮想マシン(JVM)上で動く言語で、Javaの豊富なライブラリ(便利な部品集)がそのまま使える点が特徴です。ただ、素のJavaのHTTP通信の書き方はやや冗長なので、Scala向けのHTTPクライアントライブラリを使うのが一般的です。代表的なものに「sttp」というライブラリがあります。

sttpを使うと、次のようなイメージでリクエストを組み立てられます。

import sttp.client3._

val request = basicRequest
  .header("Authorization", s"Bearer $apiKey")
  .header("Content-Type", "application/json")
  .body(jsonBody)
  .post(uri"https://api.example.com/v1/chat")

val response = request.send(backend)
println(response.body)

ここで`basicRequest`にヘッダー(通信の付加情報)やボディ(送信するデータ本体)を設定しています。そのうえで`.post`でPOSTリクエスト(データを送信する種類のリクエスト)を送っています。難しい設定を一つずつ積み木のように組み立てていくイメージです。

APIキーの扱い方には注意する

多くのAI APIは「APIキー」と呼ばれる、自分専用の合言葉のような文字列を使って利用者を識別します。上のコード例にある`Authorization`ヘッダーがそれにあたります。このAPIキーは、他人に知られてしまうと勝手に使われてしまう可能性があります。そのため、ソースコードに直接書き込まず、環境変数(OSが管理する設定値)から読み込むのが安全な方法です。

val apiKey = sys.env.getOrElse("API_KEY", "")

`sys.env`はScalaで環境変数を取得するための書き方です。こうしておけば、コードをGitHubなどに公開しても、APIキー自体が漏れる心配がありません。

レスポンスの扱い方とJSONパース

APIから返ってくるレスポンスはJSON形式の文字列であることがほとんどです。この文字列をScalaのプログラムで扱いやすい形に変換する作業を「パース(解析)」と呼びます。Scalaには「circe」や「play-json」といったJSONを扱うためのライブラリがあります。これらを使うと、JSONの中身をcase class(データをまとめて表現するための入れ物のようなクラス)に変換できます。

case class ChatResponse(reply: String)

import io.circe.parser.decode
val result: Either[Error, ChatResponse] = decode[ChatResponse](response.body)

ここで登場する`Either`は、Scalaらしい書き方のひとつです。「成功したら右側(Right)に結果、失敗したら左側(Left)にエラー情報を入れる」という型で、成功と失敗の両方をきちんと表現できます。JavaやPythonの例外処理(try-catch)に近い役割ですが、失敗する可能性そのものを型として明示できる点がScalaらしい発想です。

Scalaならではの注意点

Scalaで通信処理を書くときは、`Future`という「これから完了する予定の処理結果」を表す仕組みがよく登場します。API呼び出しのようにネットワーク越しの処理は時間がかかります。そのため、処理の完了を待つ間も他の作業ができるよう、非同期(処理の完了を待たずに次へ進める仕組み)で扱うのが一般的です。最初のうちは「今すぐ結果が返ってこない処理がある」という感覚に戸惑うかもしれませんが、慣れてくるとむしろ効率的な書き方だと感じられるはずです。

また、ライブラリの追加は`sbt`(Scala標準のビルドツール)の設定ファイルに1行追加するだけで済みます。JavaScriptのnpmやPythonのpipに近い感覚で、必要な部品を取り込めます。

まとめ

ScalaからAI APIを呼び出す基本は、(1)HTTPクライアントでリクエストを組み立てる、(2)APIキーは環境変数などで安全に管理する、(3)返ってきたJSONをcase classにパースして扱う、という3つの流れで理解できます。`Either`や`Future`といったScalaらしい型に最初は戸惑うかもしれませんが、一つずつ試していけば、AI APIとの連携も着実に身につけられるでしょう。

関連記事

本ページはプロモーションを含みます。

参考書籍(PR)

Scalaをもっと学びたい方には「実践Scala入門」がおすすめです。

コメント

コメントを投稿

このブログの人気の投稿

#25 Rustで学ぶAI API(ChatGPT等)の呼び出し方の基本

ChatGPTのようなAI(人工知能)の機能を自分のアプリに組み込みたいとき、多くの場合は「AI API」と呼ばれる仕組みを使います。APIとは「Application Programming Interface」の略です。簡単に言えば、「あるサービスの機能を、プログラムから呼び出せるようにした窓口」のことです。この記事では、Rustから外部のAI APIをHTTPリクエストで呼び出す基本的な流れを、初心者向けに解説します。 AI APIを呼び出すとはどういうことか ChatGPTを提供するOpenAI社などは、インターネット経由でAIに質問を送り、回答を受け取れる「AI API」を公開しています。これはWebブラウザで検索するときのように、決まった宛先(URL)にデータを送信し、返ってきた結果を受け取る仕組みです。この「データを送って結果を受け取る」通信方式を、HTTPリクエストと呼びます。Rustのプログラムからこの通信を行うことで、自分のアプリの中でAIに質問し、回答を取得できるようになります。 reqwestクレートを使う Rustには標準でHTTP通信の機能は含まれていません。そこで使うのが「クレート」と呼ばれる外部ライブラリです。クレートはPythonのライブラリやJavaScriptのパッケージに近いもので、 Cargo.toml というファイルに追記するだけで簡単に導入できます。HTTP通信でよく使われるのが reqwest というクレートです。 Cargo.toml に次のように追記します(バージョン番号は執筆時点の例なので、実際に使う際は最新版を確認してください)。 [dependencies] reqwest = { version = "0.11", features = ["json"] } tokio = { version = "1", features = ["full"] } serde_json = "1.0" ここで tokio という見慣れないクレートも一緒に入れています。これは「非同期処理」と呼ばれる、通信の待ち時間の間に他の処理を進められる仕組みを扱うためのものです。ネットワーク通信は結果が返ってくるまで時間...
続きを読む

#8 C++で学ぶ文字列操作の基本

C++の文字列操作は、`std::string`という型を使うのが現代的な基本の書き方です。この記事では、C++における文字列操作の基本と、注意しておきたい落とし穴を解説します。 文字列を連結する std::string greeting = "こんにちは、" + name + "さん"; `std::string`同士であれば、`+`を使った連結がそのまま使えます。既存の文字列に追加する場合は`+=`や`append`メソッドも使えます。 greeting += "。よろしくお願いします。"; よく使う文字列操作 name.length() 文字数を調べる(バイト数であることに注意、後述) name.substr(0, 3) 一部分を取り出す(開始位置と長さを指定) name.find("A") 特定の文字の位置を探す(見つからなければ`std::string::npos`) name.replace(0, 2, "XX") 一部分を置き換える 文字列を数値に変換する 文字列を数値に変換したい場合は`std::stoi`(整数)や`std::stod`(小数)、逆に数値を文字列にしたい場合は`std::to_string`を使います。 int num = std::stoi("123"); std::string s = std::to_string(456); 文字列を分割する C++の標準ライブラリには、他言語の`split`のような文字列分割の関数が長らく用意されていませんでした。`std::stringstream`を使うのが伝統的な方法です。 #include <sstream> std::stringstream ss("a,b,c"); std::string item; while (std::getline(ss, item, ',')) { std::cout << item << std::endl; } C++ならではの注意点 C++には、古くからある`char`の配列を...
続きを読む

#16 TypeScriptで学ぶ辞書型(マップ)の基本

TypeScriptの辞書に相当する仕組みは、JavaScriptと同じですが、キーと値の型をあらかじめ決めておけるのが特徴です。この記事では、TypeScriptにおける辞書の扱い方と、用途別の型の選び方を解説します。 型付きのオブジェクト interface Person { name: string; age: number; } const person: Person = { name: "太郎", age: 20 }; キーの型が決まっていない辞書 キーの名前が事前に決まっていない辞書のような使い方をしたい場合は、次のように書きます。 const scores: { [key: string]: number } = {}; scores["太郎"] = 90; 同じ意味を Record というユーティリティ型で簡潔に書くこともできます。 const scores: Record = {}; Mapを使う場合 const person = new Map (); person.set("name", "太郎"); console.log(person.get("name")); Map<string, string> のように、キーと値それぞれの型を指定できます。 Object と違い、キーの数を person.size で正確に取得できる、キーの型を文字列以外にもできるといった利点があります。 値が存在しないかもしれない場合 キーが実在するとは限らない辞書の場合、値の型に | undefined を含めておくと、より正確な型になります。 const scores: { [key: string]: number | undefined } = {}; const value = scores["三郎"]; // number | undefined 型 こうしておくと、存在しないキーへのアクセスがコンパイル時に見過ごされにくくなります。 存在しないキーへのアクセスを防ぐ tsconfig.json で noUncheckedIndexedAccess を有効にす...
続きを読む