Assistants API

会話はサーバー側に保存されるスレッドに入り、ランと呼ぶ非同期の処理がそのスレッドに対して実行されました。移行先は Responses API と Conversations API です。この記事では、仕組みの要点と移行の手順をまとめます。

Assistants API には、次のものがありました。

• アシスタント: モデルの選択・指示・ツールの宣言を束ねた、永続的な API オブジェクトです。作成から管理まで、すべて API で行いました。
• スレッド: メッセージを集めたもので、サーバー側に保存されました。保存できるのはメッセージだけでした。
• ラン: スレッドに対して実行される非同期の処理です。

Assistants API は 2026 年 8 月 26 日に提供を終了しました。移行先は Responses API と Conversations API で、移行ガイドが用意されています。

アシスタント単位で置き換える場合の流れは次のとおりです。

1. 既存の各アシスタントについて、指示とツールの組み合わせ (instruction + tool bundle) を確認します。
2. ダッシュボードで、その組み合わせを名前付きのプロンプトとして作り直します。
3. プロンプト ID (またはエクスポートした仕様) をソース管理に保存し、アプリケーションのコードから固定の識別子で参照できるようにします。
4. 展開の途中で A/B テストをするときは、プロンプト ID を差し替えます。アシスタントのオブジェクトをプログラムから作成・削除する必要はありません。

スレッドのメッセージを取得する Assistants API の呼び出しは、もう動作しません。過去の会話履歴を新しい仕組みへ引き継ぐには、アプリケーション側ですでに保存しているメッセージが必要です。自社のシステムで会話のメッセージを保存しているかどうかを、移行の前に確認しておくことが大切です。

Assistants API からは、移行ガイドに沿って Responses API と Conversations API へ移行します。ここでは既存の統合を移す流れを示します。

1. アプリケーションの中で、重要なアシスタントのオブジェクトを洗い出します。
2. ダッシュボードでそれらのアシスタントを探し、Create prompt (プロンプトを作成) をクリックして、既存のアシスタントごとにプロンプトのオブジェクトを作ります。
3. 新しいチャットは、Conversations API と Responses API で始めます。
4. 過去の会話履歴を残すには、アプリケーション側ですでに保存しているメッセージを使います。スレッドのメッセージを取得する Assistants API の呼び出しは、もう動作しません。