การเรียกใช้โค้ด

ฟีเจอร์การดำเนินการกับโค้ดของ 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 เป็นโมเดลที่มีประสิทธิภาพดีที่สุดจากการทดสอบของเรา