Funkcja wykonywania kodu interfejsu Gemini API umożliwia modelowi generowanie i uruchamianie kodu Pythona oraz iteracyjne uczenie się na podstawie wyników, aż do uzyskania ostatecznego wyniku. Możesz użyć tej funkcji do tworzenia aplikacji, które korzystają z rozpoznawania tekstu opartego na kodzie i generują tekst. Możesz na przykład użyć wykonania kodu 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 sekcji Ustawienia zaawansowane. Interfejs Gemini API umożliwia wykonywanie kodu jako narzędzie podobne do wywołania funkcji. Po dodaniu wykonywania kodu jako narzędzia model sam decyduje, kiedy ma go użyć.
Wprowadzenie do wykonywania kodu
W tej sekcji zakładamy, że masz zainstalowany pakiet SDK Gemini i skonfigurowany klucz API zgodnie z instrukcjami podanymi w sekcji samouczka.
Wykonywanie 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ą). Wywoływanie funkcji wymaga wysłania dodatkowego żądania GenerateContent, aby przesłać dane wyjściowe z każdego wywołania funkcji (co powoduje dodatkowe opłaty).
W większości przypadków należy użyć wywołania funkcji, jeśli masz własne funkcje, które chcesz uruchomić lokalnie, oraz użyć wykonania kodu, jeśli chcesz, aby interfejs API napisał i uruchomił kod Pythona za Ciebie, a potem zwrócił wynik.
Płatności
Włączenie wykonywania kodu z użyciem Gemini API nie wiąże się z dodatkowymi opłatami. Będziesz obciążany(-a) opłatą według bieżącej stawki tokenów wejściowych i wyjściowych.
Oto kilka innych informacji o płatnościach za wykonywanie kodu:
- Naliczamy opłatę tylko raz za tokeny wejściowe przekazywane do modelu. Naliczamy również opłatę za ostateczne tokeny wyjściowe zwracane 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.