1. はじめに

今回は、実際に Assistants API を利用するためのセットアップ方法 や 基本的な操作 を説明します。

2. 環境構築

2.1 API キーの取得

まず、OpenAI の開発者ポータル にログインし、API キーを取得します。

1. OpenAI にログイン
2. API キー管理ページ に移動
3. 新しい API キーを作成し、コピーして保存（環境変数に設定することを推奨）

BASH
export OPENAI_API_KEY="your-api-key-here"

2.2 必要なライブラリをインストール

Assistants API を使うために、openai ライブラリをインストールします。

BASH
pip install openai

3. Assistants API の基本操作

3.1 アシスタントの作成

アシスタントを作成するには、openai.Assistant.create() を使用します。

PYTHON
import openai

openai.api_key = "your-api-key-here"

assistant = openai.beta.assistants.create(
    name="My Assistant",
    instructions="ユーザーの質問に回答してください。",
    model="gpt-4-turbo"
)

print("Assistant ID:", assistant.id)

3.2 スレッドの作成

会話の履歴を保持するために、スレッド（Thread）を作成します。

PYTHON
thread = openai.beta.threads.create()
print("Thread ID:", thread.id)

3.3 メッセージの送信

作成したスレッドにメッセージを送信します。

PYTHON
message = openai.beta.threads.messages.create(
    thread_id=thread.id,
    role="user",
    content="OpenAI Assistants API について教えてください。"
)

3.4 返答の取得

アシスタントの応答を取得します。

PYTHON
run = openai.beta.threads.runs.create(
    thread_id=thread.id,
    assistant_id=assistant.id
)

response = openai.beta.threads.runs.retrieve(thread_id=thread.id, run_id=run.id)
print("Response:", response)

4. まとめ

• API キーを取得し、環境変数に設定
• openai ライブラリをインストール
• アシスタントを作成し、スレッドを管理
• メッセージを送信し、応答を取得する方法を学習

⚠️ 注意事項（2025 年 2 月 21 日現在）

本記事の内容は執筆時点の情報に基づいています。
OpenAI Assistants API は頻繁にアップデートされるため、公式ドキュメント（Quickstart）も適宜ご確認ください。

最終的な判断・実装は自己責任で行ってください。