ContentSearchSpec

Eine Spezifikation zum Konfigurieren des Verhaltens der Inhaltssuche.

JSON-Darstellung
{
  "snippetSpec": {
    object (SnippetSpec)
  },
  "summarySpec": {
    object (SummarySpec)
  },
  "extractiveContentSpec": {
    object (ExtractiveContentSpec)
  },
  "searchResultMode": enum (SearchResultMode),
  "chunkSpec": {
    object (ChunkSpec)
  }
}
Felder
snippetSpec

object (SnippetSpec)

Wenn snippetSpec nicht angegeben ist, werden keine Snippets in die Suchantwort aufgenommen.

summarySpec

object (SummarySpec)

Wenn summarySpec nicht angegeben ist, sind Zusammenfassungen nicht in der Suchantwort enthalten.

extractiveContentSpec

object (ExtractiveContentSpec)

Wenn keine „extractiveContentSpec“ angegeben wird, ist in der Suchantwort keine extraktive Antwort enthalten.

searchResultMode

enum (SearchResultMode)

Gibt den Modus für Suchergebnisse an. Wenn nichts angegeben ist, wird standardmäßig der Suchergebnismodus DOCUMENTS verwendet.

chunkSpec

object (ChunkSpec)

Gibt die Chunkspezifikation an, die von der Suchantwort zurückgegeben werden soll. Nur verfügbar, wenn SearchRequest.ContentSearchSpec.search_result_mode auf CHUNKS gesetzt ist.

SnippetSpec

Eine Spezifikation zum Konfigurieren von Snippets in einer Suchantwort.

JSON-Darstellung
{
  "maxSnippetCount": integer,
  "referenceOnly": boolean,
  "returnSnippet": boolean
}
Felder
maxSnippetCount
(deprecated)

integer

[VERWORFEN] Die Verwendung dieses Feldes wurde eingestellt. Verwenden Sie das Feld returnSnippet, um die Rückgabe von Snippets zu steuern. Aus Gründen der Abwärtskompatibilität wird ein Snippet zurückgegeben, wenn „maxSnippetCount“ > 0 ist.

referenceOnly
(deprecated)

boolean

[VERALTET] Dieses Feld ist veraltet und hat keine Auswirkungen auf den Snippet.

returnSnippet

boolean

Bei true wird ein Snippet zurückgegeben. Wenn kein Snippet generiert werden kann, wird „Für diese Seite ist kein Snippet verfügbar“ zurückgegeben. Außerdem wird ein snippetStatus mit SUCCESS oder NO_SNIPPET_AVAILABLE zurückgegeben.

SummarySpec

Eine Spezifikation zum Konfigurieren einer Zusammenfassung, die in einer Suchantwort zurückgegeben wird.

JSON-Darstellung
{
  "summaryResultCount": integer,
  "includeCitations": boolean,
  "ignoreAdversarialQuery": boolean,
  "ignoreNonSummarySeekingQuery": boolean,
  "ignoreLowRelevantContent": boolean,
  "ignoreJailBreakingQuery": boolean,
  "multimodalSpec": {
    object (MultiModalSpec)
  },
  "modelPromptSpec": {
    object (ModelPromptSpec)
  },
  "languageCode": string,
  "modelSpec": {
    object (ModelSpec)
  },
  "useSemanticChunks": boolean
}
Felder
summaryResultCount

integer

Die Anzahl der Top-Ergebnisse, aus denen die Zusammenfassung generiert werden soll. Wenn die Anzahl der zurückgegebenen Ergebnisse kleiner als summaryResultCount ist, wird die Zusammenfassung aus allen Ergebnissen generiert.

Es können maximal 10 Ergebnisse im Dokumentmodus oder 50 Ergebnisse im Chunks-Modus verwendet werden, um eine Zusammenfassung zu erstellen. Der Chunks-Modus wird verwendet, wenn SearchRequest.ContentSearchSpec.search_result_mode auf CHUNKS gesetzt ist.

includeCitations

boolean

Gibt an, ob Zitationen in die Zusammenfassung aufgenommen werden sollen. Der Standardwert ist false.

Wenn dieses Feld auf true gesetzt ist, enthalten Zusammenfassungen Inline-Zitiernummern.

Beispiel für eine Zusammenfassung mit Quellenangaben:

BigQuery ist das vollständig verwaltete und serverlose Data Warehouse für Unternehmen von Google Cloud.[1] BigQuery unterstützt alle Datentypen, funktioniert cloudübergreifend und enthält integrierte Funktionen für Machine Learning und Business Intelligence auf einer einheitlichen Plattform [2, 3].

Die Zitationsnummern beziehen sich auf die zurückgegebenen Suchergebnisse und sind 1-basiert. [1] bedeutet beispielsweise, dass der Satz dem ersten Suchergebnis zugeordnet wird. [2, 3] bedeutet, dass der Satz sowohl dem zweiten als auch dem dritten Suchergebnis zugeordnet wird.

ignoreAdversarialQuery

boolean

Gibt an, ob feindselige Anfragen herausgefiltert werden sollen. Der Standardwert ist false.

Google verwendet die Klassifizierung von Suchanfragen, um schädliche Anfragen zu erkennen. Wenn die Suchanfrage als feindselige Anfrage eingestuft wird, wird keine Zusammenfassung zurückgegeben. Ein Nutzer könnte beispielsweise eine Frage zu negativen Kommentaren über das Unternehmen stellen oder eine Anfrage senden, die darauf abzielt, unsichere, richtlinienwidrige Ausgaben zu generieren. Wenn dieses Feld auf true gesetzt ist, werden keine Zusammenfassungen für feindselige Anfragen generiert. Stattdessen werden Fallback-Nachrichten zurückgegeben.

ignoreNonSummarySeekingQuery

boolean

Gibt an, ob Anfragen herausgefiltert werden sollen, die nicht auf eine Zusammenfassung abzielen. Der Standardwert ist false.

Google verwendet die Klassifizierung von Suchanfragen, um Anfragen zu erkennen, bei denen Nutzer eine Zusammenfassung wünschen. Es wird keine Zusammenfassung zurückgegeben, wenn die Suchanfrage als Anfrage klassifiziert wird, die keine Zusammenfassung erfordert. Beispiele: why is the sky blue und Who is the best soccer player in the world? sind Anfragen, bei denen eine Zusammenfassung gesucht wird, SFO airport und world cup 2026 jedoch nicht. Höchstwahrscheinlich handelt es sich um Navigationsanfragen. Wenn dieses Feld auf true festgelegt ist, überspringen wir das Generieren von Zusammenfassungen für Anfragen, die keine Zusammenfassung anfordern, und geben stattdessen Fallback-Nachrichten zurück.

ignoreLowRelevantContent

boolean

Gibt an, ob Suchanfragen mit geringer Relevanz herausgefiltert werden sollen. Der Standardwert ist false.

Wenn dieses Feld auf false festgelegt ist, werden alle Suchergebnisse unabhängig von ihrer Relevanz verwendet, um Antworten zu generieren. Bei Festlegung auf true werden nur für Anfragen mit Suchergebnissen mit hoher Relevanz Antworten generiert.

ignoreJailBreakingQuery

boolean

Optional. Gibt an, ob Anfragen zum Jailbreaking herausgefiltert werden sollen. Der Standardwert ist false.

Google verwendet die Klassifizierung von Suchanfragen, um Anfragen zu erkennen, die darauf abzielen, die Sicherheitsvorkehrungen zu umgehen. Es wird keine Zusammenfassung zurückgegeben, wenn die Suchanfrage als Jailbreak-Anfrage eingestuft wird. Ein Nutzer kann der Anfrage Anweisungen hinzufügen, um den Ton, Stil, die Sprache oder den Inhalt der Antwort zu ändern oder das Modell zu bitten, als eine andere Einheit zu agieren, z.B. „Antworte im Stil des CEO eines konkurrierenden Unternehmens“. Wenn dieses Feld auf true gesetzt ist, werden keine Zusammenfassungen für Anfragen zum Jailbreaking generiert. Stattdessen werden Fallback-Nachrichten zurückgegeben.

multimodalSpec

object (MultiModalSpec)

Optional. Multimodale Spezifikation.

modelPromptSpec

object (ModelPromptSpec)

Wenn angegeben, wird die Spezifikation verwendet, um den Prompt zu ändern, der dem LLM bereitgestellt wird.

languageCode

string

Sprachcode für die Zusammenfassung. Verwenden Sie Sprachentags, die von BCP47 definiert werden. Hinweis: Dies ist eine experimentelle Funktion.

modelSpec

object (ModelSpec)

Falls angegeben, wird die Spezifikation verwendet, um die dem LLM bereitgestellte Modellspezifikation zu ändern.

useSemanticChunks

boolean

Bei „wahr“ wird die Antwort aus den relevantesten Chunks der Top-Suchergebnisse generiert. Diese Funktion verbessert die Qualität der Zusammenfassungen. Wenn diese Funktion aktiviert ist, werden nicht alle Top-Suchergebnisse referenziert und in die Referenzliste aufgenommen. Der Index der Zitationsquellen verweist also nur auf die Suchergebnisse, die in der Referenzliste aufgeführt sind.

MultiModalSpec

Multimodale Spezifikation: Gibt ein Bild aus der angegebenen Quelle zurück. Wenn mehrere Quellen angegeben sind, wird die Auswahl anhand der Qualität getroffen.

JSON-Darstellung
{
  "imageSource": enum (ImageSource)
}
Felder
imageSource

enum (ImageSource)

Optional. Quelle des in der Antwort zurückgegebenen Bildes.

ImageSource

Gibt die Bildquelle an.

Enums
IMAGE_SOURCE_UNSPECIFIED Die Bildquelle ist nicht angegeben (die multimodale Funktion ist standardmäßig deaktiviert).
ALL_AVAILABLE_SOURCES Verhalten, wenn der Dienst die Auswahl aus allen verfügbaren Quellen bestimmt.
CORPUS_IMAGE_ONLY Die Antwort enthält ein Bild aus dem Korpus.
FIGURE_GENERATION_ONLY Löst die Generierung von Abbildungen in der Antwort aus.

ModelPromptSpec

Spezifikation des Prompts, der mit dem Modell verwendet werden soll.

JSON-Darstellung
{
  "preamble": string
}
Felder
preamble

string

Text am Anfang des Prompts, der den Assistenten anweist. Beispiele finden Sie im Nutzerhandbuch.

ModelSpec

Spezifikation des Modells.

JSON-Darstellung
{
  "version": string
}
Felder
version

string

Die Modellversion, die zum Generieren der Zusammenfassung verwendet wurde.

Unterstützte Werte:

ExtractiveContentSpec

Eine Spezifikation zum Konfigurieren des extraktiven Inhalts in einer Suchantwort.

JSON-Darstellung
{
  "maxExtractiveAnswerCount": integer,
  "maxExtractiveSegmentCount": integer,
  "returnExtractiveSegmentScore": boolean,
  "numPreviousSegments": integer,
  "numNextSegments": integer
}
Felder
maxExtractiveAnswerCount

integer

Die maximale Anzahl von extraktiven Antworten, die in jedem Suchergebnis zurückgegeben werden.

Eine extraktive Antwort ist eine wörtliche Antwort, die aus dem Originaldokument extrahiert wird und eine präzise und kontextbezogene Antwort auf die Suchanfrage liefert.

Wenn die Anzahl der übereinstimmenden Antworten kleiner als maxExtractiveAnswerCount ist, werden alle Antworten zurückgegeben. Andernfalls wird maxExtractiveAnswerCount zurückgegeben.

Für jede SearchResult werden maximal fünf Antworten zurückgegeben.

maxExtractiveSegmentCount

integer

Die maximale Anzahl von extraktiven Segmenten, die in jedem Suchergebnis zurückgegeben werden. Wird nur angewendet, wenn DataStore auf DataStore.ContentConfig.CONTENT_REQUIRED eingestellt ist oder DataStore.solution_types SOLUTION_TYPE_CHAT ist.

Ein extraktives Segment ist ein Textsegment, das aus dem Originaldokument extrahiert wird und für die Suchanfrage relevant ist. Im Allgemeinen ist es ausführlicher als eine extraktive Antwort. Das Segment kann dann als Eingabe für LLMs verwendet werden, um Zusammenfassungen und Antworten zu generieren.

Wenn die Anzahl der übereinstimmenden Segmente kleiner als maxExtractiveSegmentCount ist, werden alle Segmente zurückgegeben. Andernfalls wird maxExtractiveSegmentCount zurückgegeben.

returnExtractiveSegmentScore

boolean

Gibt an, ob der Konfidenzwert aus den extraktiven Segmenten in jedem Suchergebnis zurückgegeben werden soll. Diese Funktion ist nur für neue oder auf die Zulassungsliste gesetzte Datenspeicher verfügbar. Wenden Sie sich an Ihren Customer Engineer, um Ihren Datenspeicher auf die Zulassungsliste setzen zu lassen. Der Standardwert ist false.

numPreviousSegments

integer

Gibt an, ob auch die angrenzenden Segmente der ausgewählten Segmente einbezogen werden sollen. Gibt maximal numPreviousSegments Segmente vor jedem ausgewählten Segment zurück.

numNextSegments

integer

Gibt nach jedem ausgewählten Segment maximal numNextSegments Segmente zurück.

SearchResultMode

Gibt den Modus für Suchergebnisse an. Wenn nichts angegeben ist, wird standardmäßig der Suchergebnismodus DOCUMENTS verwendet.

Enums
SEARCH_RESULT_MODE_UNSPECIFIED Standardwert.
DOCUMENTS Gibt Dokumente im Suchergebnis zurück.
CHUNKS Gibt Chunks im Suchergebnis zurück. Nur verfügbar, wenn DocumentProcessingConfig.chunking_config angegeben ist.

ChunkSpec

Gibt die Chunkspezifikation an, die von der Suchantwort zurückgegeben werden soll. Nur verfügbar, wenn SearchRequest.ContentSearchSpec.search_result_mode auf CHUNKS gesetzt ist.

JSON-Darstellung
{
  "numPreviousChunks": integer,
  "numNextChunks": integer
}
Felder
numPreviousChunks

integer

Die Anzahl der vorherigen Chunks, die vom aktuellen Chunk zurückgegeben werden sollen. Der maximal zulässige Wert beträgt 3. Wenn nicht angegeben, werden keine vorherigen Chunks zurückgegeben.

numNextChunks

integer

Die Anzahl der nächsten Chunks, die vom aktuellen Chunk zurückgegeben werden sollen. Der maximal zulässige Wert beträgt 3. Wenn nicht angegeben, werden keine weiteren Chunks zurückgegeben.