5
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

PythonとOpenAI APIで実践!MCP開発入門 【第2回】第2回: OpenAI APIとは?何ができる?「コンテキスト(MCP)」がAIを賢くする仕組み入門

Posted at

はじめに

AIとの対話を実現する「魔法の扉」を開けよう!

皆さん、こんにちは!前回の第1回では、AI開発のスタートラインとして、Pythonプログラミング環境をPCに構築しましたね。道具と作業場はバッチリ整いました。2025年5月、ここ東京・中央区からお送りするこのシリーズ、今回は、いよいよ私たちがこれから主役として使っていく「OpenAI API」とは一体何者で、どんな驚くべき能力を秘めているのか、そしてこのシリーズの鍵となる 「コンテキスト(文脈)」、私たちが本シリーズで「モデルコンテキストプロトコル(MCP)」 と呼ぶ概念が、AIをどのように賢くするのか、その魅力的な仕組みの扉を開いていきましょう!

「APIって何?」「LLMってよく聞くけど…」「コンテキストって、具体的にどういうこと?」こうした疑問を抱いている方も多いでしょう。今回の記事では、これらの基本的ながらも極めて重要な概念を、技術的な背景やキーワード(HTTPリクエスト/レスポンス、JSON、Transformerアーキテクチャ、知識カットオフなど)にも触れながら、初心者の方にも分かりやすく解説します。AIとのより深い対話を実現するための「秘密の呪文」を、一緒に学んでいきましょう!

# はじめに - visual selection (60).png

そもそも「API」とは? システム間の「通訳兼メッセンジャー」

まず、OpenAI APIの「API」とは何でしょうか?
API(Application Programming Interface - アプリケーション・プログラミング・インターフェース) とは、簡単に言えば、 異なるソフトウェアやサービス同士が情報をやり取りしたり、機能を呼び出したりするための「窓口」や「約束事」 のことです。

例えるなら「レストランのウェイター」: あなたがレストラン(サービスを利用したい側)に行ったとします。あなたは厨房(サービスを提供する側)に直接入って料理を注文しませんよね? 代わりに、ウェイターさん(API)に「〇〇をください」と注文(リクエスト)を伝えます。ウェイターさんはその注文を厨房に伝え、出来上がった料理(レスポンス)をあなたの元へ運んできます。

技術的な側面

ウェブベースのAPIでは、多くの場合、あなたのプログラム(クライアント)が、インターネットを通じて特定のAPIエンドポイント(サーバー上の特定の住所のようなもの)に対して、HTTPリクエストという形式で「お願い」を送ります。サーバー側はそのリクエストを処理し、結果をHTTPレスポンスとして返します。このやり取りに使われるデータの形式には、 JSON(JavaScript Object Notation) という軽量で人間にも機械にも読みやすい形式がよく用いられます。
OpenAI APIもこの仕組みを使っており、私たちのPythonプログラムからOpenAIのAIモデルの機能を呼び出すための「窓口」となってくれるのです。

OpenAI APIとは? AIの超能力をあなたのプログラムに!

OpenAI APIは、その名の通り、OpenAI社が開発・提供している最先端のAIモデル群(特に大規模言語モデル - LLM)の能力を、開発者が自分のプログラムやサービスに簡単に組み込めるようにするためのAPIです。

中核をなすのは「GPT(Generative Pre-trained Transformer)」シリーズ

皆さんも「ChatGPT」でその驚異的な能力に触れたことがあるかもしれません。OpenAI APIを通じて、このChatGPTの頭脳とも言える GPTモデル(例:GPT-4o, GPT-4 Turbo, GPT-3.5 Turboなど) を、プログラムから直接呼び出して利用できます。これらのモデルは、Transformer(トランスフォーマー)アーキテクチャという画期的な技術(※)に基づいており、人間が書いたような自然なテキストを理解し、生成する能力に長けています。 (※ Transformerアーキテクチャ:2017年にGoogleが発表した深層学習モデルの構造。特に自然言語処理分野に革命をもたらし、現在の多くのLLMの基礎となっています。)

OpenAI APIでできること(ほんの一例)

  • 文章生成: ブログ記事、メール、小説、詩、キャッチコピーなど、あらゆる種類の文章を自動生成。
  • 質疑応答: 専門的な知識に関する質問にも、人間のように自然な言葉で回答。
  • 翻訳: 高精度な機械翻訳。
  • 要約: 長文のドキュメントや記事の内容を短くまとめる。
  • 感情分析: 文章から書き手の感情(ポジティブ、ネガティブ、中立など)を読み取る。
  • コード生成: PythonやJavaScriptなど、様々なプログラミング言語のコードを生成したり、説明したりする。

画像生成(DALL·Eモデルなど)

テキストによる指示から、全く新しい画像を生成する。(本シリーズでは主にテキスト系モデルを扱います)
これらはほんの一例です。APIを使うことで、これらのAI機能をあなたのウェブサイト、スマートフォンアプリ、業務システムなどに組み込み、これまでにない価値を提供できるのです。

APIの向こう側

大規模言語モデル(LLM)の「頭脳」

OpenAI APIの背後で実際に働いているのは、前述の通り LLM(Large Language Model - 大規模言語モデル) です。

LLMはどうやって賢くなった?(超簡略版)

LLMは、インターネット上の膨大な量のテキストデータ(ウェブサイト、書籍、記事など)を事前に「読む」(学習する)ことで、言葉と言葉の繋がり方や、文法、文脈、さらには様々な知識のパターンを統計的に習得しています。その結果、与えられたテキスト(プロンプト)に対して、次に続く可能性が最も高い単語(トークン※)を予測し、それを繰り返すことで、人間が書いたかのような自然な文章を生成できるのです。 (※トークン:AIがテキストを処理する際の最小単位。英語では単語に近いですが、日本語ではより細かく分割されることが多いです。)

重要な特性

「知識のカットオフ」 多くのLLMは「事前学習済みモデル」であり、その知識は 訓練データが収集された特定の日時(知識のカットオフ日)までの情報に基づいています。つまり、それ以降に起こった出来事や新しい情報については、基本的には「知らない」のです。(例:2023年までしか学習していないモデルに、2024年のニュースについて尋ねても正確な答えは期待できません。) この「知識のカットオフ」という特性が、次に説明する「コンテキスト」 の重要性を一層際立たせます。

AIを真に賢くする「魔法の調味料」

コンテキスト(本シリーズにおけるMCP)

どんなに優秀な専門家でも、相談内容に関する背景情報がなければ的確なアドバイスはできませんよね? AIも同じです。AIがその能力を最大限に発揮するためには、私たちが「何を知りたいのか」「どんな状況なのか」「何を期待しているのか」といった 「コンテキスト(文脈)」 を適切に与えることが不可欠です。

本シリーズでは、この 「AIに与えるべき、構造化された背景情報や指示」のことを、広義の「モデルコンテキストプロトコル(MCP)」 と捉え、その設計とAPIを通じた伝達方法を学んでいきます。これは、開発者がAIとの間で「こういった情報を、こういう形でやり取りしましょう」と定める「約束事(プロトコル)」のようなものです。

技術的側面

コンテキストはどうやって渡す?

OpenAI API(特にチャットモデル)を利用する場合、このコンテキストは主に以下の形で、JSON形式のデータとして HTTPリクエストのペイロード(本体部分) に含めてAIモデルに送信されます。

  • システムメッセージ(System Message): AIに基本的な役割や振る舞い、応答のトーンなどを指示する、いわば「事前設定」のようなもの。
  • ユーザーメッセージ(User Message): 私たち人間がAIに送る質問や指示。これが「プロンプト」の中核となります。
  • アシスタントメッセージ(Assistant Message): 過去のAI自身の応答。これをコンテキストとして含めることで、複数ターンにわたる会話の流れをAIが記憶し、一貫性のある対話が可能になります。
  • 付加的な構造化データ: 上記のメッセージに加えて、ユーザーのプロフィール情報、閲覧履歴、外部データ(例:天気予報、商品情報)などを、開発者が定義したJSON構造で含めることも、MCPの重要な実践となります。

コンテキストの具体例

  • ユーザーの基本情報(年齢層、興味関心、専門知識レベルなど)
  • 過去の会話履歴全体、またはその要約
  • 参照してほしいドキュメントやウェブページの内容の抜粋
  • AIに演じてほしい役割やペルソナ(例:「あなたは親しみやすい旅行アドバイザーです」)
  • 出力してほしい形式の指定(例:「箇条書きで3点にまとめてください」)

「コンテキスト(MCP)」がAIにもたらす劇的な変化

適切なコンテキストをMCPの考え方に沿って設計し、AIに提供することで、以下のような素晴らしい効果が期待できます。

  • 驚異的なパーソナライゼーション: ユーザーの好みや状況に完璧に合わせた応答や提案が可能になります。(例:あなたの旅行スタイルに合った旅程の提案)
  • 圧倒的な関連性の向上: 曖昧な質問に対しても、文脈を理解することで、本当に知りたい情報(的を射た回答)を返せるようになります。
  • 自然でスムーズな対話: 会話の流れを記憶し、前の話題を踏まえた応答ができるため、人間と話しているかのような自然なコミュニケーションが実現します。
  • 幻覚(ハルシネーション)の抑制と正確性の向上: AIが知らない情報(知識カットオフ後の出来事や、専門性の高すぎる情報)について無理に答えようとするのを防ぎ、与えられたコンテキストに基づいて事実に基づいた応答を生成するよう誘導できます。
  • きめ細やかなアウトプット制御: 回答のトーン、文体、長さ、形式などを、コンテキストを通じてより細かくコントロールできます。

まさに、コンテキストこそが、汎用的なAIモデルを、特定のタスクやユーザーに最適化された「賢いパートナー」へと変貌させるための「魔法の調味料」なのです。

# はじめに - visual selection (61).png

おわりに

AIとの対話、その奥深さへの招待

今回は、OpenAI APIという強力なツールと、その能力を最大限に引き出すための鍵となる「コンテキスト(MCPの考え方)」について、その基本的な仕組みと重要性を解説しました。

APIは、プログラムがAIの超能力を呼び出すための「窓口」。
その向こうには、Transformerアーキテクチャに支えられた強力な LLM(GPTシリーズなど) が存在する。
しかし、LLMの知識にはカットオフがあり、真の賢さを引き出すには、私たちがJSON形式などで構造化して提供する 「コンテキスト」 が不可欠。
このコンテキストの設計と伝達方法こそが、本シリーズにおける MCP(モデルコンテキストプロトコル) の核心。
OpenAI APIとPythonという組み合わせは、開発者にとって、かつてないほど簡単に、そして強力にAIを活用できる道を開きました。そして、その力を真に解き放つのが「コンテキスト」の戦略的な活用です。

次回は、いよいよAIへの「通行証」であるOpenAI APIキーを取得し、安全に管理するための具体的な手順とテクニックを学びます。AIとの本格的な対話が、もうすぐ始まります!

次回予告

AIと話すための「言葉(プロンプト)」と「背景知識(コンテキスト)」の重要性が分かりました。では、実際にOpenAI APIを利用するためには何が必要なのでしょうか?
次回、第3回「AIへの「通行証」- OpenAI APIキー発行と安全な管理・設定テクニック(環境変数と.envファイル徹底活用)」では、APIを利用するための「鍵」となるAPIキーの取得方法と、それを安全に取り扱うための必須知識を解説します。お楽しみに!

5
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
5
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?