OpenAI
このページは機械翻訳されています。元の英語の記事を表示

Assistants API(v2)FAQ

更新日: 13 days ago

2025年3月11日付で、新しいAgentsプラットフォームの構成要素をリリースしました。詳細は、Responses API のAPIドキュメント、Web SearchFile SearchComputer Use を含むTools、ならびにAgents SDKTracing対応)をご覧ください。Assistants API betaに関する皆さまからのフィードバックを踏まえ、Responses APIに主要な改善を取り込みました。機能が完全に同等になり次第、今年後半にAssistants APIの廃止計画を発表し、2026年前半を廃止(サンセット)の目標時期としています。

Assistants APIとは何ですか?

Assistants API を使うと、開発者はアプリ内で強力なAIアシスタントを簡単に構築できます。このAPIにより会話履歴を管理する必要がなくなり、Code InterpreterやFile SearchなどOpenAIがホストするツールへアクセスできるようになります。また、サードパーティ製ツール向けの関数呼び出し(function calling)も改善された形でサポートしています。

Assistants API v1 betaは引き続き使えますか?

いいえ。2024年12月18日以降、ユーザーはAssistant API betaの v1 バージョンにアクセスできません。現在サポートしているのはv2のみです。API呼び出しをv1からv2へ移行するには、この移行ガイドをご確認ください。

どうやって利用できますか?

Assistants APIは、OpenAI APIアカウントをお持ちの方であればどなたでも利用できます。Assistants Playground から始めることも可能です。

Assistantとは何ですか?

Assistantは、OpenAIのモデルを使用する目的特化のAIを表し、ファイルへのアクセス、永続的なスレッドの維持、ツールの呼び出しが可能です。

Threadとは何ですか?

Threadは、アシスタントとユーザー間の会話セッションです。Threadsはメッセージ履歴を保存し、会話がモデルのコンテキスト長に対して長くなりすぎると履歴を切り詰めることで、アプリケーション開発を簡素化します。

File Searchツールとは何ですか?

file_search ツールは、ファイルから適切なデータを取り出してモデルの回答を補強できるよう、検索(リトリーバル)のベストプラクティスをデフォルトで複数実装しています。詳しくは開発者向けドキュメントをご覧ください。

デフォルトでは、file_searchツールは次の設定を使用します:

  • チャンクサイズ:800トークン

  • チャンク重なり:400トークン

  • 埋め込みモデル:256次元の text-embedding-3-large

  • コンテキストに追加されるチャンクの最大数:20

ファイルアップロードの制限は何ですか?

ファイルをアップロードする際の制限は次のとおりです:

  • ファイルあたり512 MB

  • ファイルあたり500万トークン

  • ベクトルストアあたり1万ファイル

  • アシスタントあたりベクトルストア1つ

  • スレッドあたりベクトルストア1つ

組織内の各プロジェクトの総ストレージ上限は100 GBです。

File Searchツールの制約は何ですか?

今後数か月で対応を進めている既知の制限がいくつかあります:

  1. 現時点では、チャンク分割、埋め込み、取得(リトリーバル)の設定を変更する方法がありません。

  2. ドキュメント内の画像の解析はサポートしていません。

  3. .csvや.jsonlのような構造化されたファイル形式に対するリトリーバルはサポートしていません。サポートされているファイルタイプをご確認ください。

Assistants APIのレート制限は何ですか?

Assistants APIのレート制限は、利用ティアとモデルには紐づきません。代わりに、リクエスト種別ごとにデフォルトの上限があり、いくつか例外があります:

  • GET:1000 RPM

  • POST:300 RPM

    • /v1/threads/<thread_id>/runs へのPOST:200 RPM

    • /v1/threads/runs へのPOST:200 RPM

  • DELETE:1分あたり300リクエスト

APIにおけるCode Interpreterの料金体系は?

Code Interpreterは1セッションあたり$0.03です。アシスタントが 異なる スレッド で同時にCode Interpreterを呼び出した場合、Code Interpreterセッションが2つ作成されます(2 * $0.03)。各セッションはデフォルトで1時間有効のため、ユーザーが同じスレッド内で最大1時間にわたりCode Interpreterに指示を出し続けた場合、この料金は1回分のみお支払いいただくことになります。

APIにおけるFile Searchの料金体系は?

File Searchは、ベクトルストアのストレージに対して1日あたり$0.10/GB(最初の1GBは無料)です。ベクトルストアのサイズは、ファイルが解析され、チャンク化され、埋め込みが作成された後のベクトルストアの結果サイズに基づきます。

2024年4月17日以前に作成されたベクトルストアは2024年末まで無料です。それ以降は次のいずれかになります:

  • 2024年4月17日以降に作成されたRunで少なくとも1回使用されている場合、現行料金(現在は$0.10/GB/日)で課金されます。

  • 2024年4月17日から2024年12月31日の間にRunで一度も使用されていない場合、削除されます。これは、料金改定の告知前に作成したものの未使用だったベクトルストアに対して課金されないようにするためです。

作成できるアシスタントの数に上限はありますか?

組織が作成できるアシスタントの数に上限はありません。

APIでストリーミングは利用できますか?

はい、Assistants APIでストリーミングを利用できます。

Assistants APIでJSONモードは利用できますか?

はい、AssistantsまたはRunオブジェクトの response_format パラメータを通じて、Assistants APIでJSONモードを利用できます。

Assistants APIはサードパーティの関数呼び出しのリクエストも管理しますか?

いいえ。関数呼び出しにより、モデルはツールを選択し、それらに対するリクエストを整形できますが、サードパーティツールへの呼び出しの実行はOpenAIでは管理しません。

OpenAIに送信するデータはどのように扱われますか?

プラットフォームの他の機能と同様に、OpenAI APIに渡されるデータおよびファイルは当社モデルの学習に使用されることはありません。また、必要に応じていつでもデータを削除できます。Assistants APIにアップロードされたデータは、ユーザーが手動で削除するまで無期限に保存されます。

Assistants APIからDALL-Eは利用できますか?

現時点では、DALL-Eは利用できません。

Assistants APIのUIはありますか?

Assistants APIのPlaygroundをご確認ください。左側サイドバーで Assistants ビューになっていること、そしてオンに切り替えたいツールに対応したモデルを使用していることを確認してください。

Playground Assistants view editing MyQuickstartAssistant with gpt-3.5-turbo and Code interpreter enabled

Assistants APIにおけるアシスタントの指示の文字数制限は?

アシスタントが使用するシステム指示の最大長は256,000文字です。

「The server had an error while processing your request. Sorry about that! You can retry your request, or contact us through our help center at help.openai.com if the error persists. 」のようなエラーが出ます。どうすればよいですか?

このエラーが出る場合、プロンプトの設定が正しくない可能性があります。リクエストを何度も再試行しても失敗する場合は、次を試してください:

  1. 関数のようなコマンドは関数として扱うよう、プロンプトの構成を見直してください

  2. プロンプト内のコマンドを、tools の関数として追加してください

File Searchツールがうまく動作しないのはなぜですか?

File Searchツールを使用する際は、max_prompt_tokensを少なくとも20,000に設定することを推奨します。より長い会話やFile Searchとの複数回のやり取りでは、この上限を50,000に増やすか、理想的にはmax_prompt_tokensの制限を完全に外して、最高品質の結果を得ることをご検討ください。詳しくはこちらをご覧ください。

フィードバックはどのように送れますか?

Developer Forumhelp.openai.com のヘルプセンター、またはTwitterの@OpenAIDevsで、ぜひフィードバックをお寄せください。

この記事は役に立ちましたか?