Funkcja wykonywania kodu w interfejsie Gemini API umożliwia generowanie i uruchamianie modelu na podstawie kodu Pythona i iteracji na podstawie wyników aż do momentu efekt końcowy. Z tej funkcji wykonywania kodu możesz tworzyć aplikacje które korzystają z rozumowania opartego na kodzie i generują tekstowe dane wyjściowe. Dla: można na przykład uruchomić kod w aplikacji, która rozwiązuje równania lub przetwarza tekst.
Wykonywanie kodu jest dostępne zarówno w AI Studio, jak i interfejsie Gemini API. W AI Studio możesz włączyć wykonywanie kodu w Ustawieniach zaawansowanych. Interfejs Gemini API umożliwia wykonywanie kodu jako narzędzie podobne do wywołania funkcji. Po dodaniu jako narzędzia do wykonywania kodu, model decyduje, kiedy go użyć.
Wprowadzenie do wykonywania kodu
W tej sekcji zakładamy, że masz zainstalowany pakiet Gemini SDK i skonfigurowany interfejs API zgodnie z opisem w krótkim wprowadzeniu.
Wykonanie kodu a wywoływanie funkcji
Wykonanie kodu i wywoływanie funkcji to: podobne funkcje:
- Wykonanie kodu umożliwia modelowi uruchomienie kodu w backendzie interfejsu API w ustalonym, wyodrębnionym dla środowiska.
- Wywołanie funkcji umożliwia uruchamianie funkcji, których żąda model w dowolnym miejscu.
Ogólnie rzecz biorąc, lepiej korzystać z wykonywania kodu, jeśli może ono obsłużyć
tych kwestii. Wykonanie kodu jest prostsze w użyciu (po prostu je włączysz) i trwa
pojedyncze żądanie GenerateContent
(co wiąże się z jedną opłatą). Funkcja
wywołanie wymaga dodatkowego żądania GenerateContent
, które przesyła z powrotem dane wyjściowe.
z każdego wywołania funkcji (co wiąże się z wieloma opłatami).
Jeśli masz własne funkcje, w większości przypadków należy używać wywołań funkcji który chcesz uruchomić lokalnie. Jeśli chcesz, by to było za pomocą interfejsu API do napisania i uruchomienia kodu Pythona oraz zwrócenia wyników.
Płatności
Nie ma dodatkowych opłat za włączenie wykonywania kodu z poziomu Gemini API. Opłaty będą naliczane według aktualnej stawki danych wejściowych i wyjściowych tokeny.
Oto kilka dodatkowych informacji o płatnościach za wykonanie kodu:
- Płacisz tylko raz za tokeny wejściowe przekazane do modelu. płacisz za ostateczne tokeny wyjściowe zwrócone Ci przez model.
- Tokeny reprezentujące wygenerowany kod są liczone jako tokeny wyjściowe.
- Wyniki wykonania kodu są też liczone jako tokeny wyjściowe.
Ograniczenia
- Model może tylko generować i wykonywać kod. Nie może zwrócić innych artefaktów np. pliki multimedialne.
- Ta funkcja nie obsługuje operacji wejścia-wyjścia plików ani przypadków użycia, które obejmują dane wyjściowe inne niż tekstowe np. zestawienia danych lub przesłanie pliku CSV.
- Wykonanie kodu może trwać maksymalnie 30 sekund przed przekroczeniem limitu czasu.
- W niektórych przypadkach włączenie wykonywania kodu może doprowadzić do regresji w innych obszarach. danych wyjściowych modelu (np. napisanie historii).
- Występują pewne różnice w możliwości wykorzystania kodu przez różne modele. udało się wykonać. Model Gemini 1.5 Pro jest na podstawie testów.