Pamięć podręczna kontekstu umożliwia zapisywanie i ponowne używanie obliczonych wcześniej tokenów danych wejściowych, których chcesz używać wielokrotnie, np. podczas zadawania różnych pytań dotyczących tego samego pliku multimedialnego. Może to prowadzić do oszczędności na kosztach i szybkości, w zależności od sposobu korzystania. Szczegółowe informacje znajdziesz w przewodniku dotyczącym buforowania kontekstu.
Metoda: cachedContents.create
Tworzy zasób CachedContent.
Punkt końcowy
posthttps: / /generativelanguage.googleapis.com /v1beta /cachedContents
Adres URL używa składni transkodowania gRPC.
Treść żądania
Treść żądania zawiera wystąpienie elementu CachedContent
.
contents[]
object (Content
)
Opcjonalnie: Tylko dane wejściowe. Niezmienna. Treści do umieszczenia w pamięci podręcznej.
tools[]
object (Tool
)
Opcjonalnie: Tylko dane wejściowe. Niezmienna. lista Tools
, których model może użyć do wygenerowania następnej odpowiedzi;
expiration
Union type
expiration
może być tylko jednym z tych elementów:expireTime
string (Timestamp
format)
Sygnatura czasowa UTC wskazująca, kiedy zasób jest uznawany za nieaktualny. Jest zawsze podawana na wyjściu niezależnie od tego, co zostało wysłane na wejściu.
Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z"
, "2014-10-02T15:01:23.045123456Z"
lub "2014-10-02T15:01:23+05:30"
.
ttl
string (Duration
format)
Tylko dane wejściowe. Nowa wartość TTL dla tego zasobu, tylko do wprowadzania.
Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s
”. Przykład: "3.5s"
.
name
string
Opcjonalnie: Identyfikator. Nazwa zasobu odwołującego się do treści w pamięci podręcznej. Format: cachedContents/{id}
displayName
string
Opcjonalnie: Niezmienna. Wyświetlana nazwa treści z poziomu pamięci podręcznej, która ma znaczenie dla użytkownika. Maksymalnie 128 znaków Unicode.
model
string
Wymagany. Niezmienna. Nazwa Model
do użycia w przypadku treści z pamięci podręcznej. Format: models/{model}
systemInstruction
object (Content
)
Opcjonalnie: Tylko dane wejściowe. Niezmienna. Instrukcje dotyczące konfiguracji systemu przez dewelopera. Obecnie tylko tekst.
toolConfig
object (ToolConfig
)
Opcjonalnie: Tylko dane wejściowe. Niezmienna. Konfiguracja narzędzia. Ta konfiguracja jest wspólna dla wszystkich narzędzi.
Przykładowe żądanie
Podstawowe
Python
Node.js
Przeczytaj
Muszla
Nazwa nadawcy
Python
Node.js
Przeczytaj
Z czatu
Python
Node.js
Przeczytaj
Treść odpowiedzi
Jeśli operacja się powiedzie, treść odpowiedzi będzie zawierała nowo utworzoną instancję CachedContent
.
Metoda: cachedContents.list
Wyświetla elementy CachedContents.
Punkt końcowy
gethttps: / /generativelanguage.googleapis.com /v1beta /cachedContents
Adres URL używa składni transkodowania gRPC.
Parametry zapytania
pageSize
integer
Opcjonalnie: Maksymalna liczba elementów z pamięci podręcznej do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie podasz wartości, zwrócona zostanie domyślna liczba elementów (poniżej maksymalnej). Maksymalna wartość to 1000; wartości powyżej 1000 zostaną skonwertowane na 1000.
pageToken
string
Opcjonalnie: Token strony otrzymany z poprzedniego wywołania funkcji cachedContents.list
. Podaj ten parametr, aby pobrać kolejną stronę.
Podczas podziału na strony wszystkie inne parametry przekazane do funkcji cachedContents.list
muszą być zgodne z wywołaniem, które dostarczyło token strony.
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Odpowiedź z listą CachedContents.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
cachedContents[]
object (CachedContent
)
Lista treści z pamięci podręcznej.
nextPageToken
string
token, który może być wysyłany jako pageToken
w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.
Zapis JSON |
---|
{
"cachedContents": [
{
object ( |
Metoda: cachedContents.get
Odczytuje zasób CachedContent.
Punkt końcowy
gethttps: / /generativelanguage.googleapis.com /v1beta /{name=cachedContents /*}
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
name
string
Wymagany. Nazwa zasobu odwołującego się do wpisu w pamięci podręcznej treści. Format: cachedContents/{id}
Ma postać cachedContents/{cachedcontent}
.
Treść żądania
Treść żądania musi być pusta.
Przykładowe żądanie
Python
Node.js
Przeczytaj
Muszla
Treść odpowiedzi
W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu CachedContent
.
Metoda: cachedContents.patch
Aktualizuje zasób CachedContent (można zaktualizować tylko datę wygaśnięcia).
Punkt końcowy
patchhttps: / /generativelanguage.googleapis.com /v1beta /{cachedContent.name=cachedContents /*}
PATCH https://generativelanguage.googleapis.com/v1beta/{cachedContent.name=cachedContents/*}
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
cachedContent.name
string
Opcjonalnie: Identyfikator. Nazwa zasobu odwołującego się do treści w pamięci podręcznej. Format: cachedContents/{id}
Ma postać cachedContents/{cachedcontent}
.
Parametry zapytania
updateMask
string (FieldMask
format)
Lista pól do zaktualizowania.
Jest to lista pełnych nazw pól rozdzielona przecinkami. Przykład: "user.displayName,photo"
.
Treść żądania
Treść żądania zawiera wystąpienie elementu CachedContent
.
expiration
Union type
expiration
może być tylko jednym z tych elementów:expireTime
string (Timestamp
format)
Sygnatura czasowa UTC wskazująca, kiedy zasób jest uznawany za nieaktualny. Jest zawsze podawana na wyjściu niezależnie od tego, co zostało wysłane na wejściu.
Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z"
, "2014-10-02T15:01:23.045123456Z"
lub "2014-10-02T15:01:23+05:30"
.
ttl
string (Duration
format)
Tylko dane wejściowe. Nowa wartość TTL dla tego zasobu, tylko do wprowadzania.
Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s
”. Przykład: "3.5s"
.
name
string
Opcjonalnie: Identyfikator. Nazwa zasobu odwołującego się do treści w pamięci podręcznej. Format: cachedContents/{id}
Przykładowe żądanie
Python
Node.js
Przeczytaj
Muszla
Treść odpowiedzi
W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu CachedContent
.
Metoda: cachedContents.delete
Usuwa zasób CachedContent.
Punkt końcowy
deletehttps: / /generativelanguage.googleapis.com /v1beta /{name=cachedContents /*}
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
name
string
Wymagany. Nazwa zasobu odwołującego się do wpisu w pamięci podręcznej treści. Format: cachedContents/{id}
. Ma postać cachedContents/{cachedcontent}
.
Treść żądania
Treść żądania musi być pusta.
Przykładowe żądanie
Python
Node.js
Przeczytaj
Muszla
Treść odpowiedzi
W przypadku powodzenia treść odpowiedzi to pusty obiekt JSON.
Zasób REST: cachedContents
- Zasób: CachedContent
- Treść
- Część
- Blob
- FunctionCall
- FunctionResponse
- FileData
- ExecutableCode
- Język
- CodeExecutionResult
- Wynik
- Narzędzie
- FunctionDeclaration
- Schemat
- Typ
- GoogleSearchRetrieval
- DynamicRetrievalConfig
- Tryb
- CodeExecution
- GoogleSearch
- ToolConfig
- FunctionCallingConfig
- Tryb
- UsageMetadata
- Metody
Zasób: CachedContent
Treści, które zostały wstępnie przetworzone i mogą być użyte w kolejnych żądaniach do GenerativeService.
Treści w pamięci podręcznej mogą być używane tylko z modelem, dla którego zostały utworzone.
contents[]
object (Content
)
Opcjonalnie: Tylko dane wejściowe. Niezmienna. Treści do umieszczenia w pamięci podręcznej.
tools[]
object (Tool
)
Opcjonalnie: Tylko dane wejściowe. Niezmienna. lista Tools
, których model może użyć do wygenerowania następnej odpowiedzi;
createTime
string (Timestamp
format)
Tylko dane wyjściowe. Czas utworzenia wpisu w pamięci podręcznej.
Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z"
, "2014-10-02T15:01:23.045123456Z"
lub "2014-10-02T15:01:23+05:30"
.
updateTime
string (Timestamp
format)
Tylko dane wyjściowe. Czas ostatniej aktualizacji wpisu w pamięci podręcznej (UTC).
Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z"
, "2014-10-02T15:01:23.045123456Z"
lub "2014-10-02T15:01:23+05:30"
.
usageMetadata
object (UsageMetadata
)
Tylko dane wyjściowe. Metadane dotyczące wykorzystania treści z pamięci podręcznej.
expiration
Union type
expiration
może być tylko jednym z tych elementów:expireTime
string (Timestamp
format)
Sygnatura czasowa UTC wskazująca, kiedy zasób jest uznawany za nieaktualny. Jest zawsze podawana na wyjściu niezależnie od tego, co zostało wysłane na wejściu.
Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z"
, "2014-10-02T15:01:23.045123456Z"
lub "2014-10-02T15:01:23+05:30"
.
ttl
string (Duration
format)
Tylko dane wejściowe. Nowa wartość TTL dla tego zasobu, tylko do wprowadzania.
Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s
”. Przykład: "3.5s"
.
name
string
Opcjonalnie: Identyfikator. Nazwa zasobu odwołującego się do treści w pamięci podręcznej. Format: cachedContents/{id}
displayName
string
Opcjonalnie: Niezmienna. Wyświetlana nazwa treści z poziomu pamięci podręcznej, która ma znaczenie dla użytkownika. Maksymalnie 128 znaków Unicode.
model
string
Wymagany. Niezmienna. Nazwa Model
do użycia w przypadku treści z pamięci podręcznej. Format: models/{model}
systemInstruction
object (Content
)
Opcjonalnie: Tylko dane wejściowe. Niezmienna. Instrukcje dotyczące konfiguracji systemu przez dewelopera. Obecnie tylko tekst.
toolConfig
object (ToolConfig
)
Opcjonalnie: Tylko dane wejściowe. Niezmienna. Konfiguracja narzędzia. Ta konfiguracja jest wspólna dla wszystkich narzędzi.
Zapis JSON |
---|
{ "contents": [ { object ( |
Treść
Podstawowy typ danych uporządkowanych zawierający wieloczęściową treść wiadomości.
Content
zawiera pole role
, w którym wskazany jest producent Content
, oraz pole parts
zawierające dane wieloczęściowe z treścią wiadomości.
parts[]
object (Part
)
uporządkowane Parts
, które stanowią jedną wiadomość. Części mogą mieć różne typy MIME.
role
string
Opcjonalnie: Producent treści. Musi to być „user” (użytkownik) lub „model” (model).
Przydatne w przypadku rozmów wieloetapowych. W innych przypadkach można pozostawić to pole puste lub niewypełnione.
Zapis JSON |
---|
{
"parts": [
{
object ( |
Część
Typ danych zawierający multimedia, które są częścią wiadomości wieloczęściowej Content
.
Part
składa się z danych, które mają powiązany typ danych. Element Part
może zawierać tylko jeden z akceptowanych typów w elementach Part.data
.
Jeśli pole inlineData
jest wypełnione surowymi bajtami, Part
musi mieć stały typ MIME IANA identyfikujący typ i podtyp multimediów.
data
Union type
data
może być tylko jednym z tych elementów:text
string
Tekst wbudowany.
inlineData
object (Blob
)
Wbudowane bajty multimediów.
functionCall
object (FunctionCall
)
Przewidywana wartość FunctionCall
zwracana przez model, która zawiera ciąg znaków reprezentujący FunctionDeclaration.name
z argumentami i ich wartościami.
functionResponse
object (FunctionResponse
)
Wynik funkcji FunctionCall
, która zawiera ciąg znaków reprezentujący FunctionDeclaration.name
, oraz ustrukturyzowany obiekt JSON zawierający dowolny wynik funkcji, jest używany jako kontekst modelu.
fileData
object (FileData
)
Dane oparte na identyfikatorze URI.
executableCode
object (ExecutableCode
)
Kod wygenerowany przez model, który ma zostać wykonany.
codeExecutionResult
object (CodeExecutionResult
)
Wynik wykonania funkcji ExecutableCode
.
Zapis JSON |
---|
{ // data "text": string, "inlineData": { object ( |
Blob
Nieprzetworzone bajty multimediów.
Tekst nie powinien być wysyłany jako surowe bajty. Użyj pola „text”.
mimeType
string
Typ MIME danych źródłowych zgodny ze standardem IANA. Przykłady: – image/png – image/jpeg Jeśli podany zostanie nieobsługiwany typ MIME, zwrócony zostanie błąd. Pełną listę obsługiwanych typów znajdziesz w sekcji Obsługiwane formaty plików.
data
string (bytes format)
Nieprzetworzone bajty w przypadku formatów multimediów.
Ciąg znaków zakodowany w formacie Base64.
Zapis JSON |
---|
{ "mimeType": string, "data": string } |
FunctionCall
Prognoza FunctionCall
zwracana przez model, która zawiera ciąg znaków reprezentujący FunctionDeclaration.name
z argumentami i ich wartościami.
id
string
Opcjonalnie: Unikalny identyfikator wywołania funkcji. Jeśli jest wypełniony, klient wykonuje functionCall
i zwraca odpowiedź z odpowiednim id
.
name
string
Wymagany. Nazwa funkcji do wywołania. Musi zawierać małe litery (a–z), wielkie litery (A–Z), cyfry (0–9) lub podkreślenia i łączniki. Maksymalna długość to 63 znaki.
args
object (Struct
format)
Opcjonalnie: Parametry i wartości funkcji w formacie obiektu JSON.
Zapis JSON |
---|
{ "id": string, "name": string, "args": { object } } |
FunctionResponse
Wynik funkcji FunctionCall
, która zawiera ciąg znaków reprezentujący FunctionDeclaration.name
, oraz uporządkowany obiekt JSON zawierający dowolne dane wyjściowe funkcji, jest używany jako kontekst modelu. Powinien zawierać wynik FunctionCall
wykonany na podstawie prognozy modelu.
id
string
Opcjonalnie: Identyfikator wywołania funkcji, do którego należy ta odpowiedź. Wypełniane przez klienta w celu dopasowania do odpowiedniego wywołania funkcji id
.
name
string
Wymagany. Nazwa funkcji do wywołania. Musi zawierać małe litery (a–z), wielkie litery (A–Z), cyfry (0–9) lub podkreślenia i łączniki. Maksymalna długość to 63 znaki.
response
object (Struct
format)
Wymagany. Odpowiedź funkcji w formacie obiektu JSON.
Zapis JSON |
---|
{ "id": string, "name": string, "response": { object } } |
FileData
Dane oparte na identyfikatorze URI.
mimeType
string
Opcjonalnie: Typ MIME danych źródłowych zgodny ze standardem IANA.
fileUri
string
Wymagany. Identyfikator URI.
Zapis JSON |
---|
{ "mimeType": string, "fileUri": string } |
ExecutableCode
Kod wygenerowany przez model, który ma zostać wykonany, oraz wynik zwrócony do modelu.
Jest generowany tylko podczas korzystania z narzędzia CodeExecution
, w którym kod jest automatycznie wykonywany, a także odpowiedni CodeExecutionResult
.
language
enum (Language
)
Wymagany. Język programowania code
.
code
string
Wymagany. Kod do wykonania.
Zapis JSON |
---|
{
"language": enum ( |
Język
Obsługiwane języki programowania dla wygenerowanego kodu.
Wartości w polu enum | |
---|---|
LANGUAGE_UNSPECIFIED |
Nieokreślony język. Nie należy używać tej wartości. |
PYTHON |
Python > 3.10 z dostępem do biblioteki Numpy i simpy. |
CodeExecutionResult
Wynik wykonania funkcji ExecutableCode
.
Jest generowany tylko wtedy, gdy używasz CodeExecution
, i zawsze występuje po part
zawierającym ExecutableCode
.
outcome
enum (Outcome
)
Wymagany. Wynik działania kodu.
output
string
Opcjonalnie: Zawiera dane wyjściowe stdout, gdy wykonanie kodu przebiega prawidłowo, a w przeciwnym razie – dane stderr lub inny opis.
Zapis JSON |
---|
{
"outcome": enum ( |
Wynik
Wyliczenie możliwych wyników wykonania kodu.
Wartości w polu enum | |
---|---|
OUTCOME_UNSPECIFIED |
Stan nieokreślony. Nie należy używać tej wartości. |
OUTCOME_OK |
Wykonywanie kodu zostało zakończone. |
OUTCOME_FAILED |
Wykonywanie kodu zostało zakończone, ale z błędem. Wartość stderr powinna zawierać powód. |
OUTCOME_DEADLINE_EXCEEDED |
Wykonywanie kodu trwało zbyt długo i zostało anulowane. Może być obecny częściowy wynik. |
Narzędzie
Szczegóły narzędzia, którego model może używać do generowania odpowiedzi.
Tool
to fragment kodu, który umożliwia systemowi interakcję z systemami zewnętrznymi w celu wykonania działania lub zestawu działań wykraczających poza wiedzę i zakres modelu.
functionDeclarations[]
object (FunctionDeclaration
)
Opcjonalnie: Lista FunctionDeclarations
dostępnych dla modelu, których można używać do wywoływania funkcji.
Model lub system nie wykonuje funkcji. Zamiast tego zdefiniowana funkcja może zostać zwrócona jako FunctionCall
z argumentami do wykonania po stronie klienta. Model może wywołać podzbiór tych funkcji, wypełniając FunctionCall
w odpowiedzi. Następna kolejność w rozmowie może zawierać FunctionResponse
z kontekstem generowania „funkcji” Content.role
na potrzeby kolejnej kolejności w modelu.
googleSearchRetrieval
object (GoogleSearchRetrieval
)
Opcjonalnie: Narzędzie do pobierania, które korzysta z wyszukiwarki Google.
codeExecution
object (CodeExecution
)
Opcjonalnie: Umożliwia modelowi wykonywanie kodu w ramach generowania.
googleSearch
object (GoogleSearch
)
Opcjonalnie: Typ narzędzia wyszukiwarki Google. Narzędzie do obsługi wyszukiwarki Google w Modelu. Technologia Google.
Zapis JSON |
---|
{ "functionDeclarations": [ { object ( |
FunctionDeclaration
Strukturalna reprezentacja deklaracji funkcji zgodnie ze specyfikacją OpenAPI 3.03. Deklaracja zawiera nazwę funkcji i parametry. Ta deklaracja funkcji jest reprezentacją bloku kodu, który może być używany przez model jako Tool
i uruchamiany przez klienta.
name
string
Wymagany. Nazwa funkcji. Musi zawierać małe litery (a–z), wielkie litery (A–Z), cyfry (0–9) lub podkreślenia i łączniki. Maksymalna długość to 63 znaki.
description
string
Wymagany. Krótki opis funkcji.
parameters
object (Schema
)
Opcjonalnie: Opisuje parametry tej funkcji. Odzwierciedla obiekt parametru Open API 3.03. Klucz ciągu: nazwa parametru. W nazwach parametrów wielkość liter ma znaczenie. Wartość schematu: schemat definiujący typ używany w przypadku danego parametru.
response
object (Schema
)
Opcjonalnie: Opisuje dane wyjściowe tej funkcji w formacie schematu JSON. Odzwierciedla obiekt odpowiedzi Open API 3.03. Schemat definiuje typ używany dla wartości odpowiedzi funkcji.
Schemat
Obiekt Schema
umożliwia definiowanie typów danych wejściowych i wyjściowych. Mogą to być obiekty, ale też typy prymitywne i tablice. Reprezentuje wybrany podzbiór obiektu schematu OpenAPI 3.0.
type
enum (Type
)
Wymagany. Typ danych.
format
string
Opcjonalnie: Format danych. Jest to używane tylko w przypadku prymitywnych typów danych. Obsługiwane formaty: dla typu LICZBA: float, double dla typu CAŁKA: int32, int64 dla typu TEKST: enum
description
string
Opcjonalnie: Krótki opis parametru. Może to obejmować przykłady użycia. Opis parametru może być sformatowany w formacie Markdown.
nullable
boolean
Opcjonalnie: Wskazuje, czy wartość może być pusta.
enum[]
string
Opcjonalnie: Możliwe wartości elementu typu STRING w formacie wyliczeniowym. Możemy na przykład zdefiniować kierunek jako : {type:STRING, format:enum, enum:["EAST", NORTH", "SOUTH", "WEST"]}
maxItems
string (int64 format)
Opcjonalnie: Maksymalna liczba elementów typu Type.ARRAY.
minItems
string (int64 format)
Opcjonalnie: Minimalna liczba elementów w przypadku typu Type.ARRAY.
properties
map (key: string, value: object (Schema
))
Opcjonalnie: Właściwości typu Type.OBJECT.
Obiekt zawierający listę par "key": value
. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }
.
required[]
string
Opcjonalnie: Wymagania dotyczące właściwości Type.OBJECT
propertyOrdering[]
string
Opcjonalnie: kolejność właściwości, Nie jest to standardowe pole w specyfikacji interfejsu Open API. Służy do określania kolejności właściwości w odpowiedzi.
items
object (Schema
)
Opcjonalnie: Schemat elementów typu Type.ARRAY.
Typ
Typ zawiera listę typów danych OpenAPI zgodnie ze specyfikacją https://spec.openapis.org/oas/v3.0.3#data-types.
Wartości w polu enum | |
---|---|
TYPE_UNSPECIFIED |
Nieokreślony, nie należy go używać. |
STRING |
Typ ciągu znaków. |
NUMBER |
Typ numeru. |
INTEGER |
Typ liczba całkowita. |
BOOLEAN |
Typ logiczny. |
ARRAY |
Typ tablicy. |
OBJECT |
Typ obiektu. |
GoogleSearchRetrieval
Narzędzie do pobierania publicznych danych internetowych na potrzeby informacji podstawowej, opracowane przez Google.
dynamicRetrievalConfig
object (DynamicRetrievalConfig
)
Określa konfigurację dynamicznego pobierania dla danego źródła.
Zapis JSON |
---|
{
"dynamicRetrievalConfig": {
object ( |
DynamicRetrievalConfig
Opis opcji dostosowywania wyszukiwania dynamicznego.
mode
enum (Mode
)
Tryb predyktora używany w przypadku wyszukiwania dynamicznego.
dynamicThreshold
number
Próg do użycia w przypadku dynamicznego pobierania. Jeśli nie zostanie ustawiona, system użyje wartości domyślnej.
Zapis JSON |
---|
{
"mode": enum ( |
Tryb
Tryb predyktora używany do dynamicznego wyszukiwania.
Wartości w polu enum | |
---|---|
MODE_UNSPECIFIED |
Zawsze uruchamiaj odzyskiwanie. |
MODE_DYNAMIC |
Przeprowadzać odzyskiwanie tylko wtedy, gdy system uzna to za konieczne. |
CodeExecution
Ten typ nie ma pól.
Narzędzie, które wykonuje kod wygenerowany przez model i automatycznie zwraca wynik do modelu.
Zobacz też pliki ExecutableCode
i CodeExecutionResult
, które są generowane tylko podczas korzystania z tego narzędzia.
GoogleSearch
Ten typ nie ma pól.
Typ narzędzia wyszukiwarki Google. Narzędzie do obsługi wyszukiwarki Google w Modelu. Technologia Google.
ToolConfig
Konfiguracja narzędzia zawierająca parametry określające użycie Tool
w żądaniu.
functionCallingConfig
object (FunctionCallingConfig
)
Opcjonalnie: Konfiguracja wywoływania funkcji.
Zapis JSON |
---|
{
"functionCallingConfig": {
object ( |
FunctionCallingConfig
Konfiguracja służąca do określania zachowania wywoływania funkcji.
mode
enum (Mode
)
Opcjonalnie: Określa tryb, w jakim ma być wykonywane wywołanie funkcji. Jeśli nie podasz tej wartości, zostanie ustawiona wartość domyślna AUTO.
allowedFunctionNames[]
string
Opcjonalnie: Zestaw nazw funkcji, który ogranicza funkcje wywoływane przez model.
To ustawienie powinno być ustawione tylko wtedy, gdy tryb to ANY. Nazwy funkcji powinny być zgodne z [FunctionDeclaration.name]. Gdy tryb jest ustawiony na dowolny, model prognozuje wywołanie funkcji z podanego zbioru nazw funkcji.
Zapis JSON |
---|
{
"mode": enum ( |
Tryb
Określa zachowanie podczas wywoływania funkcji, definiując tryb wykonywania.
Wartości w polu enum | |
---|---|
MODE_UNSPECIFIED |
Nieokreślony tryb wywoływania funkcji. Nie należy używać tej wartości. |
AUTO |
Domyślne zachowanie modelu: model decyduje, czy przewidzieć wywołanie funkcji, czy odpowiedź w języku naturalnym. |
ANY |
Model jest ograniczony do przewidywania tylko wywołania funkcji. Jeśli ustawisz parametry „allowedFunctionNames”, przewidywane wywołanie funkcji zostanie ograniczone do dowolnego z parametrów „allowedFunctionNames”. W przeciwnym razie przewidywane wywołanie funkcji będzie dowolnym z podanych „functionDeclarations”. |
NONE |
Model nie będzie przewidywać żadnego wywołania funkcji. Model działa tak samo jak wtedy, gdy nie przekazujesz żadnych deklaracji funkcji. |
UsageMetadata
Metadane dotyczące wykorzystania treści z pamięci podręcznej.
totalTokenCount
integer
Łączna liczba tokenów zużywanych przez treści w pamięci podręcznej.
Zapis JSON |
---|
{ "totalTokenCount": integer } |