Azure AI Foundry 代理程式服務 （預覽）

回應物件類型的詳細資料。

服務傳回的訊息清單。

第一個 id 的詳細信息。

最後一個 ID 的詳細資料。

告訴是否有更多代理程式。

識別碼，可在 API 端點中參考。

物件類型，一律是執行緒。

執行緒建立時的 Unix 時間戳記 (以秒為單位)。

可附加至物件的索引鍵/值組 (16 個為一組)。 這有助於以結構化格式儲存物件的其他相關資訊。 索引鍵的長度上限為 64 個字元，而值的長度上限為 512 個字元。

識別碼，可在 API 端點中參考。

物件類型，一律是 thread.run。

執行建立時的 Unix 時間戳記 (以秒為單位)。

在此執行過程中執行的執行緒識別碼。

用來執行此執行的助理識別碼。

執行的狀態，可以是佇列、in_progress、requires_action、取消、取消、失敗、已完成或已過期。

繼續執行所需之動作的詳細資料。 如果不需要採取任何動作，則為空值。

與此執行相關聯的最後一個錯誤。 如果沒有錯誤，則為 null。

執行到期時的 Unix 時間戳記 (以秒為單位)。

執行啟動時的 Unix 時間戳記 (以秒為單位)。

取消執行時的 Unix 時間戳記 （以秒為單位）。

執行失敗時的 Unix 時間戳記 (以秒為單位)。

執行完成時的 Unix 時間戳記 (以秒為單位)。

助理用於此執行的模型部署名稱。

助理用於此執行的指示。

助理用於此執行的工具清單。

助理用於此執行的檔案 ID 清單。

可附加至物件的索引鍵/值組 (16 個為一組)。 索引鍵長度上限為 64 個字元，值長度上限為 512 個字元。

控制模型所呼叫的工具 (若有)。 'none' 表示模型不會呼叫任何工具，而是產生訊息。 'auto' 表示模型可以在產生訊息或呼叫工具之間進行選擇。 指定 {'type'： 'file_search'} 或 {'type'： 'function'， 'function'： {'name'： 'my_function'}} 等工具會強制模型呼叫該工具。

在執行過程中指定為已使用的提示權杖數目上限。

在執行過程中指定為已使用的完成權杖數目上限。

與執行相關的使用量統計資料。 如果執行未處於終端狀態 （例如，in_progress、排入佇列） ，則此值將為 Null。

控制執行緒在執行之前截斷執行程的方式。

模型必須輸出的格式。 與 GPT-4 Turbo 和自 gpt-3.5-turbo-1106 以來的所有 GPT-3.5 Turbo 模型相容。

識別碼，可在 API 端點中參考。

物件類型，一律是 thread.run。

執行建立時的 Unix 時間戳記 (以秒為單位)。

在此執行過程中執行的執行緒識別碼。

用來執行此執行的助理識別碼。

執行的狀態，可以是佇列、in_progress、requires_action、取消、取消、失敗、已完成或已過期。

繼續執行所需之動作的詳細資料。 如果不需要採取任何動作，則為空值。

與此執行相關聯的最後一個錯誤。 如果沒有錯誤，則為 null。

執行到期時的 Unix 時間戳記 (以秒為單位)。

執行啟動時的 Unix 時間戳記 (以秒為單位)。

取消執行時的 Unix 時間戳記 （以秒為單位）。

執行失敗時的 Unix 時間戳記 (以秒為單位)。

執行完成時的 Unix 時間戳記 (以秒為單位)。

助理用於此執行的模型部署名稱。

助理用於此執行的指示。

助理用於此執行的工具清單。

助理用於此執行的檔案 ID 清單。

可附加至物件的索引鍵/值組 (16 個為一組)。 索引鍵長度上限為 64 個字元，值長度上限為 512 個字元。

控制模型所呼叫的工具 (若有)。 'none' 表示模型不會呼叫任何工具，而是產生訊息。 'auto' 表示模型可以在產生訊息或呼叫工具之間進行選擇。 指定 {'type'： 'file_search'} 或 {'type'： 'function'， 'function'： {'name'： 'my_function'}} 等工具會強制模型呼叫該工具。

在執行過程中指定為已使用的提示權杖數目上限。

在執行過程中指定為已使用的完成權杖數目上限。

與執行相關的使用量統計資料。 如果執行未處於終端狀態 （例如，in_progress、排入佇列） ，則此值將為 Null。

控制執行緒在執行之前截斷執行程的方式。

模型必須輸出的格式。 與 GPT-4 Turbo 和自 gpt-3.5-turbo-1106 以來的所有 GPT-3.5 Turbo 模型相容。

回應物件類型的詳細資料

服務傳回的訊息清單。

第一個 id 的詳細信息

最後一個 id 的詳細信息

告訴是否有更多代理程式

識別碼，可在 API 端點中參考。

物件類型，一律為小幫手。

助理建立時的 Unix 時間戳記 (以秒為單位)。

助理的名稱。 最大長度為 256 個字元。

助理的描述。 長度上限為 512 個字元。

要使用的模型部署名稱名稱。

助理所使用的系統指示。 長度上限為 32768 個字元。

在助理上啟用的工具清單。 每個助理最多可以有 128 個工具。 工具可以是code_interpreter或功能的類型。 函數描述最多可以是 1,024 個字元。

可附加至物件的索引鍵/值組 (16 個為一組)。 對於以結構化格式儲存其他資訊很有用。 索引鍵長度上限為 64 個字元，值長度上限為 512 個字元。

預設值為 1。 決定要使用的取樣溫度，介於 0 到 2 之間。 0.8 之類的較高值會讓輸出更隨機，而 0.2 之類的較低值會使它更集中且具決定性。

預設值為 1。 核取樣是溫度取樣的替代方法，在此方法中，模型會考慮包含 top_p 機率質量的權杖結果。 因此，0.1 表示只考慮組成前 10% 機率質量的權杖。

指定模型必須輸出的格式。 將此參數設定為 { 'type'： 'json_object' } 會啟用 JSON 模式，確保訊息是有效的 JSON。

助理的工具所使用的一組資源。 工具的類型專用的資源。 例如，code_interpreter 工具需要檔案 ID 清單，而file_search工具需要向量存放區 ID 清單。

模型所執行推理的摘要。 這對於偵錯和瞭解模型的推理程式很有用。 auto、concise 或 detailed 的其中之一。

已取代： 請改用 summary 。

模型所執行推理的摘要。 這對於偵錯和瞭解模型的推理程式很有用。 auto、concise 或 detailed 的其中之一。

物件，指定模型必須輸出的格式。

{ "type": "json_schema" }設定會啟用結構化輸出，以確保模型符合您提供的 JSON 架構。 在結構 化輸出指南中進一步了解。

預設格式為 { "type": "text" }，且沒有其他選項。

不建議使用 gpt-4o 和較新的模型：

設定為 { "type": "json_object" } 可啟用較舊的 JSON 模式，以確保模型產生的訊息為有效的 JSON。 對於支援它的模型，最好使用 。json_schema

可用來產生回應的工具。

要使用的提示範本的唯一識別碼。

提示範本的選用版本。

選用的值對應，用於替換您提示中的變數。 替代值可以是字串或其他回應輸入類型，例如影像或檔案。

可附加至物件的索引鍵/值組 (16 個為一組)。 這很適合用來以結構化格式儲存物件的其他資訊，以及透過 API 或儀錶板查詢物件。

索引鍵是長度上限為64個字元的字串。 值是長度上限為 512 個字元的字串。

要使用的取樣溫度，介於 0 到 2 之間。 0.8 之類的較高值會讓輸出更隨機，而 0.2 之類的較低值會使它更集中且具決定性。 一般會建議改變這個值或 top_p，但不建議同時改變。

核取樣是溫度取樣的替代方法，在此方法中，模型會考慮包含 top_p 機率質量的權杖結果。 因此，0.1 表示只考慮組成前 10% 機率質量的權杖。

一般會建議改變這個值或 temperature，但不建議同時改變。

代表使用者的唯一標識碼，可協助 OpenAI 監視和偵測濫用行為。 深入瞭解。

指定用來處理要求的處理類型。

• 如果設定為 'auto'，則會使用專案設定中設定的服務層級來處理要求。 除非另有設定，否則專案將使用「預設」。
• 如果設定為「預設」，則會使用所選型號的標準定價和效能來處理要求。
• 如果設定為 'flex' 或 'priority'，則會使用對應的服務層級來處理要求。 請聯絡銷售人員 ，以進一步瞭解優先處理。
• 未設定時，預設行為為「自動」。

設定參數後 service_tier ，回應體將包含 service_tier 基於實際用於服務請求的處理模式的值。 此回應值可能與參數中設定的值不同。

介於 0 到 20 之間的整數，其會指定最有可能在每個語彙基元位置傳回的語彙基元數目，每個都有相關聯的對數機率。

先前回應模型的唯一識別碼。 使用這個功能來建立多輪對話。 深入瞭解 交談狀態。

用於生成此回應的模型部署。

僅限於 o 系列模型

推理模型的配置選項。

是否要在背景執行模型回應。 深入瞭解。

可針對回應產生的記號數目上限，包括可見的輸出記號和 推理記號。

回應中可處理的內建工具呼叫總數上限。 此最大數目適用於所有內建工具呼叫，而不是每個個別工具。 系統會忽略模型呼叫工具的任何進一步嘗試。

模型可能會在產生回應時呼叫的工具陣列。 您可以藉由設定 tool_choice 參數來指定要使用的工具。

您可以提供模型的兩種工具類別如下：

• 內建工具：OpenAI 提供的工具，可擴充模型的功能，例如 網頁搜尋 或 檔案搜尋。 進一步了解 內建工具。
• 函式呼叫 （自訂工具）：由您定義的函式，可讓模型呼叫您自己的程式碼。 深入瞭解 函式呼叫。

模型應該如何選取產生回應時要使用的工具（或工具）。 tools請參閱 參數，以瞭解如何指定模型可以呼叫的工具。

關於提示範本及其變數的參考。 深入瞭解。

用於模型回應的截斷策略。

• auto：如果此回應和先前回應的內容超出模型的內容視窗大小，模型會透過在交談中間放置輸入項目來截斷回應以符合內容視窗。
• disabled （預設值）：如果模型回應將超過模型的內容視窗大小，則請求將失敗並顯示 400 錯誤。

此回應的唯一標識碼。

此資源的物件類型 - 一律設定為 response。

回應產生的狀態。 completed、failed、in_progress、cancelled、queued 或 incomplete 的其中之一。

建立此回應時的 Unix 時間戳（以秒為單位）。

當模型無法生成回應時，會返回一個錯誤對象。

回應不完整的原因。

模型所產生的內容項目陣列。

• 陣列中 output 項目的長度和順序取決於模型的回應。
• 您可以考慮使用 output_text SDK 支援的屬性，而不是存取陣列中的output第一個項目，並假設它是assistant包含模型所產生內容的訊息。

插入模型內容中的系統（或開發人員）訊息。

與 一起使用 previous_response_id時，上一個回應中的指示將不會延續到下一個回應。 這可讓您輕鬆地在新回應中交換系統（或開發人員）訊息。

SDK 專屬的便利屬性，其中包含 output_text 陣列中所有 output 項目的彙總文字輸出 (如果有的話)。 Python 和 JavaScript SDK 中支援。

代表令牌使用詳細數據，包括輸入令牌、輸出令牌、輸出令牌明細，以及所使用的令牌總數。

是否允許模型平行執行工具呼叫。

回應的錯誤碼。

人類看得懂的錯誤描述。

輸入令牌的數目。

從快取擷取的權杖數目。 更多關於提示快取的資訊。

輸出令牌的數目。

推理令牌的數目。

使用的令牌總數。

代理程式的名稱。

代理程式的版本識別碼。

選用的值對應，用於替換您提示中的變數。 替代值可以是字串或其他回應輸入類型，例如影像或檔案。

可在執行中使用的工具清單。

可在執行中使用的檔案識別碼清單。