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

ChatGPTのようなAI(人工知能)を、自分のプログラムから呼び出せたら便利だと思ったことはありませんか。実は難しい専用ソフトを使わなくても、Rubyの標準的な仕組みだけでAI APIを呼び出すことができます。この記事では、RubyからAI APIを利用する基本の流れを、初心者向けにやさしく解説します。

AI APIとは何か

API(エーピーアイ、Application Programming Interfaceの略)とは、プログラム同士が機能をやり取りする窓口のような仕組みです。AI APIは、AIの会社が用意しているサーバーに「この質問に答えて」とお願いすると、AIが考えた答えを返してくれる仕組みです。自分のパソコンでAIモデルを動かす必要がないため、比較的手軽に使えるのが特徴です。

APIリクエストの基本の流れ

AI APIを使うときの流れは、だいたいどのサービスでも共通しています。

  1. APIキー(利用者を識別するための暗号のような文字列)を取得する
  2. HTTP通信(インターネット上でデータをやり取りする方法)を使って、質問文などのデータを送る
  3. AIからの返事(JSONというテキスト形式のデータ)を受け取る
  4. 受け取ったデータから、必要な部分だけを取り出して使う

Rubyでこの通信を行うには、標準ライブラリのnet/httpを使う方法があります。ほかにも、httpartyやfaradayといった外部のgem(Rubyの便利な拡張機能をまとめたパッケージ)を使う方法もあります。標準ライブラリだけでも十分動きますが、外部gemを使うとコードがすっきり書けることが多いです。

net/httpを使った送信の例

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.example.com/v1/chat')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = "Bearer #{ENV['AI_API_KEY']}"
request.body = { message: "こんにちは" }.to_json

response = http.request(request)
result = JSON.parse(response.body)
puts result['reply']

このコードでは、質問文をJSON形式に変換して送信し、返ってきた答えをJSONから元のデータに戻して表示しています。Rubyにはto_jsonやJSON.parseのように、文字列とJSONを相互に変換するメソッドが標準で用意されています。そのため、変換処理を自分で書く必要がないのは助かるポイントです。

APIキーの扱い方の注意点

APIキーは、家の鍵のように第三者に知られてはいけない情報です。もしプログラムのコードに直接書いてしまい、それをそのままGitHub(ソースコードを公開・共有できるサービス)などにアップロードすると、誰でもそのキーを使えるようになってしまいます。その結果、勝手に利用されて費用が発生する恐れがあります。

そのため、APIキーはコードに直接書かず、環境変数(OSが管理する設定値)として保存し、ENV['AI_API_KEY']のように読み込むのが基本です。開発時にはdotenvというgemを使い、.envというファイルにキーを書いておくと管理がしやすくなります。ただし、この.envファイル自体も公開リポジトリに含めないよう、.gitignoreという除外設定ファイルに登録しておきましょう。

Rubyならではのポイント

PythonなどでもAI APIはよく使われますが、Rubyには独自の特徴があります。Rubyの場合は「シンボル」というRuby特有のデータの書き方(:messageのような、文字列に似た軽量な値)を使ってオプションを指定するライブラリが多いのが特徴です。また、ブロック構文(do〜endで処理をまとめる書き方)を使って、通信のエラー処理を簡潔に書けるgemも多く見られます。エラー処理にはbegin〜rescueという構文を使い、通信が失敗した場合にプログラムが止まってしまわないようにしておくと安心です。

まとめ

RubyからAI APIを呼び出す基本は、APIキーを安全に用意し、HTTP通信で質問データを送り、返ってきたJSONを読み取るというシンプルな流れです。標準ライブラリだけでも実現できますが、外部gemを使えばより短いコードで書けます。APIキーの管理には十分注意しながら、ぜひ自分のRubyプログラムにAIの力を組み込んでみてください。

関連記事

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

参考書籍(PR)

Rubyをもっと学びたい方には「プロを目指す人のためのRuby入門[改訂2版]」がおすすめです。

コメント

コメントを投稿

このブログの人気の投稿

#11 Rustで学ぶエラーハンドリングの基本

Rustのエラーハンドリングは、他の言語のような「例外」という仕組みを持たず、`Result`という型を使った独自の考え方が中心になります。この記事では、Rustにおけるエラーハンドリングの基本を解説します。 Result型という考え方 失敗する可能性がある処理は、`Result`という「成功か失敗かを表す型」を返します。 fn divide(a: i32, b: i32) -> Result<i32, String> { if b == 0 { return Err(String::from("0では割れません")); } Ok(a / b) } 成功時は`Ok`、失敗時は`Err`という形で結果を包んで返します。 matchで結果を扱う match divide(10, 0) { Ok(result) => println!("結果: {}", result), Err(message) => println!("エラー: {}", message), } ?という便利な記号 Rustには、`Result`がエラーだった場合に、その場で関数の呼び出し元にエラーを伝えて処理を中断できる`?`という記号があります。 fn calculate() -> Result<i32, String> { let result = divide(10, 0)?; Ok(result) } Rustならではの注意点 他の言語の「エラーが起きても気づかずに進んでしまう」という問題を防ぐため、Rustは`Result`の中身を確認しない限り、警告を出す仕組みになっています。エラーの可能性を無視できない設計こそが、Rustの安全性を支えています。 まとめ Rustのエラーハンドリングは`Result`型が中心で、`match`や`?`を使って結果を扱います。エラーの可能性を無視できない設計に慣れていきましょう。 本ページはプロモーションを含みます。 参考書籍(PR) Rustをもっと学びたい方には「 実践Rust入門[言語仕様から開発手法まで] 」がおすすめです。...
続きを読む

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

TypeScriptの辞書に相当する仕組みは、JavaScriptと同じですが、キーと値の型をあらかじめ決めておけるのが特徴です。この記事では、TypeScriptにおける辞書の扱い方を解説します。 型付きのオブジェクト interface Person { name: string; age: number; } const person: Person = { name: "太郎", age: 20 }; キーの型が決まっていない辞書 キーの名前が事前に決まっていない辞書のような使い方をしたい場合は、次のように書きます。 const scores: { [key: string]: number } = {}; scores["太郎"] = 90; Mapを使う場合 const person = new Map<string, string>(); person.set("name", "太郎"); `Map<string, string>`のように、キーと値それぞれの型を指定できます。 TypeScriptならではの注意点 型付きのオブジェクト(`interface`)を使うと、存在しないキーにアクセスしようとした際に、実行前の段階でエラーとして教えてもらえます。データの形が決まっている場合は、キーが自由な辞書よりも`interface`を使うほうが安全です。 まとめ TypeScriptの辞書は、形が決まっているなら`interface`、自由なキーを扱うなら`{ [key: string]: 型 }`や`Map`を使います。用途に応じて型の付け方を選びましょう。 本ページはプロモーションを含みます。 参考書籍(PR) TypeScriptをもっと学びたい方には「 プロを目指す人のためのTypeScript入門 」がおすすめです。
続きを読む

#19 Goで学ぶテスト(単体テスト)の基本

Goはシンプルな文法が魅力ですが、書いたコードが正しく動くかどうかは別問題です。この記事では、Goで書いたコードを自動でチェックする「テスト」の基本を解説します。 なぜテストを書くのか コードを修正するたびに、関連する機能が壊れていないかを手作業で確認するのは大変です。テストを用意しておけば、コマンド一つで動作確認ができ、安心してコードを直せるようになります。 Go標準のテスト機能 Goには追加のライブラリを入れなくても使える testing パッケージが標準で備わっています。テスト対象のファイルと同じディレクトリに、名前の末尾が _test.go のファイルを作ります。 // add.go package main func add(a int, b int) int { return a + b } // add_test.go package main import "testing" func TestAdd(t *testing.T) { result := add(2, 3) if result != 5 { t.Errorf("add(2, 3) = %d; want 5", result) } } テスト関数の名前は Test から始める決まりです。ターミナルで go test と実行すると、 _test.go 内の Test から始まる関数がすべて自動で実行されます。 複数パターンをまとめてテストする Goでは、複数の入力パターンをスライス(配列のようなもの)にまとめて、まとめてテストする書き方(テーブル駆動テスト)がよく使われます。 func TestAddCases(t *testing.T) { cases := []struct{ a, b, want int }{ {2, 3, 5}, {0, 0, 0}, {-1, 1, 0}, } for _, c := range cases { if got := add(c.a, c.b); got != c.want { t.Errorf("add(%d,...
続きを読む