ฟีเจอร์การเรียกใช้โค้ดของ Gemini API ช่วยให้โมเดลสร้างและเรียกใช้โค้ด Python ได้ และเรียนรู้ผลลัพธ์ซ้ำๆ จนกว่าจะได้เอาต์พุตสุดท้าย คุณสามารถใช้ความสามารถในการดำเนินการกับโค้ดนี้เพื่อสร้างแอปพลิเคชันที่ใช้ประโยชน์จากการให้เหตุผลตามโค้ดและที่สร้างเอาต์พุตข้อความได้ เช่น คุณสามารถใช้การเรียกใช้โค้ดในแอปพลิเคชันที่แก้สมการหรือข้อความประมวลผล
การเรียกใช้โค้ดพร้อมให้ใช้งานทั้งใน AI Studio และ Gemini API ใน AI Studio คุณจะเปิดใช้การเรียกใช้โค้ดได้ในส่วนการตั้งค่าขั้นสูง Gemini API มีการเรียกใช้โค้ดในฐานะเครื่องมือ ซึ่งคล้ายกับการเรียกใช้ฟังก์ชัน หลังจากที่เพิ่มการเรียกใช้โค้ดเป็นเครื่องมือ โมเดลจะตัดสินใจว่าควรใช้เมื่อใด
เริ่มต้นใช้งานการเรียกใช้โค้ด
ดูใน ai.google.dev | เรียกใช้ใน Google Colab | ดูแหล่งที่มาใน GitHub |
ส่วนนี้จะถือว่าคุณติดตั้ง Gemini SDK และกำหนดค่าคีย์ API แล้วดังที่แสดงในquickstart
การเรียกใช้โค้ดและการเรียกใช้ฟังก์ชัน
การเรียกใช้โค้ดและการเรียกใช้ฟังก์ชันเป็นฟีเจอร์ที่คล้ายกัน ดังนี้
- การเรียกใช้โค้ดช่วยให้โมเดลเรียกใช้โค้ดในแบ็กเอนด์ API ในสภาพแวดล้อมที่แยกจากกันและคงที่
- การเรียกฟังก์ชันช่วยให้คุณเรียกใช้ฟังก์ชันที่โมเดลขอในสภาพแวดล้อมใดก็ได้ที่คุณต้องการ
โดยทั่วไป คุณควรใช้การเรียกใช้โค้ดหากจัดการกับกรณีการใช้งานของคุณได้ การดำเนินการโค้ดใช้งานง่ายกว่า (คุณเพียงเปิดใช้) และแก้ไขได้ด้วยคำขอ GenerateContent
เพียงครั้งเดียว (ทำให้เสียค่าใช้จ่ายครั้งเดียว) การเรียกใช้ฟังก์ชันจะขอ GenerateContent
เพิ่มเติมเพื่อส่งเอาต์พุตจากการเรียกใช้ฟังก์ชันแต่ละครั้ง (ทำให้มีการเรียกเก็บเงินหลายครั้ง)
ในกรณีส่วนใหญ่ คุณควรใช้การเรียกฟังก์ชันหากมีฟังก์ชันของตัวเองที่ต้องการเรียกใช้ภายในเครื่อง และควรใช้การเรียกใช้โค้ดหากต้องการให้ API เขียนและเรียกใช้โค้ด Python แทนคุณและส่งคืนผลลัพธ์
การเรียกเก็บเงิน
โดยไม่มีค่าใช้จ่ายเพิ่มเติมสำหรับการเปิดใช้การรันโค้ดจาก Gemini API ระบบจะเรียกเก็บเงินจากคุณที่อัตราปัจจุบันของโทเค็นอินพุตและเอาต์พุต
สิ่งอื่นที่ควรทราบเกี่ยวกับการเรียกเก็บเงินสำหรับการเรียกใช้โค้ดมีดังนี้
- ระบบจะเรียกเก็บเงินจากคุณเพียงครั้งเดียวสำหรับโทเค็นอินพุตที่คุณส่งไปยังโมเดล และระบบจะเรียกเก็บเงินสำหรับโทเค็นเอาต์พุตสุดท้ายที่โมเดลส่งกลับมา
- โทเค็นที่แสดงถึงโค้ดที่สร้างขึ้นจะนับเป็นโทเค็นเอาต์พุต
- ผลลัพธ์ของการเรียกใช้โค้ดจะนับเป็นโทเค็นเอาต์พุตด้วย
ข้อจำกัด
- โมเดลนี้สามารถสร้างและเรียกใช้โค้ดได้เท่านั้น และไม่สามารถแสดงผลอาร์ติแฟกต์อื่นๆ เช่น ไฟล์สื่อ
- ฟีเจอร์นี้ไม่รองรับไฟล์ I/O หรือกรณีการใช้งานที่เกี่ยวข้องกับเอาต์พุตที่ไม่ใช่ข้อความ (เช่น พล็อตข้อมูล)
- การเรียกใช้โค้ดจะทํางานได้สูงสุด 30 วินาทีก่อนที่จะหมดเวลา
- ในบางกรณี การเปิดใช้การเรียกใช้โค้ดอาจทำให้เกิดการถดถอยในส่วนอื่นๆ ของเอาต์พุตโมเดล (เช่น การเขียนเรื่องราว)
- โมเดลต่างๆ สามารถใช้การเรียกใช้โค้ดได้สำเร็จแตกต่างกันไป Gemini 1.5 Pro เป็นโมเดลที่มีประสิทธิภาพดีที่สุด จากการทดสอบของเรา