เมื่อใช้ฟีเจอร์การเรียกใช้ฟังก์ชัน Gemini API คุณจะสามารถระบุฟังก์ชันที่กำหนดเอง ของโมเดล โมเดลไม่ได้เรียกใช้ฟังก์ชันเหล่านี้โดยตรง แต่สร้างเอาต์พุตที่มีโครงสร้างซึ่งระบุชื่อฟังก์ชันและอาร์กิวเมนต์ที่แนะนำแทน จากนั้นคุณสามารถใช้ชื่อฟังก์ชันและอาร์กิวเมนต์เพื่อเรียกใช้ API ภายนอก และรวมเอาต์พุต API ที่ได้ในการค้นหาเพิ่มเติมไปยังโมเดล ซึ่งจะช่วยให้โมเดลให้คำตอบที่ครอบคลุมมากขึ้นและดำเนินการเพิ่มเติมได้
การเรียกใช้ฟังก์ชันช่วยให้ผู้ใช้โต้ตอบกับข้อมูลและบริการแบบเรียลไทม์ได้ เช่น ฐานข้อมูล ระบบการจัดการลูกค้าสัมพันธ์ และที่เก็บเอกสาร นอกจากนี้ ฟีเจอร์นี้ยังช่วยเพิ่มความสามารถในการให้คำตอบที่เกี่ยวข้องและตามบริบทของโมเดลด้วย การเรียกฟังก์ชันเหมาะสำหรับการโต้ตอบกับภายนอก ระบบต่างๆ หากกรณีการใช้งานของคุณจำเป็นต้องใช้โมเดลเพื่อทำการคำนวณ แต่ไม่ได้ใช้ เกี่ยวข้องกับระบบหรือ API ภายนอก คุณควรพิจารณาใช้ การเรียกใช้โค้ดแทน
สำหรับตัวอย่างการเรียกใช้ฟังก์ชันที่ใช้ได้ โปรดดู "บ็อตเบา" Notebook
วิธีการทำงานของการเรียกฟังก์ชัน
คุณใช้ฟีเจอร์การเรียกฟังก์ชันโดยการเพิ่มข้อมูลคำค้นหาที่มีโครงสร้างซึ่งอธิบาย การเขียนโปรแกรมอินเทอร์เฟซที่เรียกว่าการประกาศฟังก์ชันไปยังพรอมต์ของโมเดล การประกาศฟังก์ชันจะระบุชื่อฟังก์ชัน API, อธิบายวัตถุประสงค์ของฟังก์ชัน, พารามิเตอร์ที่รองรับ และคำอธิบายพารามิเตอร์เหล่านั้น หลังจากคุณส่งรายการประกาศฟังก์ชันในการค้นหาไปยังโมเดลแล้ว โมเดลจะวิเคราะห์ประกาศฟังก์ชันและการค้นหาที่เหลือเพื่อพิจารณาวิธีใช้ API ที่ประกาศเพื่อตอบสนองต่อคำขอ
จากนั้นโมเดลจะแสดงออบเจ็กต์ใน สคีมาที่เข้ากันได้กับ OpenAPI ระบุวิธีเรียกใช้ฟังก์ชันที่ประกาศอย่างน้อย 1 รายการเพื่อตอบกลับ สำหรับคำถามของผู้ใช้ จากนั้นคุณสามารถใช้การเรียกฟังก์ชันที่แนะนำ เรียก API จริง รับการตอบกลับ และแสดงการตอบสนองนั้นให้กับ ผู้ใช้หรือดำเนินการเพิ่มเติม โปรดทราบว่าโมเดลไม่ได้เรียกใช้ฟังก์ชันที่ประกาศ ให้ใช้พารามิเตอร์ออบเจ็กต์สคีมาที่แสดงผลเพื่อ เรียกใช้ฟังก์ชัน Gemini API ยังรองรับการเรียกใช้ฟังก์ชันพร้อมกันด้วย โดย โมเดลนี้แนะนำให้เรียกใช้ฟังก์ชัน API หลายครั้งโดยอิงตามคำขอรายการเดียว
การประกาศฟังก์ชัน
เมื่อใช้การเรียกฟังก์ชันในพรอมต์ คุณกำลังสร้างออบเจ็กต์ tools ซึ่งมี function declarations อย่างน้อย 1 รายการ คุณกําหนดฟังก์ชันโดยใช้ JSON โดยเฉพาะกับชุดย่อยที่เลือกของรูปแบบสคีมา OpenAPI การประกาศฟังก์ชันเดียวอาจมีพารามิเตอร์ต่อไปนี้
name(สตริง): ตัวระบุที่ไม่ซ้ำกันสำหรับฟังก์ชันภายในการเรียก APIdescription(สตริง): คำอธิบายโดยละเอียดเกี่ยวกับฟังก์ชัน และความสามารถparameters(ออบเจ็กต์): กําหนดข้อมูลอินพุตที่จําเป็นสําหรับฟังก์ชันtype(สตริง): ระบุประเภทข้อมูลโดยรวม เช่นobjectproperties(ออบเจ็กต์): แสดงรายการพารามิเตอร์แต่ละรายการ โดยแต่ละรายการมีสิ่งต่อไปนี้type(สตริง): ประเภทข้อมูลของพารามิเตอร์ เช่นstring,integer,booleandescription(สตริง): คำอธิบายที่ชัดเจนเกี่ยวกับพารามิเตอร์ วัตถุประสงค์และรูปแบบที่คาดไว้
required(อาร์เรย์): อาร์เรย์สตริงที่แสดงรายการชื่อพารามิเตอร์ที่จําเป็นต่อการทำงานของฟังก์ชัน
ดูตัวอย่างโค้ดของการประกาศฟังก์ชันโดยใช้คําสั่ง cURL ได้ที่ตัวอย่างการเรียกใช้ฟังก์ชัน ตัวอย่างเช่น การสร้างการประกาศฟังก์ชันโดยใช้ Gemini API SDK โปรดดู บทแนะนำการเรียกใช้ฟังก์ชัน
แนวทางปฏิบัติแนะนำสำหรับการประกาศฟังก์ชัน
การกําหนดฟังก์ชันอย่างถูกต้องเป็นสิ่งจําเป็นเมื่อผสานรวมฟังก์ชันเหล่านั้นเข้ากับคําขอ ฟังก์ชันแต่ละรายการใช้พารามิเตอร์ที่เฉพาะเจาะจงซึ่งควบคุมลักษณะการทํางานและการโต้ตอบกับโมเดล รายการต่อไปนี้ให้คําแนะนําเกี่ยวกับการกําหนดพารามิเตอร์ของฟังก์ชันแต่ละรายการในfunctions_declarations
อาร์เรย์
name: ใช้ชื่อที่สื่อความหมายชัดเจนโดยไม่มีเว้นวรรค จุด (.) หรือเครื่องหมายขีดกลาง (-) แต่ให้ใช้อักขระขีดล่าง (_) หรือตัวพิมพ์ใหญ่ขึ้นต้นdescription: ระบุคำอธิบายฟังก์ชันที่ละเอียด ชัดเจน และเฉพาะเจาะจง พร้อมตัวอย่างหากจำเป็น เช่น ใช้find theaters based on location and optionally movie title that is currently playing in theaters.แทนfind theatersหลีกเลี่ยงคำอธิบายที่กว้างเกินไปหรือคลุมเครือpropertiestype: ใช้พารามิเตอร์ที่พิมพ์อย่างเข้มงวดเพื่อลด ความไม่สมเหตุสมผลของโมเดล เช่น หากค่าพารามิเตอร์มาจากชุดที่จำกัด ให้ใช้ช่องenumแทนการระบุค่าในคำอธิบาย (เช่น"type": "enum", "values": ["now_playing", "upcoming"]) หาก จะเป็นจำนวนเต็มเสมอ ให้กำหนดประเภทเป็นintegerแทนที่จะแสดงnumberpropertiesdescription: แสดงตัวอย่างที่เป็นรูปธรรมและข้อจำกัด เช่น ใช้The city and state, e.g. San Francisco, CA or a zip code e.g. 95616แทนthe location to search
ดูแนวทางปฏิบัติแนะนำเพิ่มเติมเมื่อใช้การเรียกใช้ฟังก์ชันได้ที่ แนวทางปฏิบัติแนะนำ
โหมดการเรียกฟังก์ชัน
คุณสามารถใช้พารามิเตอร์การเรียกใช้ฟังก์ชัน mode เพื่อแก้ไขการดำเนินการได้
ลักษณะการทำงานของฟีเจอร์ โดยจะมี 3 โหมดให้เลือกดังนี้
AUTO: ลักษณะการทํางานเริ่มต้นของรูปแบบ โมเดลจะตัดสินใจว่าจะคาดการณ์การเรียกใช้ฟังก์ชันหรือการตอบกลับด้วยภาษาธรรมชาติANY: โมเดลถูกจํากัดให้คาดการณ์การเรียกฟังก์ชันเสมอ หากไม่ได้ระบุallowed_function_namesโมเดลจะเลือกจากประกาศฟังก์ชันทั้งหมดที่ใช้ได้ หากระบุallowed_function_namesไว้ โมเดลจะเลือกจากชุดฟังก์ชันที่อนุญาตNONE: โมเดลจะไม่คาดการณ์การเรียกใช้ฟังก์ชัน ในกรณีนี้ ลักษณะการทํางานของโมเดลจะเหมือนกับในกรณีที่คุณไม่ได้ส่งประกาศฟังก์ชันใดๆ
ระบบรองรับการใช้โหมด ANY ("การเรียกใช้ฟังก์ชันแบบบังคับ") สำหรับรุ่น Gemini 1.5 Pro และ Gemini 1.5 Flash เท่านั้น
นอกจากนี้ คุณยังส่งชุด allowed_function_names ซึ่งจะจำกัดฟังก์ชันที่โมเดลจะเรียกใช้ได้อีกด้วย คุณควรใส่ allowed_function_names เฉพาะเมื่อโหมดเป็น ANY ชื่อฟังก์ชันควรตรงกับ
ชื่อการประกาศฟังก์ชัน เมื่อตั้งค่าโหมดเป็น ANY และตั้งค่า allowed_function_names แล้ว โมเดลจะคาดคะเนการเรียกใช้ฟังก์ชันจากชุดชื่อฟังก์ชันที่ระบุ
ข้อมูลโค้ดต่อไปนี้จาก
คำขอตัวอย่างแสดงวิธี
ตั้งค่า mode เป็น ANY และระบุรายการฟังก์ชันที่อนุญาต ดังนี้
"tool_config": {
"function_calling_config": {
"mode": "ANY",
"allowed_function_names": ["find_theaters", "get_showtimes"]
},
}
ตัวอย่างการเรียกใช้ฟังก์ชัน
ส่วนนี้จะแสดงตัวอย่างพรอมต์สำหรับการเรียกใช้ฟังก์ชันโดยใช้คำสั่ง cURL ตัวอย่างเช่น สถานการณ์จำลองที่เลี้ยวเพียงครั้งเดียวและหลายเลี้ยว โหมดการโทรด้วยฟังก์ชันต่างๆ
เมื่อใช้คำสั่ง cURL กับฟีเจอร์นี้ ฟังก์ชันและพารามิเตอร์
จะรวมอยู่ในองค์ประกอบ tools การประกาศฟังก์ชันแต่ละรายการใน
เอลิเมนต์ tools มีชื่อฟังก์ชัน และคุณระบุพารามิเตอร์โดยใช้
สคีมาที่เข้ากันได้กับ OpenAPI
และคำอธิบายฟังก์ชัน
ตัวอย่างแบบเลี้ยวเดียว
การรับส่งข้อมูลแบบครั้งเดียวคือเมื่อคุณเรียกใช้โมเดลภาษาเพียงครั้งเดียว ด้วยการเรียกฟังก์ชัน กรณีการใช้งานแบบผลัดเดียวอาจเป็นเมื่อคุณให้ภาษาธรรมชาติกับโมเดล และรายการฟังก์ชัน ในกรณีนี้ โมเดลจะใช้การประกาศฟังก์ชัน ซึ่งประกอบด้วยชื่อฟังก์ชัน พารามิเตอร์ และคําอธิบาย เพื่อคาดคะเนว่าควรเรียกใช้ฟังก์ชันใดและควรใช้อาร์กิวเมนต์ใดในการเรียกใช้
ตัวอย่าง curl ต่อไปนี้เป็นตัวอย่างการส่งคำอธิบายของฟังก์ชันที่แสดงผลข้อมูลเกี่ยวกับสถานที่ที่ภาพยนตร์เล่น คำขอมีประกาศฟังก์ชันหลายรายการ เช่น find_movies และ find_theaters
คำขอตัวอย่างการเรียกฟังก์ชันแบบเทิร์นเดียว
curl https://generativelanguage.googleapis.com/v1beta/models/gemini-pro:generateContent?key=$API_KEY \
-H 'Content-Type: application/json' \
-d '{
"contents": {
"role": "user",
"parts": {
"text": "Which theaters in Mountain View show Barbie movie?"
}
},
"tools": [
{
"function_declarations": [
{
"name": "find_movies",
"description": "find movie titles currently playing in theaters based on any description, genre, title words, etc.",
"parameters": {
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "The city and state, e.g. San Francisco, CA or a zip code e.g. 95616"
},
"description": {
"type": "string",
"description": "Any kind of description including category or genre, title words, attributes, etc."
}
},
"required": [
"description"
]
}
},
{
"name": "find_theaters",
"description": "find theaters based on location and optionally movie title which is currently playing in theaters",
"parameters": {
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "The city and state, e.g. San Francisco, CA or a zip code e.g. 95616"
},
"movie": {
"type": "string",
"description": "Any movie title"
}
},
"required": [
"location"
]
}
},
{
"name": "get_showtimes",
"description": "Find the start times for movies playing in a specific theater",
"parameters": {
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "The city and state, e.g. San Francisco, CA or a zip code e.g. 95616"
},
"movie": {
"type": "string",
"description": "Any movie title"
},
"theater": {
"type": "string",
"description": "Name of the theater"
},
"date": {
"type": "string",
"description": "Date for requested showtime"
}
},
"required": [
"location",
"movie",
"theater",
"date"
]
}
}
]
}
]
}'
การตอบกลับสําหรับตัวอย่าง curl นี้อาจคล้ายกับตัวอย่างต่อไปนี้
การตอบกลับตัวอย่างการเรียกฟังก์ชันแบบเทิร์นเดียวของ curl
[{
"candidates": [
{
"content": {
"parts": [
{
"functionCall": {
"name": "find_theaters",
"args": {
"movie": "Barbie",
"location": "Mountain View, CA"
}
}
}
]
},
"finishReason": "STOP",
"safetyRatings": [
{
"category": "HARM_CATEGORY_HARASSMENT",
"probability": "NEGLIGIBLE"
},
{
"category": "HARM_CATEGORY_HATE_SPEECH",
"probability": "NEGLIGIBLE"
},
{
"category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
"probability": "NEGLIGIBLE"
},
{
"category": "HARM_CATEGORY_DANGEROUS_CONTENT",
"probability": "NEGLIGIBLE"
}
]
}
],
"usageMetadata": {
"promptTokenCount": 9,
"totalTokenCount": 9
}
}]
ตัวอย่างแบบเลี้ยวเดียวโดยใช้โหมดใดก็ได้
ตัวอย่างการใช้ Curl ต่อไปนี้คล้ายกับตัวอย่างการเลี้ยวครั้งเดียว แต่ตั้งค่าmode เป็น ANY
"tool_config": {
"function_calling_config": {
"mode": "ANY"
},
}
การเรียกฟังก์ชันแบบเทิร์นเดียวโดยใช้โหมดใดก็ได้ (คำขอ)
curl https://generativelanguage.googleapis.com/v1beta/models/gemini-pro:generateContent?key=$API_KEY \
-H 'Content-Type: application/json' \
-d '{
"contents": {
"role": "user",
"parts": {
"text": "What movies are showing in North Seattle tonight?"
}
},
"tools": [
{
"function_declarations": [
{
"name": "find_movies",
"description": "find movie titles currently playing in theaters based on any description, genre, title words, etc.",
"parameters": {
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "The city and state, e.g. San Francisco, CA or a zip code e.g. 95616"
},
"description": {
"type": "string",
"description": "Any kind of description including category or genre, title words, attributes, etc."
}
},
"required": [
"description"
]
}
},
{
"name": "find_theaters",
"description": "find theaters based on location and optionally movie title which is currently playing in theaters",
"parameters": {
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "The city and state, e.g. San Francisco, CA or a zip code e.g. 95616"
},
"movie": {
"type": "string",
"description": "Any movie title"
}
},
"required": [
"location"
]
}
},
{
"name": "get_showtimes",
"description": "Find the start times for movies playing in a specific theater",
"parameters": {
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "The city and state, e.g. San Francisco, CA or a zip code e.g. 95616"
},
"movie": {
"type": "string",
"description": "Any movie title"
},
"theater": {
"type": "string",
"description": "Name of the theater"
},
"date": {
"type": "string",
"description": "Date for requested showtime"
}
},
"required": [
"location",
"movie",
"theater",
"date"
]
}
}
]
}
],
"tool_config": {
"function_calling_config": {
"mode": "ANY"
},
}
}'
คำตอบอาจคล้ายกับข้อความต่อไปนี้
การเรียกฟังก์ชันแบบเทิร์นเดียวโดยใช้โหมดใดก็ได้ (การตอบกลับ)
{
"candidates": [
{
"content": {
"parts": [
{
"functionCall": {
"name": "find_movies",
"args": {
"description": "",
"location": "North Seattle, WA"
}
}
}
],
"role": "model"
},
"finishReason": "STOP",
"index": 0,
"safetyRatings": [
{
"category": "HARM_CATEGORY_DANGEROUS_CONTENT",
"probability": "NEGLIGIBLE"
},
{
"category": "HARM_CATEGORY_HARASSMENT",
"probability": "NEGLIGIBLE"
},
{
"category": "HARM_CATEGORY_HATE_SPEECH",
"probability": "NEGLIGIBLE"
},
{
"category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
"probability": "NEGLIGIBLE"
}
]
}
],
"promptFeedback": {
"safetyRatings": [
{
"category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
"probability": "NEGLIGIBLE"
},
{
"category": "HARM_CATEGORY_HATE_SPEECH",
"probability": "NEGLIGIBLE"
},
{
"category": "HARM_CATEGORY_HARASSMENT",
"probability": "NEGLIGIBLE"
},
{
"category": "HARM_CATEGORY_DANGEROUS_CONTENT",
"probability": "NEGLIGIBLE"
}
]
}
}
ตัวอย่างการเลี้ยวเดียวโดยใช้โหมด "ใดก็ได้" และฟังก์ชันที่อนุญาต
ตัวอย่าง curl ต่อไปนี้ดูคล้ายกับ
แบบผลัดเดียว แต่กลับ
โหมดเป็น ANY และมีรายการที่อนุญาต
ฟังก์ชัน:
"tool_config": {
"function_calling_config": {
"mode": "ANY",
"allowed_function_names": ["find_theaters", "get_showtimes"]
},
}
การเรียกฟังก์ชันแบบเลี้ยวเดียวโดยใช้โหมดใดก็ได้และฟังก์ชันที่อนุญาต (คำขอ)
curl https://generativelanguage.googleapis.com/v1beta/models/gemini-pro:generateContent?key=$API_KEY \
-H 'Content-Type: application/json' \
-d '{
"contents": {
"role": "user",
"parts": {
"text": "What movies are showing in North Seattle tonight?"
}
},
"tools": [
{
"function_declarations": [
{
"name": "find_movies",
"description": "find movie titles currently playing in theaters based on any description, genre, title words, etc.",
"parameters": {
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "The city and state, e.g. San Francisco, CA or a zip code e.g. 95616"
},
"description": {
"type": "string",
"description": "Any kind of description including category or genre, title words, attributes, etc."
}
},
"required": [
"description"
]
}
},
{
"name": "find_theaters",
"description": "find theaters based on location and optionally movie title which is currently playing in theaters",
"parameters": {
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "The city and state, e.g. San Francisco, CA or a zip code e.g. 95616"
},
"movie": {
"type": "string",
"description": "Any movie title"
}
},
"required": [
"location"
]
}
},
{
"name": "get_showtimes",
"description": "Find the start times for movies playing in a specific theater",
"parameters": {
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "The city and state, e.g. San Francisco, CA or a zip code e.g. 95616"
},
"movie": {
"type": "string",
"description": "Any movie title"
},
"theater": {
"type": "string",
"description": "Name of the theater"
},
"date": {
"type": "string",
"description": "Date for requested showtime"
}
},
"required": [
"location",
"movie",
"theater",
"date"
]
}
}
]
}
],
"tool_config": {
"function_calling_config": {
"mode": "ANY",
"allowed_function_names": ["find_theaters", "get_showtimes"]
},
}
}'
โมเดลไม่สามารถคาดการณ์ฟังก์ชัน find_movies เนื่องจากไม่ได้อยู่ในรายการฟังก์ชันที่อนุญาต จึงคาดการณ์ฟังก์ชันอื่นแทน คำตอบ
อาจมีลักษณะคล้ายกับข้อความต่อไปนี้
การเรียกฟังก์ชันแบบเทิร์นเดียวโดยใช้โหมด "ใดก็ได้" และฟังก์ชันที่อนุญาต (การตอบกลับ)
{
"candidates": [
{
"content": {
"parts": [
{
"functionCall": {
"name": "find_theaters",
"args": {
"location": "North Seattle, WA",
"movie": null
}
}
}
],
"role": "model"
},
"finishReason": "STOP",
"index": 0,
"safetyRatings": [
{
"category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
"probability": "NEGLIGIBLE"
},
{
"category": "HARM_CATEGORY_HARASSMENT",
"probability": "NEGLIGIBLE"
},
{
"category": "HARM_CATEGORY_HATE_SPEECH",
"probability": "NEGLIGIBLE"
},
{
"category": "HARM_CATEGORY_DANGEROUS_CONTENT",
"probability": "NEGLIGIBLE"
}
]
}
],
"promptFeedback": {
"safetyRatings": [
{
"category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
"probability": "NEGLIGIBLE"
},
{
"category": "HARM_CATEGORY_HATE_SPEECH",
"probability": "NEGLIGIBLE"
},
{
"category": "HARM_CATEGORY_HARASSMENT",
"probability": "NEGLIGIBLE"
},
{
"category": "HARM_CATEGORY_DANGEROUS_CONTENT",
"probability": "NEGLIGIBLE"
}
]
}
}
ตัวอย่างหลายเลี้ยว
คุณสามารถใช้สถานการณ์การเรียกใช้ฟังก์ชันแบบหลายเลี้ยวได้โดยทำดังต่อไปนี้
- รับการตอบกลับการเรียกฟังก์ชันโดยเรียกใช้โมเดลภาษา นี่คือทางเลี้ยวแรก
- เรียกใช้โมเดลภาษาโดยใช้การตอบกลับการเรียกใช้ฟังก์ชันตั้งแต่เลี้ยวแรก และการตอบสนองของฟังก์ชันที่คุณได้รับจากการเรียกใช้ฟังก์ชันนั้น นี่คือ รอบที่ 2
การตอบสนองจากรอบที่ 2 จะสรุปผลลัพธ์เพื่อตอบ ในเลี้ยวแรก หรือมีการเรียกฟังก์ชันที่สองที่คุณสามารถใช้เพื่อดู ข้อมูลเพิ่มเติมสำหรับคำถามของคุณ
หัวข้อนี้มีตัวอย่าง Curl แบบมัลติเทิร์น 2 รายการ:
- ตัวอย่าง Curl ที่ใช้การตอบสนองของฟังก์ชันจากเลี้ยวก่อนหน้า
- ตัวอย่าง Curl ที่เรียกใช้โมเดลภาษาหลายครั้ง
ใช้คำตอบจากการเลี้ยวก่อนหน้า
ตัวอย่าง curl ต่อไปนี้เรียกใช้ฟังก์ชันและอาร์กิวเมนต์ที่แสดงผลโดย ตัวอย่างการเปลี่ยนครั้งเดียวก่อนหน้านี้ เพื่อรับคำตอบ เมธอดและพารามิเตอร์ ซึ่งแสดงผลโดยตัวอย่างแบบเลี้ยวครั้งเดียวนั้นอยู่ใน JSON นี้
"functionCall": {
"name": "find_theaters",
"args": {
"movie": "Barbie",
"location": "Mountain View, CA"
}
}
ตัวอย่างคำขอ curl สำหรับฟังก์ชันหลายเลี้ยว
curl https://generativelanguage.googleapis.com/v1beta/models/gemini-pro:generateContent?key=$API_KEY \
-H 'Content-Type: application/json' \
-d '{
"contents": [{
"role": "user",
"parts": [{
"text": "Which theaters in Mountain View show Barbie movie?"
}]
}, {
"role": "model",
"parts": [{
"functionCall": {
"name": "find_theaters",
"args": {
"location": "Mountain View, CA",
"movie": "Barbie"
}
}
}]
}, {
"role": "user",
"parts": [{
"functionResponse": {
"name": "find_theaters",
"response": {
"name": "find_theaters",
"content": {
"movie": "Barbie",
"theaters": [{
"name": "AMC Mountain View 16",
"address": "2000 W El Camino Real, Mountain View, CA 94040"
}, {
"name": "Regal Edwards 14",
"address": "245 Castro St, Mountain View, CA 94040"
}]
}
}
}
}]
}],
"tools": [{
"functionDeclarations": [{
"name": "find_movies",
"description": "find movie titles currently playing in theaters based on any description, genre, title words, etc.",
"parameters": {
"type": "OBJECT",
"properties": {
"location": {
"type": "STRING",
"description": "The city and state, e.g. San Francisco, CA or a zip code e.g. 95616"
},
"description": {
"type": "STRING",
"description": "Any kind of description including category or genre, title words, attributes, etc."
}
},
"required": ["description"]
}
}, {
"name": "find_theaters",
"description": "find theaters based on location and optionally movie title which is currently playing in theaters",
"parameters": {
"type": "OBJECT",
"properties": {
"location": {
"type": "STRING",
"description": "The city and state, e.g. San Francisco, CA or a zip code e.g. 95616"
},
"movie": {
"type": "STRING",
"description": "Any movie title"
}
},
"required": ["location"]
}
}, {
"name": "get_showtimes",
"description": "Find the start times for movies playing in a specific theater",
"parameters": {
"type": "OBJECT",
"properties": {
"location": {
"type": "STRING",
"description": "The city and state, e.g. San Francisco, CA or a zip code e.g. 95616"
},
"movie": {
"type": "STRING",
"description": "Any movie title"
},
"theater": {
"type": "STRING",
"description": "Name of the theater"
},
"date": {
"type": "STRING",
"description": "Date for requested showtime"
}
},
"required": ["location", "movie", "theater", "date"]
}
}]
}]
}'
การตอบสนองต่อตัวอย่าง curl นี้ประกอบด้วยผลลัพธ์ของการเรียกใช้ฟิลด์
find_theaters วิธี การตอบกลับอาจมีลักษณะคล้ายกับข้อความต่อไปนี้
ตัวอย่างการตอบกลับการเรียกฟังก์ชันหลายรอบของ curl
{
"candidates": [
{
"content": {
"parts": [
{
"text": " OK. Barbie is showing in two theaters in Mountain View, CA: AMC Mountain View 16 and Regal Edwards 14."
}
]
}
}
],
"usageMetadata": {
"promptTokenCount": 9,
"candidatesTokenCount": 27,
"totalTokenCount": 36
}
}
เรียกใช้โมเดลหลายครั้ง
ตัวอย่าง cURL ต่อไปนี้เรียกใช้โมเดล Generative AI หลายครั้ง ฟังก์ชัน ทุกครั้งที่โมเดลเรียกใช้ฟังก์ชัน โมเดลจะใช้ฟังก์ชันอื่นเพื่อตอบคำถามของผู้ใช้ที่แตกต่างกันในคำขอได้
ตัวอย่างคำขอ curl สำหรับฟังก์ชันหลายเลี้ยว
curl https://generativelanguage.googleapis.com/v1beta/models/gemini-pro:generateContent?key=$API_KEY \
-H 'Content-Type: application/json' \
-d '{
"contents": [{
"role": "user",
"parts": [{
"text": "Which theaters in Mountain View show Barbie movie?"
}]
}, {
"role": "model",
"parts": [{
"functionCall": {
"name": "find_theaters",
"args": {
"location": "Mountain View, CA",
"movie": "Barbie"
}
}
}]
}, {
"role": "user",
"parts": [{
"functionResponse": {
"name": "find_theaters",
"response": {
"name": "find_theaters",
"content": {
"movie": "Barbie",
"theaters": [{
"name": "AMC Mountain View 16",
"address": "2000 W El Camino Real, Mountain View, CA 94040"
}, {
"name": "Regal Edwards 14",
"address": "245 Castro St, Mountain View, CA 94040"
}]
}
}
}
}]
},
{
"role": "model",
"parts": [{
"text": " OK. Barbie is showing in two theaters in Mountain View, CA: AMC Mountain View 16 and Regal Edwards 14."
}]
},{
"role": "user",
"parts": [{
"text": "Can we recommend some comedy movies on show in Mountain View?"
}]
}],
"tools": [{
"functionDeclarations": [{
"name": "find_movies",
"description": "find movie titles currently playing in theaters based on any description, genre, title words, etc.",
"parameters": {
"type": "OBJECT",
"properties": {
"location": {
"type": "STRING",
"description": "The city and state, e.g. San Francisco, CA or a zip code e.g. 95616"
},
"description": {
"type": "STRING",
"description": "Any kind of description including category or genre, title words, attributes, etc."
}
},
"required": ["description"]
}
}, {
"name": "find_theaters",
"description": "find theaters based on location and optionally movie title which is currently playing in theaters",
"parameters": {
"type": "OBJECT",
"properties": {
"location": {
"type": "STRING",
"description": "The city and state, e.g. San Francisco, CA or a zip code e.g. 95616"
},
"movie": {
"type": "STRING",
"description": "Any movie title"
}
},
"required": ["location"]
}
}, {
"name": "get_showtimes",
"description": "Find the start times for movies playing in a specific theater",
"parameters": {
"type": "OBJECT",
"properties": {
"location": {
"type": "STRING",
"description": "The city and state, e.g. San Francisco, CA or a zip code e.g. 95616"
},
"movie": {
"type": "STRING",
"description": "Any movie title"
},
"theater": {
"type": "STRING",
"description": "Name of the theater"
},
"date": {
"type": "STRING",
"description": "Date for requested showtime"
}
},
"required": ["location", "movie", "theater", "date"]
}
}]
}]
}'
ตัวอย่างการตอบสนองด้วย Curl สำหรับฟังก์ชันหลายเลี้ยว
[{
"candidates": [
{
"content": {
"parts": [
{
"functionCall": {
"name": "find_movies",
"args": {
"description": "comedy",
"location": "Mountain View, CA"
}
}
}
]
},
"finishReason": "STOP",
"safetyRatings": [
{
"category": "HARM_CATEGORY_HARASSMENT",
"probability": "NEGLIGIBLE"
},
{
"category": "HARM_CATEGORY_HATE_SPEECH",
"probability": "NEGLIGIBLE"
},
{
"category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
"probability": "NEGLIGIBLE"
},
{
"category": "HARM_CATEGORY_DANGEROUS_CONTENT",
"probability": "NEGLIGIBLE"
}
]
}
],
"usageMetadata": {
"promptTokenCount": 48,
"totalTokenCount": 48
}
}
]
แนวทางปฏิบัติแนะนำ
ทําตามแนวทางปฏิบัติแนะนําเหล่านี้เพื่อปรับปรุงความแม่นยำและความน่าเชื่อถือของคําเรียกฟังก์ชัน
พรอมต์ของผู้ใช้
โปรดใส่รายละเอียดต่อไปนี้ไว้ข้างหน้าคําค้นหาของผู้ใช้เพื่อให้ได้ผลลัพธ์ที่ดีที่สุด
- บริบทเพิ่มเติมสำหรับโมเดล ตัวอย่างเช่น
You are a movie API assistant to help users find movies and showtimes based on their preferences. - รายละเอียดหรือวิธีการและเวลาในการใช้ฟังก์ชัน เช่น
Don't make assumptions on showtimes. Always use a future date for showtimes. - วิธีการถามคำถามเพื่อความชัดเจนหากคำถามของผู้ใช้ไม่ชัดเจน สำหรับ
ตัวอย่างเช่น
Ask clarifying questions if not enough information is available to complete the request.
พารามิเตอร์การสุ่มตัวอย่าง
สำหรับพารามิเตอร์อุณหภูมิ ให้ใช้ 0 หรือค่าอื่นระดับต่ำ ซึ่งจะบอกให้โมเดลสร้างผลลัพธ์ที่มั่นใจมากขึ้นและลดภาพหลอน
การเรียก API
หากโมเดลเสนอการเรียกใช้ฟังก์ชันที่จะส่งคำสั่งซื้อ อัปเดตฐานข้อมูล หรือมีผลกระทบที่สำคัญ ให้ตรวจสอบการเรียกใช้ฟังก์ชันกับผู้ใช้ก่อนดำเนินการ