Mit 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. Dies kann je nach Nutzung zu Kosten- und Geschwindigkeitseinsparungen führen. Eine ausführliche Einführung finden Sie in der Anleitung zum Kontext-Caching.
Methode: cacheContents.create
- Endpunkt
- Anfragetext
- Antworttext
- Beispielanfrage <ph type="x-smartling-placeholder">
Erstellt eine CachedContent-Ressource.
Endpunkt
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> Beitrag
https://generativelanguage.googleapis.com/v1beta/cachedContents
Anfragetext
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 verwenden kann, um die nächste Antwort zu generieren
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 den im Cache gespeicherten Inhalt 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 freigegeben.
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
- Endpunkt
- Anfrageparameter
- Anfragetext
- Antworttext
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
Listet CachedContents auf.
Endpunkt
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> erhalten
https://generativelanguage.googleapis.com/v1beta/cachedContents
Abfrageparameter
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 der Liste „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: cacheContents.get
- Endpunkt
- Pfadparameter
- Anfragetext
- Antworttext
- Beispielanfrage
<ph type="x-smartling-placeholder">
- </ph>
- Basic
Liest Ressource vom Typ „CachedContent“.
Endpunkt
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> erhalten
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: cacheContents.patch
- Endpunkt
- Pfadparameter
- Anfrageparameter
- Anfragetext
- Antworttext
- Beispielanfrage
<ph type="x-smartling-placeholder">
- </ph>
- Basic
Aktualisiert die CachedContent-Ressource (nur die Ablaufzeit kann aktualisiert werden).
Endpunkt
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> 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 den im Cache gespeicherten Inhalt 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 den im Cache gespeicherten Inhalt 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: cacheContents.delete
- Endpunkt
- Pfadparameter
- Anfragetext
- Antworttext
- Beispielanfrage
<ph type="x-smartling-placeholder">
- </ph>
- Basic
Löscht die CachedContent-Ressource.
Endpunkt
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> Löschen
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: cacheContents
- Ressource: CachedContent
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Inhalt
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Teil
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Blob
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- FunctionCall
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- FunctionResponse
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- FileData
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- ExecutableCode
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Sprache
- CodeExecutionResult
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Ergebnis
- Tool
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- FunctionDeclaration
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Schema
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Typ
- CodeExecution
- ToolConfig
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- FunctionCallingConfig
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Mode
- UsageMetadata
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Methoden
Ressource: CachedContent
Inhalte, die bereits vorverarbeitet wurden und in nachfolgenden Anfragen an 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 verwenden kann, um die nächste Antwort zu generieren
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. Zeitpunkt der letzten Aktualisierung des Cache-Eintrags in UTC.
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 den im Cache gespeicherten Inhalt 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 freigegeben.
JSON-Darstellung |
---|
{ "contents": [ { object ( |
Inhalt
Der grundlegende strukturierte Datentyp, der den mehrteiligen Inhalt einer Nachricht enthält.
Ein Content
enthält ein role
-Feld, das den Ersteller der Content
angibt, und ein parts
-Feld mit mehrteiligen Daten, die den Inhalt der Nachrichtensendung enthalten.
parts[]
object (Part
)
Parts
bestellt, die eine einzelne Nachricht bilden. Teile können unterschiedliche MIME-Typen haben.
role
string
Optional. Der Produzent des Contents. Muss entweder „user“ sein oder 'Modell' [model].
Nützlich zum Festlegen für Unterhaltungen mit mehreren Schritten. Andernfalls können Sie das Feld leer lassen oder die Festlegung aufheben.
JSON-Darstellung |
---|
{
"parts": [
{
object ( |
Teil
Datentyp mit Medien, der Teil einer mehrteiligen Content
-Nachricht ist.
Eine Part
besteht aus Daten, denen ein Datentyp zugeordnet ist. 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 Untertyp des Mediums identifiziert, wenn das Feld inlineData
mit Rohbyte 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
)
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.
functionResponse
object (FunctionResponse
)
Die Ergebnisausgabe einer FunctionCall
, die einen String enthält, der die FunctionDeclaration.name
und ein strukturiertes JSON-Objekt mit einer Ausgabe der Funktion enthält, 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 von ExecutableCode
.
JSON-Darstellung |
---|
{ // Union field |
Blob
Roh-Mediabyte.
Text sollte nicht als Rohbyte gesendet werden. Verwenden Sie stattdessen „Text“. ein.
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 Dateiformate 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 die FunctionDeclaration.name
und ein strukturiertes JSON-Objekt mit einer Ausgabe der Funktion enthält, wird als Kontext für das Modell verwendet. Hier sollte das Ergebnis eines FunctionCall
enthalten sein, der auf der Grundlage der Modellvorhersage erstellt wurde.
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 an das Modell zurückgegebene Ergebnis.
Wird nur bei Verwendung des CodeExecution
-Tools generiert. Darin wird der Code automatisch ausgeführt und eine entsprechende CodeExecutionResult
wird generiert.
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, „numpy“ und „simpy“ sind verfügbar. |
CodeExecutionResult
Ergebnis der Ausführung von ExecutableCode
.
Wird nur bei Verwendung des CodeExecution
s generiert und folgt immer einem part
, das ExecutableCode
enthält.
outcome
enum (Outcome
)
Erforderlich. Ergebnis der Codeausführung.
output
string
Optional. Enthält „stdout“, wenn die Codeausführung erfolgreich ist, oder „stderr“ oder eine andere Beschreibung.
JSON-Darstellung |
---|
{
"outcome": enum ( |
Ergebnis
Aufzählung möglicher Ergebnisse der Codeausführung.
Enums | |
---|---|
OUTCOME_UNSPECIFIED |
Unbekannter Status. Dieser Wert sollte nicht verwendet werden. |
OUTCOME_OK |
Codeausführung wurde abgeschlossen. |
OUTCOME_FAILED |
Die Codeausführung wurde beendet, aber ein Fehler ist aufgetreten. stderr sollte den Grund enthalten. |
OUTCOME_DEADLINE_EXCEEDED |
Die Codeausführung lief zu lange und wurde abgebrochen. Möglicherweise ist eine unvollständige Ausgabe vorhanden. |
Tool
Tooldetails, die das Modell zum Generieren einer Antwort verwenden kann.
Eine Tool
ist ein Code-Snippet, das es dem System ermöglicht, mit externen Systemen zu interagieren, um eine Aktion oder eine Reihe von Aktionen auszuführen, ohne das Wissen und den Umfang des Modells zu überschreiten.
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][content.part.function_call] mit Argumenten auf der Clientseite zur Ausführung zurückgegeben werden. Das Modell kann entscheiden, eine Teilmenge dieser Funktionen aufzurufen, indem es [FunctionCall][content.part.function_call] in die Antwort einfügt. Die nächste Unterhaltungsrunde kann [FunctionResponse][content.part.function_response] mit der "Funktion" [content.role] enthalten. Generierungskontext für die nächste Modellreihe.
codeExecution
object (CodeExecution
)
Optional. Ermöglicht dem Modell, Code als Teil der Generierung auszuführen.
JSON-Darstellung |
---|
{ "functionDeclarations": [ { object ( |
FunctionDeclaration
Strukturierte Darstellung einer Funktionsdeklaration gemäß der Definition in der OpenAPI 3.03-Spezifikation. Diese Deklaration enthält den Funktionsnamen und die Parameter. Diese FunctionDeclaration-Darstellung 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 zwischen Groß- und Kleinschreibung unterschieden. Schemawert: das Schema, das den für den Parameter verwendeten Typ definiert.
JSON-Darstellung |
---|
{
"name": string,
"description": string,
"parameters": {
object ( |
Schema
Mit dem Objekt Schema
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. Dies wird nur für primitive Datentypen verwendet. Unterstützte Formate: für Typ NUMBER: float, double für INTEGER-Typ: int32, int64 für Typ STRING: enum
description
string
Optional. Eine kurze Beschreibung des Parameters. Diese können Anwendungsbeispiele enthalten. Die Parameterbeschreibung kann als Markdown 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. Beispielsweise können wir eine Enum-Richtung so definieren : {type:STRING, format:enum, enum:["EAST", NORTH", "SOUTH", "WEST"]}.
maxItems
string (int64 format)
Optional. Maximale Anzahl der Elemente für Type.ARRAY.
properties
map (key: string, value: object (Schema
))
Optional. Eigenschaften des Typs OBJECT.
Ein Objekt, das eine Liste von "key": value
-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }
.
required[]
string
Optional. Erforderliche Eigenschaften vom Typ.OBJECT.
items
object (Schema
)
Optional. Schema der Elemente von Type.ARRAY.
Typ
„Type“ (Typ) 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 |
Zahlentyp. |
INTEGER |
Ganzzahltyp. |
BOOLEAN |
Boolescher Typ. |
ARRAY |
Arraytyp. |
OBJECT |
Objekttyp. |
CodeExecution
Dieser Typ hat keine Felder.
Tool, das vom Modell generierten Code ausführt und das Ergebnis automatisch an das Modell zurückgibt.
Siehe auch 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 Funktionsaufruf.
JSON-Darstellung |
---|
{
"functionCallingConfig": {
object ( |
FunctionCallingConfig
Konfiguration zum Festlegen des Verhaltens bei Funktionsaufrufen.
mode
enum (Mode
)
Optional. Gibt den Modus an, in dem Funktionsaufrufe ausgeführt werden sollen. Wenn keine Vorgabe erfolgt, wird der Standardwert AUTOMATISCH festgelegt.
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 ANY gesetzt ist, sagt das Modell einen Funktionsaufruf aus dem Satz von Funktionsnamen vorher.
JSON-Darstellung |
---|
{
"mode": enum ( |
Modus
Definiert das Ausführungsverhalten für Funktionsaufrufe, indem der Ausführungsmodus definiert wird.
Enums | |
---|---|
MODE_UNSPECIFIED |
Nicht spezifizierter Funktionsaufrufmodus. Dieser Wert sollte nicht verwendet werden. |
AUTO |
Das Standardverhalten des Modells. Das Modell entscheidet, ob ein Funktionsaufruf oder eine Antwort in natürlicher Sprache vorhergesagt wird. |
ANY |
Das Modell ist darauf beschränkt, immer nur einen Funktionsaufruf vorherzusagen. Wenn „allowedFunctionNames“ festgelegt sind, ist der vorhergesagte Funktionsaufruf auf einen der "allowedFunctionNames"-Funktionen beschränkt. Andernfalls ist der vorhergesagte Funktionsaufruf ein beliebiger der bereitgestellten "functionDeclarations". |
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 } |