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 يتضمّن هذا التعريف اسم الدالة والمَعلمات. تمثّل FunctionDeclaration هذه مجموعة من الرموز البرمجية يمكن استخدامها باعتبارها 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: اسم المَعلمة. أسماء المَعلمات حسّاسة لحالة الأحرف. قيمة المخطط: المخطط الذي يحدد النوع المستخدم للمعلمة.