Tính năng thực thi mã API Gemini cho phép mô hình tạo và chạy mã Python, đồng thời học lặp lại từ các kết quả cho đến khi đạt được kết quả cuối cùng. Bạn có thể sử dụng chức năng thực thi mã này để xây dựng các ứng dụng tận dụng được khả năng suy luận dựa trên mã và tạo ra kết quả văn bản. Ví dụ: bạn có thể sử dụng tính năng thực thi mã trong một ứng dụng giải phương trình hoặc xử lý văn bản.
Tính năng thực thi mã hoạt động trong cả AI Studio và Gemini API. Trong AI Studio, bạn có thể bật tính năng thực thi mã trong phần Cài đặt nâng cao. API Gemini cung cấp tính năng thực thi mã dưới dạng một công cụ, tương tự như lệnh gọi hàm. Sau khi bạn thêm tính năng thực thi mã dưới dạng một công cụ, mô hình sẽ quyết định thời điểm sử dụng công cụ đó.
Bắt đầu với việc thực thi mã
Phần này giả định rằng bạn đã hoàn tất các bước thiết lập và định cấu hình được trình bày trong phần bắt đầu nhanh.
Thực thi mã so với gọi hàm
Thực thi mã và gọi hàm là các tính năng tương tự nhau:
- Quá trình thực thi mã cho phép mô hình chạy mã trong phần phụ trợ API trong một môi trường cố định, tách biệt.
- Lệnh gọi hàm cho phép bạn chạy các hàm mà mô hình yêu cầu, trong bất kỳ môi trường nào bạn muốn.
Nhìn chung, bạn nên sử dụng tính năng thực thi mã nếu tính năng này có thể xử lý trường hợp sử dụng của bạn. Quá trình thực thi mã đơn giản hơn (bạn chỉ cần bật tính năng này) và được phân giải trong một yêu cầu GenerateContent duy nhất (do đó sẽ phát sinh một khoản phí duy nhất). Lệnh gọi hàm sẽ yêu cầu thêm một yêu cầu GenerateContent để gửi lại đầu ra từ mỗi lệnh gọi hàm (do đó sẽ phải trả nhiều khoản phí).
Trong hầu hết trường hợp, bạn nên sử dụng phương thức gọi hàm nếu bạn có các hàm riêng mà bạn muốn chạy cục bộ và bạn nên sử dụng phương thức thực thi mã nếu muốn API viết và chạy mã Python cho bạn và trả về kết quả.
Thanh toán
Bạn không phải trả thêm phí khi bật tính năng thực thi mã từ Gemini API. Bạn sẽ được tính phí theo mức giá hiện tại của mã thông báo đầu vào và đầu ra.
Dưới đây là một số điều khác bạn cần biết về việc tính phí cho việc thực thi mã:
- Bạn chỉ bị tính phí một lần cho các mã thông báo đầu vào mà bạn truyền vào mô hình và bạn sẽ bị tính phí cho các mã thông báo đầu ra cuối cùng mà mô hình trả về cho bạn.
- Các mã thông báo đại diện cho mã được tạo được tính là mã thông báo đầu ra.
- Kết quả thực thi mã cũng được tính là mã thông báo đầu ra.
Các điểm hạn chế
- Mô hình chỉ có thể tạo và thực thi mã. Phương thức này không thể trả về các cấu phần phần mềm khác như tệp phương tiện.
- Tính năng này không hỗ trợ I/O tệp hoặc các trường hợp sử dụng liên quan đến đầu ra không phải văn bản (ví dụ: biểu đồ dữ liệu hoặc tải tệp CSV lên).
- Quá trình thực thi mã có thể chạy tối đa 30 giây trước khi hết thời gian chờ.
- Trong một số trường hợp, việc bật tính năng thực thi mã có thể dẫn đến sự hồi quy trong các khu vực khác của đầu ra mô hình (ví dụ: viết một câu chuyện).
- Có một số điểm khác biệt về khả năng sử dụng tính năng thực thi mã thành công của các mô hình. Gemini 1.5 Pro là mô hình hoạt động hiệu quả nhất dựa trên thử nghiệm của chúng tôi.