Assistants API (プレビュー) スレッド リファレンス
Note
- ファイル検索では、アシスタント 1 つにつき最大 10,000 個のファイルを取り込むことができます。これは以前の 500 倍以上の量です。 これは高速で、マルチスレッド検索による並列クエリをサポートし、強化された再ランク付け機能とクエリの書き換え機能を備えています。
- ベクトル ストアは、API の新しいオブジェクトです。 ファイルがベクトル ストアに追加されると、自動的にそのファイルの解析、チャンク、埋め込みが行われ、検索の準備が整います。 ベクトル ストアは複数のアシスタントやスレッドで共用できるため、ファイル管理と課金がシンプルになります。
tool_choice
パラメーターのサポートが追加されました。これは、特定の実行に関して特定のツール (ファイル検索、コード インタープリター、関数など) の使用を強制できるパラメーターです。
この記事では、新しい Assistants API (プレビュー) に関する Python と REST のリファレンス ドキュメントを提供します。 さらに詳しい手順については、概要ガイドに関する記事をご覧ください。
スレッドを作成する
POST https://YOUR_RESOURCE_NAME.openai.azure.com/openai/threads?api-version=2024-05-01-preview
スレッドを作成します。
要求本文
名前 | タイプ | 必須 | 説明 |
---|---|---|---|
messages |
array | 省略可能 | スレッドを開始するメッセージの一覧。 |
metadata |
map | 省略可能 | オブジェクトにアタッチできる 16 個のキーと値のペアのセット。 これは、オブジェクトに関する追加情報を構造化された形式で格納する場合に役立ちます。 キーの最大長は 64 文字、値の最大長は 512 文字です。 |
返品
例: スレッドの作成要求
from openai import AzureOpenAI
client = AzureOpenAI(
api_key=os.getenv("AZURE_OPENAI_API_KEY"),
api_version="2024-05-01-preview",
azure_endpoint = os.getenv("AZURE_OPENAI_ENDPOINT")
)
empty_thread = client.beta.threads.create()
print(empty_thread)
スレッドを取得する
GET https://YOUR_RESOURCE_NAME.openai.azure.com/openai/threads/{thread_id}?api-version=2024-05-01-preview
スレッドを取得します。
パス パラメーター
パラメーター | タイプ | 必須 | Description |
---|---|---|---|
thread_id |
string | 必須 | 取得するスレッドの ID |
返品
指定された ID と一致するスレッド オブジェクト。
例: スレッドの取得要求
from openai import AzureOpenAI
client = AzureOpenAI(
api_key=os.getenv("AZURE_OPENAI_API_KEY"),
api_version="2024-05-01-preview",
azure_endpoint = os.getenv("AZURE_OPENAI_ENDPOINT")
)
my_thread = client.beta.threads.retrieve("thread_abc123")
print(my_thread)
スレッドを変更する
POST https://YOUR_RESOURCE_NAME.openai.azure.com/openai/threads/{thread_id}?api-version=2024-05-01-preview
スレッドを変更します。
パス パラメーター
パラメーター | タイプ | 必須 | Description |
---|---|---|---|
thread_id |
string | 必須 | 変更するスレッドの ID。 |
要求本文
名前 | タイプ | 必須 | 説明 |
---|---|---|---|
metadata | map | 省略可能 | オブジェクトにアタッチできる 16 個のキーと値のペアのセット。 これは、オブジェクトに関する追加情報を構造化された形式で格納する場合に役立ちます。 キーの最大長は 64 文字、値の最大長は 512 文字です。 |
返品
指定された ID に一致する、変更されたスレッド オブジェクト。
例: スレッドの変更要求
from openai import AzureOpenAI
client = AzureOpenAI(
api_key=os.getenv("AZURE_OPENAI_API_KEY"),
api_version="2024-05-01-preview",
azure_endpoint = os.getenv("AZURE_OPENAI_ENDPOINT")
)
my_updated_thread = client.beta.threads.update(
"thread_abc123",
metadata={
"modified": "true",
"user": "abc123"
}
)
print(my_updated_thread)
スレッドを削除する
DELETE https://YOUR_RESOURCE_NAME.openai.azure.com/openai/threads/{thread_id}?api-version=2024-05-01-preview
スレッドを削除します。
パス パラメーター
パラメーター | タイプ | 必須 | Description |
---|---|---|---|
thread_id |
string | 必須 | 削除するスレッドの ID。 |
返品
削除の状態。
例: スレッドの削除要求
from openai import AzureOpenAI
client = AzureOpenAI(
api_key=os.getenv("AZURE_OPENAI_API_KEY"),
api_version="2024-05-01-preview",
azure_endpoint = os.getenv("AZURE_OPENAI_ENDPOINT")
)
response = client.beta.threads.delete("thread_abc123")
print(response)
スレッド オブジェクト
フィールド | タイプ | 説明 |
---|---|---|
id |
string | API エンドポイントで参照できる識別子。 |
object |
string | オブジェクトの種類。これは常に thread です。 |
created_at |
integer | スレッドが作成されたときの Unix タイムスタンプ (秒単位)。 |
metadata |
map | オブジェクトにアタッチできる 16 個のキーと値のペアのセット。 これは、オブジェクトに関する追加情報を構造化された形式で格納する場合に役立ちます。 キーの最大長は 64 文字、値の最大長は 512 文字です。 |
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示