Mit dem Kontext-Caching können Sie vorab berechnete Eingabetokens speichern und wiederverwenden, die Sie wiederholt verwenden möchten, z. B. wenn Sie verschiedene Fragen zu derselben Mediendatei stellen. Je nach Nutzung kann dies zu Kosten- und Geschwindigkeitseinsparungen führen. Eine ausführliche Einführung finden Sie im Leitfaden zum Kontext-Caching.
Methode: cachedContents.create
Erstellt die Ressource „CachedContent“.
Endpunkt
post https://generativelanguage.googleapis.com/v1beta/cachedContentsAnfragetext
Der Anfragetext enthält eine Instanz von CachedContent
.
contents[]
object (Content
)
Optional. Nur Eingabe. Nicht veränderbar. Der im Cache zu speichernde Inhalt.
tools[]
object (Tool
)
Optional. Nur Eingabe. Nicht veränderbar. Eine Liste von Tools
, die das Modell zum Generieren der nächsten Antwort verwenden kann
expiration
. Gibt an, wann diese Ressource abläuft. Für expiration
ist nur einer der folgenden Werte zulässig:
expireTime
string (Timestamp
format)
Der Zeitstempel in UTC, der angibt, wann diese Ressource als abgelaufen gilt. Dies wird immer bei der Ausgabe angegeben, unabhängig davon, was bei der Eingabe gesendet wurde.
Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z"
und "2014-10-02T15:01:23.045123456Z"
.
ttl
string (Duration
format)
Nur Eingabe. Neue TTL für diese Ressource, nur Eingabe.
Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s
". Beispiel: "3.5s"
.
name
string
Optional. Kennung. Der Ressourcenname, der sich auf die im Cache gespeicherten Inhalte bezieht. Format: cachedContents/{id}
displayName
string
Optional. Nicht veränderbar. Der vom Nutzer generierte aussagekräftige Anzeigename des im Cache gespeicherten Inhalts. Maximal 128 Unicode-Zeichen.
model
string
Erforderlich. Nicht veränderbar. Der Name der Model
, die für im Cache gespeicherte Inhalte verwendet werden soll. Format: models/{model}
systemInstruction
object (Content
)
Optional. Nur Eingabe. Nicht veränderbar. Systemanweisung für Entwicklersatz. Derzeit nur Text.
toolConfig
object (ToolConfig
)
Optional. Nur Eingabe. Nicht veränderbar. Toolkonfiguration Diese Konfiguration wird für alle Tools verwendet.
Beispielanfrage
Einfach
Python
Node.js
Ok
Muschel
Von (Name)
Python
Node.js
Ok
Über den Chat
Python
Node.js
Ok
Antworttext
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von CachedContent
.
Methode: cacheContents.list
Listet CachedContents auf.
Endpunkt
get https://generativelanguage.googleapis.com/v1beta/cachedContentsAbfrageparameter
pageSize
integer
Optional. Die maximale Anzahl der im Cache gespeicherten Inhalte, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, wird eine Standardanzahl von Elementen (unter der maximalen Anzahl) zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt.
pageToken
string
Optional. Ein Seitentoken, das von einem vorherigen cachedContents.list
-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.
Beim Paginieren müssen alle anderen für cachedContents.list
bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwort mit Liste der CachedContents
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
cachedContents[]
object (CachedContent
)
Liste der im Cache gespeicherten Inhalte.
nextPageToken
string
Ein Token, das als pageToken
gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.
JSON-Darstellung |
---|
{
"cachedContents": [
{
object ( |
Methode: cachedContents.get
Liest die CachedContent-Ressource.
Endpunkt
get https://generativelanguage.googleapis.com/v1beta/{name=cachedContents/*}Pfadparameter
name
string
Erforderlich. Der Ressourcenname, der sich auf den Eintrag im Inhaltscache bezieht. Format: cachedContents/{id}
. Sie hat das Format cachedContents/{cachedcontent}
.
Anfragetext
Der Anfragetext muss leer sein.
Beispielanfrage
Python
Node.js
Ok
Muschel
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von CachedContent
.
Methode: cachedContents.patch
Aktualisiert die CachedContent-Ressource (nur Ablaufzeit kann aktualisiert werden).
Endpunkt
patch https://generativelanguage.googleapis.com/v1beta/{cachedContent.name=cachedContents/*}PATCH https://generativelanguage.googleapis.com/v1beta/{cachedContent.name=cachedContents/*}
Pfadparameter
cachedContent.name
string
Optional. Kennung. Der Ressourcenname, der sich auf die im Cache gespeicherten Inhalte bezieht. Format: cachedContents/{id}
. Sie hat das Format cachedContents/{cachedcontent}
.
Abfrageparameter
updateMask
string (FieldMask
format)
Die Liste der zu aktualisierenden Felder.
Dies ist eine durch Kommas getrennte Liste vollständig qualifizierter Feldnamen. Beispiel: "user.displayName,photo"
.
Anfragetext
Der Anfragetext enthält eine Instanz von CachedContent
.
expiration
. Gibt an, wann diese Ressource abläuft. Für expiration
ist nur einer der folgenden Werte zulässig:
expireTime
string (Timestamp
format)
Der Zeitstempel in UTC, der angibt, wann diese Ressource als abgelaufen gilt. Dies wird immer bei der Ausgabe angegeben, unabhängig davon, was bei der Eingabe gesendet wurde.
Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z"
und "2014-10-02T15:01:23.045123456Z"
.
ttl
string (Duration
format)
Nur Eingabe. Neue TTL für diese Ressource, nur Eingabe.
Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s
". Beispiel: "3.5s"
.
name
string
Optional. Kennung. Der Ressourcenname, der sich auf die im Cache gespeicherten Inhalte bezieht. Format: cachedContents/{id}
Beispielanfrage
Python
Node.js
Ok
Muschel
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von CachedContent
.
Methode: cachedContents.delete
Löscht die Ressource „CachedContent“.
Endpunkt
delete https://generativelanguage.googleapis.com/v1beta/{name=cachedContents/*}Pfadparameter
name
string
Erforderlich. Der Ressourcenname, der sich auf den Eintrag im Inhaltscache bezieht: cachedContents/{id}
. Er hat das Format cachedContents/{cachedcontent}
.
Anfragetext
Der Anfragetext muss leer sein.
Beispielanfrage
Python
Node.js
Ok
Muschel
Antworttext
Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.
REST-Ressource: cachedContents
- Ressource: CachedContent
- Inhalt
- Teil
- Blob
- FunctionCall
- FunctionResponse
- FileData
- ExecutableCode
- Sprache
- CodeExecutionResult
- Ergebnis
- Tool
- FunctionDeclaration
- Schema
- Typ
- GoogleSearchRetrieval
- DynamicRetrievalConfig
- Mode
- CodeExecution
- ToolConfig
- FunctionCallingConfig
- Mode
- UsageMetadata
- Methoden
Ressource: CachedContent
Inhalte, die vorverarbeitet wurden und in einer nachfolgenden Anfrage an den GenerativeService verwendet werden können.
Im Cache gespeicherte Inhalte können nur mit dem Modell verwendet werden, für das sie erstellt wurden.
contents[]
object (Content
)
Optional. Nur Eingabe. Nicht veränderbar. Der im Cache zu speichernde Inhalt.
tools[]
object (Tool
)
Optional. Nur Eingabe. Nicht veränderbar. Eine Liste von Tools
, die das Modell zum Generieren der nächsten Antwort verwenden kann
createTime
string (Timestamp
format)
Nur Ausgabe. Erstellungszeit des Cache-Eintrags.
Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z"
und "2014-10-02T15:01:23.045123456Z"
.
updateTime
string (Timestamp
format)
Nur Ausgabe. Wann der Cache-Eintrag zuletzt in UTC-Zeit aktualisiert wurde.
Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z"
und "2014-10-02T15:01:23.045123456Z"
.
usageMetadata
object (UsageMetadata
)
Nur Ausgabe. Metadaten zur Nutzung der im Cache gespeicherten Inhalte.
expiration
. Gibt an, wann diese Ressource abläuft. Für expiration
ist nur einer der folgenden Werte zulässig:
expireTime
string (Timestamp
format)
Der Zeitstempel in UTC, der angibt, wann diese Ressource als abgelaufen gilt. Dies wird immer bei der Ausgabe angegeben, unabhängig davon, was bei der Eingabe gesendet wurde.
Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z"
und "2014-10-02T15:01:23.045123456Z"
.
ttl
string (Duration
format)
Nur Eingabe. Neue TTL für diese Ressource, nur Eingabe.
Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s
". Beispiel: "3.5s"
.
name
string
Optional. Kennung. Der Ressourcenname, der sich auf die im Cache gespeicherten Inhalte bezieht. Format: cachedContents/{id}
displayName
string
Optional. Nicht veränderbar. Der vom Nutzer generierte aussagekräftige Anzeigename des im Cache gespeicherten Inhalts. Maximal 128 Unicode-Zeichen.
model
string
Erforderlich. Nicht veränderbar. Der Name der Model
, die für im Cache gespeicherte Inhalte verwendet werden soll. Format: models/{model}
systemInstruction
object (Content
)
Optional. Nur Eingabe. Nicht veränderbar. Systemanweisung für Entwicklersatz. Derzeit nur Text.
toolConfig
object (ToolConfig
)
Optional. Nur Eingabe. Nicht veränderbar. Toolkonfiguration. Diese Konfiguration wird für alle Tools verwendet.
JSON-Darstellung |
---|
{ "contents": [ { object ( |
Inhalt
Der grundlegende strukturierte Datentyp, der den mehrteiligen Inhalt einer Nachricht enthält.
Eine Content
enthält ein role
-Feld, das den Ersteller der Content
angibt, und ein parts
-Feld mit mehrteiligen Daten, die den Inhalt der Nachrichtenrunde enthalten.
parts[]
object (Part
)
Sortierte Parts
, die eine einzelne Nachricht bilden. Teile können unterschiedliche MIME-Typen haben.
role
string
Optional. Der Ersteller der Inhalte. Muss entweder „user“ oder „model“ sein.
Nützlich für Unterhaltungen mit mehreren Themen, kann andernfalls leer bleiben oder nicht festgelegt werden.
JSON-Darstellung |
---|
{
"parts": [
{
object ( |
Teil
Ein Datentyp mit Medien, die Teil einer mehrteiligen Content
-Nachricht sind.
Ein Part
besteht aus Daten, die mit einem Datentyp verknüpft sind. Ein Part
kann nur einen der akzeptierten Typen in Part.data
enthalten.
Ein Part
muss einen festen IANA-MIME-Typ haben, der den Typ und den Untertyp der Medien angibt, wenn das Feld inlineData
mit Rohbytes gefüllt ist.
Union-Feld data
.
Für data
ist nur einer der folgenden Werte zulässig:
text
string
Inline-Text
inlineData
object (Blob
)
Inline-Mediabyte.
functionCall
object (FunctionCall
)
Ein vorhergesagter FunctionCall
, der vom Modell zurückgegeben wird und einen String enthält, der FunctionDeclaration.name
mit den Argumenten und ihren Werten darstellt.
functionResponse
object (FunctionResponse
)
Die Ergebnisausgabe einer FunctionCall
, die einen String enthält, der FunctionDeclaration.name
darstellt, und ein strukturiertes JSON-Objekt mit der Ausgabe der Funktion, wird als Kontext für das Modell verwendet.
fileData
object (FileData
)
URI-basierte Daten.
executableCode
object (ExecutableCode
)
Vom Modell generierter Code, der ausgeführt werden soll.
codeExecutionResult
object (CodeExecutionResult
)
Ergebnis der Ausführung der ExecutableCode
.
JSON-Darstellung |
---|
{ // Union field |
Blob
Rohe Media-Byte.
Text darf nicht als Rohbytes gesendet werden. Verwenden Sie stattdessen das Feld „text“.
mimeType
string
Der IANA-Standard-MIME-Typ der Quelldaten. Beispiele: - image/png - image/jpeg Wenn ein nicht unterstützter MIME-Typ angegeben wird, wird ein Fehler zurückgegeben. Eine vollständige Liste der unterstützten Typen finden Sie unter Unterstützte Dateiformate.
data
string (bytes format)
Rohbyte für Medienformate.
Ein base64-codierter String.
JSON-Darstellung |
---|
{ "mimeType": string, "data": string } |
FunctionCall
Eine vorhergesagte FunctionCall
, die vom Modell zurückgegeben wird und einen String enthält, der die FunctionDeclaration.name
mit den Argumenten und ihren Werten darstellt.
name
string
Erforderlich. Der Name der aufzurufenden Funktion. Muss a–z, A–Z, 0–9 sein oder Unterstriche und Bindestriche enthalten. Die maximale Länge beträgt 63.
args
object (Struct
format)
Optional. Die Funktionsparameter und ‑werte im JSON-Objektformat.
JSON-Darstellung |
---|
{ "name": string, "args": { object } } |
FunctionResponse
Die Ergebnisausgabe einer FunctionCall
, die einen String enthält, der FunctionDeclaration.name
darstellt, und ein strukturiertes JSON-Objekt mit der Ausgabe der Funktion, wird als Kontext für das Modell verwendet. Dieser sollte das Ergebnis einerFunctionCall
enthalten, die auf der Modellvorhersage basiert.
name
string
Erforderlich. Der Name der aufzurufenden Funktion. Muss a–z, A–Z, 0–9 sein oder Unterstriche und Bindestriche enthalten. Die maximale Länge beträgt 63.
response
object (Struct
format)
Erforderlich. Die Funktionsantwort im JSON-Objektformat.
JSON-Darstellung |
---|
{ "name": string, "response": { object } } |
FileData
URI-basierte Daten.
mimeType
string
Optional. Der IANA-Standard-MIME-Typ der Quelldaten.
fileUri
string
Erforderlich. URI.
JSON-Darstellung |
---|
{ "mimeType": string, "fileUri": string } |
ExecutableCode
Vom Modell generierter Code, der ausgeführt werden soll, und das Ergebnis, das an das Modell zurückgegeben wird.
Wird nur generiert, wenn das CodeExecution
-Tool verwendet wird, in dem der Code automatisch ausgeführt und ein entsprechender CodeExecutionResult
generiert wird.
language
enum (Language
)
Erforderlich. Programmiersprache von code
.
code
string
Erforderlich. Der Code, der ausgeführt werden soll.
JSON-Darstellung |
---|
{
"language": enum ( |
Sprache
Unterstützte Programmiersprachen für den generierten Code.
Enums | |
---|---|
LANGUAGE_UNSPECIFIED |
Sprache nicht angegeben. Dieser Wert sollte nicht verwendet werden. |
PYTHON |
Python >= 3.10 mit numpy und simpy |
CodeExecutionResult
Ergebnis der Ausführung der ExecutableCode
.
Wird nur bei Verwendung des CodeExecution
generiert und folgt immer einem part
, das die ExecutableCode
enthält.
outcome
enum (Outcome
)
Erforderlich. Ergebnis der Codeausführung.
output
string
Optional. Enthält stderr oder eine andere Beschreibung, wenn die Codeausführung fehlgeschlagen ist, andernfalls stderr oder eine andere Beschreibung.
JSON-Darstellung |
---|
{
"outcome": enum ( |
Ergebnis
Aufzählung möglicher Ergebnisse der Codeausführung.
Enums | |
---|---|
OUTCOME_UNSPECIFIED |
Nicht angegebener Status. Dieser Wert sollte nicht verwendet werden. |
OUTCOME_OK |
Die Codeausführung wurde erfolgreich abgeschlossen. |
OUTCOME_FAILED |
Die Codeausführung wurde mit einem Fehler beendet. stderr sollte den Grund enthalten. |
OUTCOME_DEADLINE_EXCEEDED |
Die Codeausführung dauerte zu lange und wurde abgebrochen. Es kann eine teilweise Ausgabe vorhanden sein oder nicht. |
Tool
Tooldetails, die das Modell zum Generieren einer Antwort verwenden kann.
Ein Tool
ist ein Code, der es dem System ermöglicht, mit externen Systemen zu interagieren, um eine Aktion oder eine Reihe von Aktionen außerhalb des Wissens und Umfangs des Modells auszuführen.
functionDeclarations[]
object (FunctionDeclaration
)
Optional. Eine Liste der für das Modell verfügbaren FunctionDeclarations
, die für Funktionsaufrufe verwendet werden kann.
Das Modell oder System führt die Funktion nicht aus. Stattdessen kann die definierte Funktion als FunctionCall
mit Argumenten zur Ausführung an die Clientseite zurückgegeben werden. Das Modell kann entscheiden, einen Teil dieser Funktionen aufzurufen, indem es FunctionCall
in die Antwort einfügt. Die nächste Unterhaltungsrunde kann ein FunctionResponse
mit dem Content.role
-Kontext zum Generieren von Funktionen für die nächste Modellrunde enthalten.
googleSearchRetrieval
object (GoogleSearchRetrieval
)
Optional. Abruftool, das auf der Google Suche basiert.
codeExecution
object (CodeExecution
)
Optional. Ermöglicht es dem Modell, Code im Rahmen der Generierung auszuführen.
JSON-Darstellung |
---|
{ "functionDeclarations": [ { object ( |
FunctionDeclaration
Strukturierte Darstellung einer Funktionsdeklaration gemäß der Definition der OpenAPI 3.03-Spezifikation. Diese Deklaration enthält den Funktionsnamen und die Parameter. Diese FunctionDeclaration ist eine Darstellung eines Codeblocks, der vom Modell als Tool
verwendet und vom Client ausgeführt werden kann.
name
string
Erforderlich. Der Name der Funktion. Muss a–z, A–Z, 0–9 sein oder Unterstriche und Bindestriche enthalten. Die maximale Länge beträgt 63.
description
string
Erforderlich. Eine kurze Beschreibung der Funktion.
parameters
object (Schema
)
Optional. Beschreibt die Parameter dieser Funktion. Entspricht dem Stringschlüssel des OpenAPI 3.03-Parameterobjekts: der Name des Parameters. Bei Parameternamen wird die Groß- und Kleinschreibung beachtet. Schemawert: das Schema, das den für den Parameter verwendeten Typ definiert.
JSON-Darstellung |
---|
{
"name": string,
"description": string,
"parameters": {
object ( |
Schema
Mit dem Schema
-Objekt können Eingabe- und Ausgabedatentypen definiert werden. Bei diesen Typen kann es sich um Objekte, aber auch um Primitive und Arrays handeln. Stellt eine ausgewählte Teilmenge eines OpenAPI 3.0-Schemaobjekts dar.
type
enum (Type
)
Erforderlich. Datentyp.
format
string
Optional. Das Format der Daten. Diese Option wird nur für primitive Datentypen verwendet. Unterstützte Formate: für den TYP „ANZAHL“: float, double für den TYP „GANZZAHL“: int32, int64 für den TYP „STRING“: enum
description
string
Optional. Eine kurze Beschreibung des Parameters. Dies kann auch Anwendungsbeispiele enthalten. Die Parameterbeschreibung kann im Markdown-Format formatiert sein.
nullable
boolean
Optional. Gibt an, ob der Wert null sein kann.
enum[]
string
Optional. Mögliche Werte des Elements vom Typ.STRING im enum-Format. So können wir beispielsweise eine Enum-Richtung so definieren : {type:STRING, format:enum, enum:["OST", "NORD", "SÜD", "WEST"]}
maxItems
string (int64 format)
Optional. Maximale Anzahl der Elemente für Type.ARRAY.
minItems
string (int64 format)
Optional. Mindestanzahl der Elemente für „Type.ARRAY“.
properties
map (key: string, value: object (Schema
))
Optional. Eigenschaften von „Type.OBJECT“
Ein Objekt, das eine Liste von "key": value
-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }
.
required[]
string
Optional. Erforderliche Properties von „Type.OBJECT“
items
object (Schema
)
Optional. Schema der Elemente vom Typ „ARRAY“.
Typ
„Type“ enthält die Liste der OpenAPI-Datentypen gemäß https://spec.openapis.org/oas/v3.0.3#data-types.
Enums | |
---|---|
TYPE_UNSPECIFIED |
Nicht angegeben, sollte nicht verwendet werden. |
STRING |
Stringtyp. |
NUMBER |
Nummerntyp. |
INTEGER |
Ganzzahltyp. |
BOOLEAN |
Boolescher Typ. |
ARRAY |
Arraytyp. |
OBJECT |
Objekttyp. |
GoogleSearchRetrieval
Von Google entwickeltes Tool zum Abrufen öffentlicher Webdaten für die Datengrundlage.
dynamicRetrievalConfig
object (DynamicRetrievalConfig
)
Gibt die Konfiguration für den dynamischen Abruf für die angegebene Quelle an.
JSON-Darstellung |
---|
{
"dynamicRetrievalConfig": {
object ( |
DynamicRetrievalConfig
Hier werden die Optionen zum Anpassen des dynamischen Abrufs beschrieben.
mode
enum (Mode
)
Der Modus des Prädiktors, der beim dynamischen Abrufen verwendet werden soll.
dynamicThreshold
number
Der Schwellenwert, der beim dynamischen Abrufen verwendet werden soll. Wenn dieser Wert nicht festgelegt ist, wird ein Systemstandardwert verwendet.
JSON-Darstellung |
---|
{
"mode": enum ( |
Modus
Der Modus des Prädiktors, der beim dynamischen Abrufen verwendet werden soll.
Enums | |
---|---|
MODE_UNSPECIFIED |
Abruf immer auslösen. |
MODE_DYNAMIC |
Die Daten werden nur dann abgerufen, wenn das System dies für erforderlich hält. |
CodeExecution
Dieser Typ hat keine Felder.
Tool, das vom Modell generierten Code ausführt und das Ergebnis automatisch an das Modell zurückgibt.
Weitere Informationen finden Sie unter ExecutableCode
und CodeExecutionResult
, die nur bei Verwendung dieses Tools generiert werden.
ToolConfig
Die Toolkonfiguration mit den Parametern zur Angabe der Tool
-Verwendung in der Anfrage.
functionCallingConfig
object (FunctionCallingConfig
)
Optional. Konfiguration für Funktionsaufrufe
JSON-Darstellung |
---|
{
"functionCallingConfig": {
object ( |
FunctionCallingConfig
Konfiguration zum Angeben des Verhaltens von Funktionsaufrufen.
mode
enum (Mode
)
Optional. Gibt den Modus an, in dem der Funktionsaufruf ausgeführt werden soll. Wenn Sie keinen Wert angeben, wird der Standardwert „AUTO“ verwendet.
allowedFunctionNames[]
string
Optional. Eine Reihe von Funktionsnamen, die, sofern angegeben, die vom Modell aufrufenden Funktionen einschränkt.
Sollte nur festgelegt werden, wenn für den Modus ANY festgelegt ist. Funktionsnamen müssen mit [FunctionDeclaration.name] übereinstimmen. Wenn der Modus auf „JEDER“ festgelegt ist, prognostiziert das Modell einen Funktionsaufruf aus den angegebenen Funktionsnamen.
JSON-Darstellung |
---|
{
"mode": enum ( |
Modus
Definiert das Ausführungsverhalten für Funktionsaufrufe, indem der Ausführungsmodus definiert wird.
Enums | |
---|---|
MODE_UNSPECIFIED |
Nicht angegebener Modus für Funktionsaufrufe. Dieser Wert sollte nicht verwendet werden. |
AUTO |
Standardverhalten des Modells: Das Modell entscheidet, ob ein Funktionsaufruf oder eine Antwort in natürlicher Sprache vorhergesagt werden soll. |
ANY |
Das Modell ist darauf beschränkt, immer nur einen Funktionsaufruf vorherzusagen. Wenn „allowedFunctionNames“ festgelegt ist, wird der vorhergesagte Funktionsaufruf auf eine der „allowedFunctionNames“ beschränkt. Andernfalls wird der vorhergesagte Funktionsaufruf auf eine der bereitgestellten „functionDeclarations“ beschränkt. |
NONE |
Das Modell sagt keinen Funktionsaufruf vorher. Das Modellverhalten entspricht dem, wenn keine Funktionsdeklarationen übergeben werden. |
UsageMetadata
Metadaten zur Nutzung der im Cache gespeicherten Inhalte.
totalTokenCount
integer
Gesamtzahl der Tokens, die der im Cache gespeicherte Inhalt verbraucht.
JSON-Darstellung |
---|
{ "totalTokenCount": integer } |