Tool

模型產生回應所需的工具詳細資料。

Tool 是一段程式碼,可讓系統與外部系統互動,以便在模型的知識和範圍外執行動作或一組動作。

JSON 表示法
{
  "functionDeclarations": [
    {
      object (FunctionDeclaration)
    }
  ]
}
欄位
functionDeclarations[]

object (FunctionDeclaration)

選用設定。模型可用的 FunctionDeclarations 清單,可用於函式呼叫。

模型或系統不會執行函式。相反地,系統可能會以 [FunctionCall][content.part.function_call] 形式傳回已定義的函式,並在用戶端以引數執行執行。模型可能會在回應中填入 [FunctionCall][content.part.function_call],藉此決定呼叫這些函式的子集。下一個對話回合可能會包含 [FunctionResponse][content.part.function_response],並為下一個模型回合產生 [content.role]「函式」產生結構定義。

FunctionDeclaration

根據 OpenAPI 3.03 規格所定義的函式宣告的結構化表示法。此宣告中包含函式名稱和參數。這個函式宣告代表程式碼區塊,可用於模型做為 Tool,並由用戶端執行。

JSON 表示法
{
  "name": string,
  "description": string,
  "parameters": {
    object (Schema)
  }
}
欄位
name

string

必要欄位。函式的名稱。必須是 a-z、A-Z、0-9,或包含底線和破折號,長度上限為 63 個字元。

description

string

必要欄位。函式的簡短說明。

parameters

object (Schema)

選用設定。說明這個函式的參數。反映 Open API 3.03 參數物件字串鍵:參數的名稱。參數名稱須區分大小寫。結構定義值:定義參數所用類型的結構定義。