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

ฟีเจอร์การเรียกใช้โค้ดของ Gemini API ช่วยให้โมเดลสร้างและเรียกใช้ได้ โค้ด Python และเรียนรู้ซ้ำไปเรื่อยๆ จากผลลัพธ์จนถึงเวลาที่ เอาต์พุตสุดท้าย คุณจะใช้ความสามารถในการรันโค้ดนี้เพื่อสร้างแอปพลิเคชันได้ ที่จะได้รับประโยชน์จากการให้เหตุผลโดยใช้โค้ด และที่สร้างเอาต์พุตข้อความ สำหรับ เช่น คุณสามารถใช้การเรียกใช้โค้ดในแอปพลิเคชันที่แก้สมการ หรือ ประมวลผลข้อความ

การเรียกใช้โค้ดพร้อมให้ใช้งานทั้งใน AI Studio และ Gemini API ใน AI Studio คุณเปิดใช้การเรียกใช้โค้ดได้ในส่วนการตั้งค่าขั้นสูง Gemini API มีการเรียกใช้โค้ดเป็นเครื่องมือ ซึ่งคล้ายกับ ฟังก์ชันการโทร หลังจากเพิ่มการเรียกใช้โค้ดเป็นเครื่องมือแล้ว โมเดลจะตัดสินใจว่าจะใช้เครื่องมือนี้เมื่อใด

เริ่มต้นใช้งานการเรียกใช้โค้ด

ส่วนนี้จะถือว่าคุณได้ติดตั้ง Gemini SDK และกำหนดค่าคีย์ API แล้ว ตามที่แสดงในการเริ่มต้นใช้งานอย่างรวดเร็ว

การเรียกใช้โค้ดและการเรียกใช้ฟังก์ชัน

การเรียกใช้โค้ดและการเรียกใช้ฟังก์ชัน คุณลักษณะที่คล้ายกัน:

  • การดำเนินการของโค้ดช่วยให้โมเดลเรียกใช้โค้ดในแบ็กเอนด์ของ API ในสภาพแวดล้อมแบบแยกและคงที่
  • การเรียกฟังก์ชันช่วยให้คุณเรียกใช้ฟังก์ชันที่โมเดลขอใน สภาพแวดล้อมใดก็ได้ที่คุณต้องการ

โดยทั่วไปแล้ว คุณควรใช้การเรียกใช้โค้ดหากสามารถจัดการกับกรณีการใช้งานของคุณได้ การเรียกใช้โค้ดใช้งานง่ายกว่า (คุณเพียงเปิดใช้) และแก้ไขใน คำขอ GenerateContent ครั้งเดียว (ทำให้มีการเรียกเก็บเงิน 1 ครั้ง) ประโยชน์ใช้สอย การโทรต้องใช้คำขอ GenerateContent เพิ่มเติมในการส่งเอาต์พุตกลับมา จากการเรียกใช้ฟังก์ชันแต่ละครั้ง (มีค่าใช้จ่ายหลายครั้ง)

ในกรณีส่วนใหญ่ คุณควรใช้การเรียกฟังก์ชันหากมีฟังก์ชันของตัวเองที่ต้องการเรียกใช้ในพื้นที่ และควรใช้การเรียกใช้โค้ดหากต้องการให้ API เขียนและเรียกใช้โค้ด Python ให้คุณและแสดงผลลัพธ์

การเรียกเก็บเงิน

ไม่มีค่าใช้จ่ายเพิ่มเติมสำหรับการเปิดใช้การเรียกใช้โค้ดจาก Gemini API ระบบจะเรียกเก็บเงินจากคุณในอัตราปัจจุบันของโทเค็นอินพุตและเอาต์พุต

สิ่งอื่นที่ควรทราบเกี่ยวกับการเรียกเก็บเงินสำหรับการเรียกใช้โค้ดมีดังนี้

  • ระบบจะเรียกเก็บเงินจากคุณเพียงครั้งเดียวสำหรับโทเค็นอินพุตที่คุณส่งไปยังโมเดล และเรียกเก็บเงินสำหรับโทเค็นเอาต์พุตสุดท้ายที่โมเดลแสดงให้คุณ
  • ระบบจะนับโทเค็นที่แสดงถึงโค้ดที่สร้างขึ้นเป็นโทเค็นเอาต์พุต
  • ผลลัพธ์ของการเรียกใช้โค้ดจะนับเป็นโทเค็นเอาต์พุตด้วย

ข้อจำกัด

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