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] עם הקשר ליצירת 'function' [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: שם הפרמטר. שמות הפרמטרים הם תלויי אותיות רישיות. ערך סכימה: הסכימה שמגדירה את הסוג המשמש עבור הפרמטר.