REST Resource: projects.locations.collections.engines.sessions.assistAnswers

Ressource: AssistAnswer

AssistAnswer-Ressource, Hauptteil von AssistResponse

JSON-Darstellung 
{
  "name": string,
  "state": enum (State),
  "connectorDisplayNames": {
    string: string,
    ...
  },
  "replies": [
    {
      object (Reply)
    }
  ],
  "assistSkippedReasons": [
    enum (AssistSkippedReason)
  ],
  "customerPolicyEnforcementResult": {
    object (CustomerPolicyEnforcementResult)
  }
}
Felder
name

string

Nicht veränderbar. ID. Ressourcenname von AssistAnswer. Format: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/assistAnswers/{assistAnswer}

Dieses Feld muss ein UTF-8-codierter String mit einer Längenbeschränkung von 1.024 Zeichen sein.
state

enum (State)

Status der Antwortgenerierung
connectorDisplayNames

map (key: string, value: string)

Nur Ausgabe. Ordnet einen internen Connector-Agent-Namen (die in Toolnamen eingebettete Maschinen-ID, z.B. custom_mcp_<fingerprint>_agent) dem menschenlesbaren Anzeigenamen des Connectors zu. Wird zur Laufzeit für benutzerdefinierte MCP-/Agent-Gateway-Connectors ausgefüllt, damit auf für Nutzer sichtbaren Oberflächen (z.B. dem Tool-Aufruf-Chip) der Connectorname anstelle der internen Kennung angezeigt werden kann. Leer, wenn keine solchen Connectors vorhanden sind.
replies[]

object (Reply)

Antworten des Assistenten.
assistSkippedReasons[]

enum (AssistSkippedReason)

Gründe, warum der Assist-Aufruf nicht angenommen wurde
customerPolicyEnforcementResult

object (CustomerPolicyEnforcementResult)

Optional. Das Feld enthält Informationen zu den Ergebnissen der verschiedenen Richtlinienprüfungen, z. B. zu den verbotenen Wortgruppen oder Model Armor-Prüfungen. Dieses Feld wird nur ausgefüllt, wenn der Assist-Aufruf aufgrund eines Richtlinienverstoßes übersprungen wurde.

Status

Status der Antwortgenerierung

Enums
STATE_UNSPECIFIED Unbekannt
IN_PROGRESS Der Assist-Vorgang wird gerade ausgeführt.
FAILED Der Assist-Vorgang ist fehlgeschlagen.
SUCCEEDED Der Assist-Vorgang war erfolgreich.
SKIPPED Der Assist-Vorgang wurde übersprungen.
CANCELLED Der Assist-Vorgang wurde abgebrochen (z.B. hat der Client den Stream geschlossen). Kann eine Teilantwort enthalten.

Antworten

Ein Teil der mehrteiligen Antwort des Assist-Aufrufs

JSON-Darstellung 
{
  "createTime": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "groundedContent": {
    object (AssistantGroundedContent)
  }
  // End of mutually exclusive fields.
}
Felder
createTime

string (Timestamp format)

Der Zeitpunkt, zu dem die Antwort erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
Alternativen für die Antwort des Assistenten. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
groundedContent

object (AssistantGroundedContent)

Möglicherweise fundierter Antworttext oder Medien vom Assistenten
Ende der sich gegenseitig ausschließenden Felder.

AssistantGroundedContent

Ein bestimmter Inhalt und möglicherweise die zugehörigen Fundierungsinformationen.

Nicht für alle Inhalte ist eine Fundierung erforderlich. Formulierungen wie „Natürlich suche ich gerne für Sie danach“ müssen nicht fundiert werden.

JSON-Darstellung 
{
  "content": {
    object (AssistantContent)
  },
  "citationMetadata": {
    object (CitationMetadata)
  },
  "contentMetadata": {
    object (ContentMetadata)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "textGroundingMetadata": {
    object (TextGroundingMetadata)
  }
  // End of mutually exclusive fields.
}
Felder
content

object (AssistantContent)

Der Inhalt
citationMetadata

object (CitationMetadata)

Quellenangabe für die generierten Inhalte. Siehe auch https://cloud.google.com/vertex-ai/generative-ai/docs/learn/overview#citation_check.
contentMetadata

object (ContentMetadata)

Optional. Metadaten für den Inhalt. Wird derzeit nur für Antworten von Recherche-Assistenten verwendet.
Fundierungsmetadaten für verschiedene Modalitäten. Derzeit wird nur Text unterstützt. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
textGroundingMetadata

object (TextGroundingMetadata)

Metadaten für die Fundierung auf Grundlage von Textquellen
Ende der sich gegenseitig ausschließenden Felder.

TextGroundingMetadata

Details zur Fundierung für Textquellen

JSON-Darstellung 
{
  "segments": [
    {
      object (Segment)
    }
  ],
  "visualSegments": [
    {
      object (VisualSegment)
    }
  ],
  "references": [
    {
      object (Reference)
    }
  ]
}
Felder
segments[]

object (Segment)

Fundierungsinformationen für Teile des Texts
visualSegments[]

object (VisualSegment)

Fundierungsinformationen für Teile der visuellen Inhalte
references[]

object (Reference)

Referenzen für den fundierten Text.

Segment

Fundierungsinformationen für ein Textsegment

JSON-Darstellung 
{
  "startIndex": string,
  "endIndex": string,
  "referenceIndices": [
    integer
  ],
  "groundingScore": number,
  "text": string
}
Felder
startIndex

string (int64 format)

Nullbasierter Index, der den Beginn des Segments angibt, gemessen in Byte eines UTF-8-Strings (d. h. Zeichen, die in mehreren Byte codiert sind, haben eine Länge von mehr als eins).
endIndex

string (int64 format)

Ende des Segments, exklusiv
referenceIndices[]

integer

Referenzen für das Segment
groundingScore

number

Wert für das Segment
text

string

Das Textsegment selbst

VisualSegment

Fundierungsinformationen für ein visuelles Segment.

JSON-Darstellung 
{
  "referenceIndices": [
    integer
  ],
  "contentId": string
}
Felder
referenceIndices[]

integer

Referenzen für das visuelle Segment.
contentId

string

Die Content ID des visuellen Segments. Damit die Quellenangabe des visuellen Elements angezeigt werden kann, muss diese contentId mit dem Feld groundedContent.content_metadata.content_id übereinstimmen.

Referenz

Referenzierte Inhalte und zugehörige Dokumentmetadaten

JSON-Darstellung 
{
  "content": string,
  "codeSnippet": string,
  "documentMetadata": {
    object (DocumentMetadata)
  },
  "chunkMetadata": {
    object
  }
}
Felder
content

string

Referenzierter Textinhalt
codeSnippet

string

Block des Code-Snippets aus dem referenzierten Dokument.
documentMetadata

object (DocumentMetadata)

Dokumentmetadaten.
chunkMetadata

object (Struct format)

Nur Ausgabe. Allgemeine strukturierte Chunk-Metadaten aus Upstream-Datenquellen-Connectors.

DocumentMetadata

Dokumentmetadaten.

JSON-Darstellung 
{
  "language": enum (Language),
  "document": string,
  "uri": string,
  "title": string,
  "pageIdentifier": string,
  "domain": string,
  "mimeType": string
}
Felder
language

enum (Language)
document

string

Name der Dokumentressource
uri

string

URI für das Dokument. Er kann eine URL enthalten, die zur eigentlichen Website weiterleitet.
title

string

Titel
pageIdentifier

string

Seitenkennung
domain

string

Domainname aus dem Dokument-URI. Das Feld uri kann eine URL enthalten, die zur eigentlichen Website weiterleitet. In diesem Fall enthält es den Domainnamen der Zielwebsite.
mimeType

string

Der MIME-Typ des Dokuments. https://www.iana.org/assignments/media-types/media-types.xhtml.

Sprache

Sprache des referenzierten Inhalts. Derzeit wird es nur für Code verwendet.

Enums
LANGUAGE_UNSPECIFIED
PYTHON
SQL

AssistantContent

Multimodale Inhalte

JSON-Darstellung 
{
  "role": string,
  "thought": boolean,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "text": string,
  "inlineData": {
    object (Blob)
  },
  "file": {
    object (File)
  },
  "executableCode": {
    object (ExecutableCode)
  },
  "codeExecutionResult": {
    object (CodeExecutionResult)
  }
  // End of mutually exclusive fields.
}
Felder
role

string

Der Produzent des Inhalts. Kann „model“ oder „user“ sein.
thought

boolean

Optional. Gibt an, ob der Teil zu den Überlegungen des Modells gehört.
Enthaltene Daten. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
text

string

Inline-Text
inlineData

object (Blob)

Inline-Binärdaten
file

object (File)

Eine Datei, z. B. eine Audiozusammenfassung
executableCode

object (ExecutableCode)

Vom Modell generierter Code, der ausgeführt werden soll
codeExecutionResult

object (CodeExecutionResult)

Ergebnis der Ausführung eines ExecutableCode
Ende der sich gegenseitig ausschließenden Felder.

Blob

Inline-Blob.

JSON-Darstellung 
{
  "mimeType": string,
  "data": string
}
Felder
mimeType

string

Pflichtfeld. Der Medientyp (MIME-Typ) der generierten Daten.
data

string (bytes format)

Pflichtfeld. Roh-Byte.

Ein base64-codierter String.

Datei

Eine Datei, z. B. eine Audiozusammenfassung

JSON-Darstellung 
{
  "mimeType": string,
  "fileId": string
}
Felder
mimeType

string

Pflichtfeld. Der Medientyp (MIME-Typ) der Datei.
fileId

string

Erforderlich. Die Datei-ID.

ExecutableCode

Code, der vom Modell generiert wird und vom Modell ausgeführt werden soll.

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

string

Pflichtfeld. Der Code-Inhalt. Derzeit wird nur Python unterstützt.

CodeExecutionResult

Ergebnis der Ausführung von ExecutableCode

JSON-Darstellung 
{
  "outcome": enum (Outcome),
  "output": string
}
Felder
outcome

enum (Outcome)

Pflichtfeld. Ergebnis der Codeausführung.
output

string

Optional. Enthält stdout, wenn die Codeausführung erfolgreich ist, andernfalls stderr oder eine andere Beschreibung.

Ergebnis

Auflistung der möglichen 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 abgeschlossen, aber mit einem Fehler. stderr sollte den Grund enthalten.
OUTCOME_DEADLINE_EXCEEDED Die Codeausführung dauerte zu lange und wurde abgebrochen. Möglicherweise ist eine Teilausgabe vorhanden.

CitationMetadata

Eine Sammlung von Quellenangaben für einen bestimmten Inhalt

JSON-Darstellung 
{
  "citations": [
    {
      object (Citation)
    }
  ]
}
Felder
citations[]

object (Citation)

Nur Ausgabe. Liste der Quellenangaben.

Quellenangabe

Quellenangaben für Inhalte

JSON-Darstellung 
{
  "startIndex": integer,
  "endIndex": integer,
  "uri": string,
  "title": string,
  "license": string,
  "publicationDate": {
    object (Date)
  }
}
Felder
startIndex

integer

Nur Ausgabe. Startindex im Inhalt.
endIndex

integer

Nur Ausgabe. Endindex im Inhalt.
uri

string

Nur Ausgabe. URL-Verweis der Angabe.
title

string

Nur Ausgabe. Titel der Angabe.
license

string

Nur Ausgabe. Lizenz der Angabe.
publicationDate

object (Date)

Nur Ausgabe. Veröffentlichungsdatum der Angabe.

ContentMetadata

Metadaten für die Inhalte

JSON-Darstellung 
{
  "contentKind": enum (ContentKind),
  "contentId": string
}
Felder
contentKind

enum (ContentKind)

Art des Inhalts. Zeigt an, zu welchem Teil der Antwort des Recherche-Assistenten dieser Inhalt gehört.
contentId

string

ID des Inhalts. Sie wird verwendet, um Recherchefragen mit Antworten darauf zu verknüpfen. Die Teile der Antwort auf eine Recherchefrage haben beispielsweise dieselbe contentId wie die Frage.

ContentKind

Mögliche Arten von Inhalten. Wird derzeit nur verwendet, um Abschnitte in der vollständigen Antwort eines Recherche-Assistenten zu unterscheiden.

Enums
CONTENT_KIND_UNSPECIFIED Unbekannt
RESEARCH_PLAN Rechercheplan
RESEARCH_QUESTION Recherchefrage
RESEARCH_ANSWER Rechercheantwort
RESEARCH_REPORT Recherchebericht
RESEARCH_AUDIO_SUMMARY Recherche-Audiozusammenfassung

AssistSkippedReason

Mögliche Gründe für das Nichtbeantworten eines Assist-Aufrufs

Enums
ASSIST_SKIPPED_REASON_UNSPECIFIED Standardwert. Der Grund für das Überspringen wird nicht angegeben.
NON_ASSIST_SEEKING_QUERY_IGNORED Der Assistent hat die Anfrage ignoriert, da sie nicht so erschien, als wäre sie auf eine Antwort ausgerichtet.
CUSTOMER_POLICY_VIOLATION Der Assistent hat die Anfrage ignoriert oder die Antwort verweigert, weil gegen eine Kundenrichtlinie verstoßen wurde (beispielsweise weil die Anfrage oder die Antwort eine verbotene Wortgruppe enthielt).

CustomerPolicyEnforcementResult

Ergebnisse der Durchsetzung von Kundenrichtlinien. Enthält die Ergebnisse der verschiedenen Richtlinienprüfungen, z. B. der Prüfungen auf verbotene Wortgruppen oder der Model Armor-Prüfungen.

JSON-Darstellung 
{
  "verdict": enum (Verdict),
  "policyResults": [
    {
      object (PolicyEnforcementResult)
    }
  ],
  "violationSource": enum (ViolationSource)
}
Felder
verdict

enum (Verdict)

Endgültiges Ergebnis der Durchsetzung der Kundenrichtlinie. Wenn die Verarbeitung nur durch eine Richtlinie blockiert wurde, lautet das Ergebnis BLOCK.
policyResults[]

object (PolicyEnforcementResult)

Ergebnisse der Durchsetzung von Kundenrichtlinien. Wird nur ausgefüllt, wenn der Assist-Aufruf aufgrund eines Richtlinienverstoßes übersprungen wurde. Sie enthalten Ergebnisse von den Filtern, die die Verarbeitung der Anfrage blockiert haben.
violationSource

enum (ViolationSource)

Nur Ausgabe. Die Quelle des Verstoßes.

Einstufung

Das Ergebnis der Durchsetzung der Kundenrichtlinie

Enums
UNSPECIFIED Der Wert ist unbekannt.
ALLOW Es lag kein Richtlinienverstoß vor.
BLOCK Die Verarbeitung wurde durch die Kundenrichtlinie blockiert.

PolicyEnforcementResult

Ergebnis der Durchsetzung der Kundenrichtlinie für einen einzelnen Richtlinientyp

JSON-Darstellung 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "bannedPhraseEnforcementResult": {
    object (BannedPhraseEnforcementResult)
  },
  "modelArmorEnforcementResult": {
    object (ModelArmorEnforcementResult)
  }
  // End of mutually exclusive fields.
}
Felder
Das spezifische Ergebnis des Richtlinientyps. Es kann sich entweder um einen Fehler oder um detaillierte Informationen zum Ergebnis der Richtliniendurchsetzung handeln. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
bannedPhraseEnforcementResult

object (BannedPhraseEnforcementResult)

Das Ergebnis der Richtliniendurchsetzung für die Richtlinie für verbotene Wortgruppen
modelArmorEnforcementResult

object (ModelArmorEnforcementResult)

Das Ergebnis der Richtliniendurchsetzung für die Model Armor-Richtlinie
Ende der sich gegenseitig ausschließenden Felder.

BannedPhraseEnforcementResult

Ergebnis der Richtliniendurchsetzung für die Richtlinie für verbotene Wortgruppen

JSON-Darstellung 
{
  "bannedPhrases": [
    string
  ]
}
Felder
bannedPhrases[]

string

Die verbotenen Wortgruppen, die in der Anfrage oder der Antwort gefunden wurden

ModelArmorEnforcementResult

Das Ergebnis der Durchsetzung der Kundenrichtlinie für die Model Armor-Richtlinie

JSON-Darstellung 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "modelArmorViolation": string,
  "error": {
    object (Status)
  }
  // End of mutually exclusive fields.
}
Felder
Das Ergebnis der Model Armor-Richtlinie. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
modelArmorViolation

string

Der gefundene Model Armor-Verstoß
error

object (Status)

Der von Model Armor zurückgegebene Fehler, wenn die Richtliniendurchsetzung aus irgendeinem Grund fehlgeschlagen ist
Ende der sich gegenseitig ausschließenden Felder.

ViolationSource

Wenn der Assist-Aufruf aufgrund eines Richtlinienverstoßes übersprungen wurde, enthält dieses Feld die Quelle des Verstoßes.

Enums
VIOLATION_SOURCE_UNSPECIFIED Der Wert ist unbekannt.
SYSTEM Verstoß in der Systemantwort gefunden.
PROMPT Verstoß in der Nutzeranfrage gefunden.
ATTACHMENT Im Anhang des Nutzers wurde ein Verstoß festgestellt.

Methoden

get

 Ruft eine AssistAnswer ab