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