LanguageModel: create() statische Methode

Syntax

LanguageModel.create()
LanguageModel.create(options)

Parameter

options Optional

Ein Objekt, das die Optionen für die Erstellung einer LanguageModel Sitzung darstellt. Die Eigenschaften umfassen:

expectedInputs

Ein Array von Objekten, die die erforderlichen Eingabemodalitäten und Sprachen darstellen. Jedes Objekt kann die folgenden Eigenschaften enthalten:

type

Ein enumerierter Wert, der den Inhaltstyp angibt. Muss einer der folgenden sein:

text

Klartext-Inhalt.

image

Bildinhalt.

audio

Audioinhalt.

tool-call

Ein vom Modell ausgegebener Werkzeugaufruf.

tool-response

Das Ergebnis eines Werkzeugaufrufs.

languages Optional

Ein Array von Strings, das BCP 47 Sprach-Tags enthält (zum Beispiel en, fr, ja), die die Sitzung für diesen Inhaltstyp verarbeiten soll. Der Benutzeragent verwendet diese Liste, um zu bestimmen, ob das Modell die angegebenen Sprachen unterstützt, und um geeignete Modellkomponenten oder Feinabstimmungen auszuwählen.

expectedOutputs

Ein Array von Objekten, die die erforderlichen Ausgabemodalitäten und Sprachen darstellen. Jedes Objekt kann die folgenden Eigenschaften enthalten:

type

Ein enumerierter Wert, der den Inhaltstyp angibt. Muss einer der folgenden sein:

text

Klartext-Inhalt.

image

Bildinhalt.

audio

Audioinhalt.

tool-call

Ein vom Modell ausgegebener Werkzeugaufruf.

tool-response

Das Ergebnis eines Werkzeugaufrufs.

languages Optional

Ein Array von Strings, das BCP 47 Sprach-Tags enthält (zum Beispiel en, fr, ja), die die Sitzung für diesen Inhaltstyp verarbeiten soll. Der Benutzeragent verwendet diese Liste, um zu bestimmen, ob das Modell die angegebenen Sprachen unterstützt, und um geeignete Modellkomponenten oder Feinabstimmungen auszuwählen.

initialPrompts

Ein Array von Objekten, die Nachrichten darstellen, die während der Erstellung einer Sprachmodell-Sitzung übermittelt werden. Dies ermöglicht es dem Modell, sich Anweisungen oder vorherige Dialoge "zu merken", ohne diese bei jeder neuen Anfrage erneut senden zu müssen. Jedes Objekt kann die folgenden Eigenschaften enthalten:

role

Ein String, der den Standpunkt angibt, aus dem die Nachricht formuliert ist. Muss einer der folgenden sein:

system

Eine systemweite Anweisung, die das allgemeine Verhalten des Modells lenkt. Dies muss die erste an das Modell übergebene Anweisung sein.

user

Eine Nachricht vom Benutzer, auf die die API antworten soll.

assistant

Eine Eingabe, die dem AI-Assistenten Kontext liefert, wie z.B. seine Persönlichkeit oder das Format seiner Antworten. Solche Nachrichten dienen hauptsächlich dazu, Kontext/Geschichte zu liefern und die Reaktion des Modells weiter zu gestalten.

content

Ein String, der ein Text-Prompt darstellt, oder ein Array von Objekten. Jedes Objekt umfasst die folgenden Eigenschaften:

type

Ein enumerierter Wert, der den Typ des Inhalts darstellt. Dies kann einer der folgenden sein:

audio

Audioinhalt.

image

Bildinhalt.

text

Textinhalt.

tool-call

Ein vom Modell ausgegebener Werkzeugaufruf.

tool-response

Das Ergebnis eines Werkzeugaufrufs.

value

Der Inhalt der Nachricht. Wenn der type text ist, ist dies immer ein String. Wenn der type audio oder image ist, kann der value aus mehreren verschiedenen Objekttypen bestehen; siehe Welche Datentypen werden akzeptiert?.

prefix Optional

Ein boolescher Wert, standardmäßig false. Wenn true, wird die Nachricht als Präfix für die nächste generierte Antwort des Modells behandelt, anstatt als komplette Runde.

monitor

Ein Verweis auf eine CreateMonitor Callback-Funktion, um Download-Fortschrittsereignisse zu empfangen.

signal

Ein AbortSignal, um die Sitzungs-erstellung abzubrechen.

tools

Ein Array von Objekten, die Werkzeuge darstellen, die dem AI zur Verfügung stehen. Jedes Objekt kann die folgenden Eigenschaften enthalten:

name

Ein String, der dem Werkzeug einen eindeutigen Namen gibt, den das Modell verwendet, um darauf zu verweisen, wenn es einen Werkzeugaufruf ausführt.

description

Ein String, der beschreibt, was das Werkzeug tut. Das Modell verwendet diese Beschreibung, um zu entscheiden, ob und wann das Werkzeug aufgerufen wird.

inputSchema

Ein JSON Schema, das die Eingabeparameter des Werkzeugs beschreibt. Das Modell verwendet dieses Schema, um die Argumente zu konstruieren, die es an die execute Funktion des Werkzeugs übergibt.

execute

Eine Callback-Funktion, die der Benutzeragent aufruft, wenn das Modell dieses Werkzeug verwendet. Ihre Argumente sind spezifisch für das verwendete Modell. Sie muss ein Promise zurückgeben, das mit einem String aufgelöst wird, der das Ergebnis des Werkzeugs darstellt.

Rückgabewert

Ein Promise, das mit einer neuen LanguageModel Instanz aufgelöst wird.

Ausnahmen

AbortError DOMException

Wird geworfen, wenn der Vorgang über die signal Option abgebrochen wurde.

InvalidStateError DOMException

Wird geworfen, wenn das aufrufende Dokument nicht vollständig aktiv ist.

NotAllowedError DOMException

Wird geworfen, wenn die Nutzung der Methode durch eine language-model Permissions-Policy blockiert ist.

NotSupportedError DOMException

Wird geworfen, wenn:

• Die role einer Nachricht assistant ist und ihr type nicht text ist.
• Der type einer Nachricht text ist und ihr value kein String ist.
• Der Eingabe- oder Ausgabe-text in einer Sprache verfasst ist, die der Benutzeragent nicht für Prompting unterstützt.
• Der type einer Nachricht image oder audio ist, der Typ jedoch nicht in expectedInputs aufgeführt war, oder der value kein akzeptierter Datentyp ist.

OperationError DOMException

Wird geworfen, wenn die Erstellung aus einem anderen Grund fehlschlägt, der nicht zu den anderen Ausnahmearten gehört.

QuotaExceededError DOMException

Wird geworfen, wenn der Inhalt in initialPrompts das Modell LanguageModel.contextWindow überschreitet.

SyntaxError DOMException

Wird geworfen, wenn:

• Keine Nachrichten im Nachrichtenarray enthalten sind.
• Die prefix Eigenschaft einer Nachricht auf true gesetzt ist und:
  • Die role der Nachricht nicht assistant ist.